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.ymlindex 9b1a497,2266d28..adde5f8--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@@ -41,14 -41,11 +41,19 @@@ jobsshell: powershellrun: ./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: powershelldiff --cc README_AI.mdindex 0816f8c,0816f8c..052f295--- a/README_AI.md+++ b/README_AI.md@@@ -108,6 -108,6 +108,15 @@@ bash skills/scripts/case-guard.sh --casbash 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 primaThis 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 misusediff --cc skills/js-reverse/SKILL.mdindex 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 22diff --cc skills/pentest-tools/SKILL.mdindex 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 pentestmcReqable 桌面客户端可通过官方 [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 配置为:```jsondiff --cc skills/scripts/test-bootstrap-manifest.shindex 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/python3json_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_DIRcp "$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