Skip to content

Reverse Engineering / Authorized Penetration Testing / Security Research Skill Router Pack AI-powered routing + On-demand toolchain bootstrapping + Self-evolving knowledge base Supports Claude Code, Kiro, Cursor, Cline, and other AI coding clients 逆向/渗透/安全技能路由包 - AI 自动路由 + 按需自举工具链 + 自动进化经验库 | 支持 Claude Code / Kiro / Cursor / Cline 等代码 AI 客户端

Shell

Merge pull request #93 from jhuang-tw/fix/client-neutral-bootstrap-capability

zhaoxuya520a9ed8d04ad58
diff --cc .github/workflows/ci.yml
index 9b1a497,2266d28..adde5f8
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@@ -41,14 -41,11 +41,19 @@@ jobs
shell: powershell
run: ./skills/scripts/test-bootstrap-supply-chain.ps1
+ - name: Parse contracts (route-scope + IDA lock)
+ shell: pwsh
+ run: ./skills/scripts/test-parse-contracts.ps1
+
+ - name: Journal PR title safety
+ shell: pwsh
+ run: ./skills/scripts/test-workflow-title-safety.ps1
+
+ - name: Client-neutral bootstrap/discovery (Windows PowerShell 5.1)
+ if: runner.os == 'Windows'
+ shell: powershell
+ run: ./skills/scripts/test-client-neutral-bootstrap.ps1
+
- name: Offline sample case contract (Windows PowerShell 5.1)
if: runner.os == 'Windows'
shell: powershell
diff --cc README_AI.md
index 0816f8c,0816f8c..052f295
--- a/README_AI.md
+++ b/README_AI.md
@@@ -108,6 -108,6 +108,15 @@@ bash skills/scripts/case-guard.sh --cas
bash skills/scripts/bootstrap-reverse.sh --list
```
++MCP client registration is opt-in. Bootstrap defaults to installing or preparing the capability without writing client-global configuration. Select the target explicitly when registration is required:
++
++```text
++Windows: powershell -File skills/scripts/bootstrap-reverse.ps1 -Capability jshookmcp -McpHostTarget Codex
++Linux/macOS: bash skills/scripts/bootstrap-reverse.sh jshookmcp --mcp-host=codex
++```
++
++Use `Claude` / `claude` or `Both` / `both` for other supported targets.
++
Kali users should use the dedicated Kali bootstrap entrypoint:
```bash
@@@ -371,7 -371,7 +380,7 @@@ Whether you use Claude Code, Codex CLI
}
```
--The bootstrap command enables bearer authentication for Anything Analyzer and registers the generated token for supported clients. Manual configurations must include the `Authorization` header shown above.
++The bootstrap command enables bearer authentication for Anything Analyzer. It registers the generated token only when an MCP host is explicitly selected (`-McpHostTarget` or `--mcp-host`). Manual configurations must include the `Authorization` header shown above.
### Minimum Prompt Requirements
@@@ -602,4 -602,4 +611,4 @@@ This project (`reverse-skill`) is prima
This package is intended only for legally authorized security research, learning, and CTF competitions.
- Users must ensure all operations are within legal boundaries
- Unauthorized penetration testing against other people's systems is illegal
--- The package author is not responsible for misuse
++- The package author is not responsible for misuse
diff --cc skills/js-reverse/SKILL.md
index c2d57c5,c2d57c5..458f247
--- a/skills/js-reverse/SKILL.md
+++ b/skills/js-reverse/SKILL.md
@@@ -31,7 -31,7 +31,7 @@@ description: 在使用 js-reverse-mcp �
如果当前任务明确提到 `jshookmcp`、`JS hook`、`CDP`、浏览器断点、网络拦截、SourceMap 或 AST 去混淆,也仍然走本 skill;只是把底层 MCP 面切到 `jshookmcp`,而不是把它当成一个新的总入口。
--前提条件:`jshookmcp` 不是本地裸命令工具,而是一个要先下载/注册/启用的 MCP server。只有在 Claude MCP 配置里接入并启用后,相关工具面才真的可调用。
++前提条件:`jshookmcp` 不是本地裸命令工具,而是一个要先下载、显式注册并启用的 MCP server。只有在所选客户端(Claude、Codex 等)的 MCP 配置里接入并启用后,相关工具面才真的可调用。
常用映射:
@@@ -180,29 -180,29 +180,30 @@@
## 按需自举(On-Demand Bootstrap)
--本 skill 依赖的 MCP 能力可通过统一自举系统自动注册。
++本 skill 依赖的 MCP 能力可通过统一自举系统安装;MCP 客户端注册必须显式选择目标,默认不会写任何客户端全局配置。
### 自动化能力边界
| 能力 | 可自动注册 | 方式 | 说明 |
|------|-----------|------|------|
--| jshookmcp | ✓ | npm-mcp(npx 启动) | 自动写入 Claude MCP 配置 |
--| anything-analyzer | ✓ | local-http-mcp | 自动注册 + 可自动启动服务 |
++| jshookmcp | ✓ | npm-mcp(npx 启动) | 显式选择 Claude / Codex / Both 后注册 |
++| anything-analyzer | ✓ | local-http-mcp | 可自动启动服务;客户端注册须显式选择 |
| Node.js | ✓ | winget 安装 | 运行时依赖 |
### 自举方式
```powershell
--# 注册 jshookmcp 到 MCP 配置
--powershell -File "<skill-root>\scripts\bootstrap-reverse.ps1" -Capability @('jshookmcp')
++# 安装并注册 jshookmcp;Codex 可替换为 Claude 或 Both
++powershell -File "<skill-root>\scripts\bootstrap-reverse.ps1" -Capability @('jshookmcp') -McpHostTarget Codex
# 注册并启动 anything-analyzer
--powershell -File "<skill-root>\scripts\bootstrap-reverse.ps1" -Capability @('anything-analyzer') -StartServices
++powershell -File "<skill-root>\scripts\bootstrap-reverse.ps1" -Capability @('anything-analyzer') -StartServices -McpHostTarget Codex
```
### 注意事项
- `jshookmcp` 注册后仍需在 AI 客户端中**启用**该 MCP server 才能调用
++- 不传 `-McpHostTarget` 时只安装/准备能力并返回 registration-required,不修改 Claude 或 Codex 配置
- `anything-analyzer` 需要 pnpm 和项目源码,bootstrap 会自动 clone 并安装依赖
- 如果 Node.js 未安装,bootstrap 会先通过 winget 安装 Node.js 22
diff --cc skills/pentest-tools/SKILL.md
index bbba3d5,f861452..73ba24a
--- a/skills/pentest-tools/SKILL.md
+++ b/skills/pentest-tools/SKILL.md
@@@ -147,9 -147,9 +147,11 @@@ docker run -d -p 8080:8080 pentestmc
Reqable 桌面客户端可通过官方 [Reqable MCP Server](https://github.com/reqable/reqable-mcp-server) 暴露本地抓包、API、断点和规则能力。先单独安装并启动 Reqable,再登记 MCP:
```powershell
--powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp
++powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp -McpHostTarget Codex
```
++将 `Codex` 替换为 `Claude` 或 `Both` 可选择对应客户端;省略 `-McpHostTarget` 时不会写任何客户端全局配置。
++
登记后的 stdio 配置为:
```json
diff --cc skills/scripts/test-bootstrap-manifest.sh
index 080e43a,080e43a..3e09023
--- a/skills/scripts/test-bootstrap-manifest.sh
+++ b/skills/scripts/test-bootstrap-manifest.sh
@@@ -75,7 -75,7 +75,7 @@@ chmod +x "$STUB_BIN/python3
json_value() {
"$REAL_PYTHON" - "$MANIFEST" "$1" "$2" <<'PY'
import json, pathlib, sys
--d=json.loads(pathlib.Path(sys.argv[1]).read_text())
++d=json.loads(pathlib.Path(sys.argv[1]).read_text(encoding='utf-8'))
if sys.argv[2] == 'dependency': v=d['bootstrapDependencies'][sys.argv[3]]['package']
else: v=next(x for x in d['capabilities'] if x['name']==sys.argv[2])[sys.argv[3]]
print(v)
@@@ -142,9 -142,9 +142,9 @@@ mkdir -p "$BROKEN_DIR
cp "$BOOTSTRAP" "$BROKEN_DIR/bootstrap-reverse.sh"
"$REAL_PYTHON" - "$MANIFEST" "$BROKEN_DIR/bootstrap-manifest.json" <<'PY'
import json, pathlib, sys
--data = json.loads(pathlib.Path(sys.argv[1]).read_text())
++data = json.loads(pathlib.Path(sys.argv[1]).read_text(encoding='utf-8'))
next(x for x in data['capabilities'] if x['name'] == 'agent-browser')['npmPackage'] = ''
--pathlib.Path(sys.argv[2]).write_text(json.dumps(data))
++pathlib.Path(sys.argv[2]).write_text(json.dumps(data), encoding='utf-8')
PY
: > "$CALL_LOG"
set +e