reverse-workbench-skill

Pi 定向网络安全与逆向技能路由包

破暗而行，逆水为舟

AI-powered routing + On-demand toolchain bootstrapping + Self-evolving knowledge base
逆向/渗透/安全技能路由包 — AI 自动路由 · 按需自举工具链 · 自动进化经验库

关于 · 快速开始 · 使用说明 · 快路径 · 路由矩阵 · 作战契约 · AI 引导 · 贡献

🌐 English

## 关于项目 > **如果你是 AI Agent，直接跳转到 [README_AI.md](README_AI.md)，严格按照内容要求执行。** > > **如果你是 AI Agent，直接跳转到 [README_AI.md](README_AI.md)，严格按照内容要求执行。** > > **跨 Agent 用户：** 这是标准 **Agent Skills** bundle。用 `scripts/install-skill.ps1`（Windows）或 `scripts/install-skill.sh`（Unix）安装一次——共享位置 `~/.agents/skills/` 同时被 **pi、Codex CLI、DSH** 识别；追加 `-Claude`/`--claude` 参数可同步镜像到 **Claude Code**。详见下方[跨 Agent 支持](#跨-agent-支持)。本仓库是独立维护的**跨 Agent** 逆向工程与安全分析技能路由器：归档分诊、可复现的 Ghidra 无头导出、HTTP/服务指纹能力与领域技能矩阵。不再跟踪任何上游代码库，走独立发布线。当 AI Agent（Claude Code、Codex CLI、Cursor、Pi 等）遇到 APK、二进制、前端 JS 加密、CTF 或渗透测试任务时，这套系统能让它先路由到正确的方法论，再调用本机工具执行，而不是盲目猜命令。 ``` 用户任务 → RULES.md → MASTER-ROUTING / master-route.ps1（PRIMARY） → case-init / scope.md（授权 + network_profile；未就绪禁止对目标 ACT） → 目标 Skill → 工具 / MCP / 脚本 → timeline + Evidence→Finding→Path → 报告 + field-journal ``` **为什么需要这个项目：** - AI Agent 面对 APK、ELF、JS、PCAP 不知道该用 jadx 还是 Frida 还是 IDA - 工具路径、MCP 服务、脚本入口分散在不同机器，迁移困难 - 同样的问题每次重新踩坑，经验无法复用 PRIMARY 快路径：[skills/MASTER-ROUTING.md](skills/MASTER-ROUTING.md) · 全表：[skills/routing.md](skills/routing.md) · 作战契约：[skills/ops/](skills/ops/)

(返回顶部)

### 技术栈

IDA Pro · radare2 · Ghidra

(返回顶部)

## 快速开始 ### 前置依赖 - **Java / JDK** — 运行 jadx、apktool - **Node.js 22.12+** — JS 工具链和 MCP 服务 - **Python 3.x** — Frida 和辅助脚本 - **代码 AI 客户端** — Claude Code、Codex CLI、Cursor 等 ### 安装 ``` git clone https://github.com/Asaiuta/reverse-workbench-skill.git cd reverse-workbench-skill ``` 按目标 Agent 安装技能 bundle： | 宿主 | 安装 | 调用方式 | |------|------|----------| | **pi** | `powershell -File scripts/install-skill.ps1`（Win）/ `bash scripts/install-skill.sh`（Unix） | `/skill:reverse-workbench-skill`（`/reload` 后生效） | | **Codex CLI** | 同上（`$HOME/.agents/skills` 即 Codex USER scope） | `/skills` 或 `$reverse-workbench-skill` | | **DSH** | 同上（DSH user-agents scope，rank 500）；项目级用 `--project `（`/.agents/skills`，rank 200） | web 端 skill 目录 / skill 工具 | | **Claude Code** | 追加 `-Claude`(Win) / `--claude`(Unix) 参数 | `/skills`（重启后生效） | | **其他 Agent Skills 宿主** | 将 `SKILL.md` 所在目录复制到对应 skills 目录 | 依宿主而定 | > 单机只需装一次：pi / Codex CLI / DSH 共用 `~/.agents/skills/reverse-workbench-skill/`。技能保持**仅显式调用**（`disable-model-invocation: true`，Codex 侧为 `allow_implicit_invocation: false`）。 ### 跨 Agent 支持 | 宿主 | 发现位置 | 说明 | |------|----------|------| | pi | `~/.agents/skills/`、`~/.pi/agent/skills/` | `/skill:` 命令，`disable-model-invocation` | | Codex CLI | `$CWD/.agents/skills`(REPO) → `$HOME/.agents/skills`(USER) → `/etc/codex/skills`(ADMIN) | 支持 symlink；自动检测变更 | | DSH | `/.dsh/skills`(100) → `/.agents/skills`(200) → `$DSH_HOME/skills`(400) → `~/.agents/skills`(500) | `ctx.skills` 注册表 + skill 工具；`disable-model-invocation` | | Claude Code | `~/.claude/skills/`、项目 `.claude/skills/` | `/skills` 选择器 | ### 初次使用下载后按平台刷新工具索引： | 平台 | 命令 | |------|------| | Windows | `powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/refresh-tool-index.ps1` | | Linux / macOS | `bash skills/scripts/refresh-tool-index.sh` | | Kali Linux | `bash kali/scripts/refresh-tool-index.sh` | 随后查看 [skills/tool-index.md](skills/tool-index.md) 确认已检测到的工具。各平台详细部署文档： - **Kali Linux** → [kali/README-kali.md](kali/README-kali.md) - **Ubuntu/Debian** → [docs/platforms/linux.md](docs/platforms/linux.md) - **macOS** → [docs/platforms/macos.md](docs/platforms/macos.md)

(返回顶部)

## 使用说明 ### 支持场景 | 场景 | 入口 | |------|------| | APK / Android 逆向 | `skills/apk-reverse/` | | iOS / 移动端 | `skills/mobile-reverse/` | | 未知文件 / 压缩包 / 证据包 | `skills/archive-file-triage/` | | 可复现 Ghidra 批量导出 | `skills/ghidra-headless/` | | Ghidra 逆向 | `skills/ghidra-reverse/` | | HTTP 存活 / TLS / 服务指纹 | `skills/pentest-tools/observer-ward/` | | 二进制逆向 (exe/dll/so/elf) | `skills/ida-reverse/` / `skills/radare2/` | | .NET / C# | `skills/dotnet-reverse/` | | 前端 JS 签名 / 加密参数 | `skills/js-reverse/` | | DSL VM / 风控自定义 VM | `skills/reverse-engineering/dsl-vm-reverse/` | | HTTP 抓包 / 请求重放 | anything-analyzer + `js-reverse/` | | 恶意软件 / YARA | `skills/malware-analysis/` | | 渗透测试 / 漏洞扫描 | `skills/pentest-tools/` | | 攻击链 / 红队编排 | `skills/attack-chain/` | | CTF 竞赛 | `CTF-Sandbox-Orchestrator/` (40+ 子技能) | | 固件 / IoT | `skills/firmware-pentest/` | | 补丁差分 / N-day | `skills/patch-diff-exploit/` | | 跨版本符号迁移 / DWARF 恢复 | `skills/binary-diff/` | | Linux/ELF DWARF 符号恢复 | `skills/binary-diff/references/dwarf-symbol-recovery.md` | | Pwn / 漏洞利用 | `skills/pwn-chain/` | | 二进制保护机制策略矩阵（`checksec` → 利用路径） | `skills/pwn-chain/references/protection-bypass-matrix.md` | | EDR 绕过 | `skills/edr-bypass-re/` | | API / GraphQL | `skills/api-security/` | | 供应链 / SBOM | `skills/supply-chain-security/` | | LLM / AI 安全 | `skills/llm-security/` | | OLLVM 脱密 | `skills/reverse-engineering/references/ollvm-deobfuscation.md` | | 图表 / 报告 | `skills/diagram-generator/` / `skills/docs-generator/` | ### 关键文件 | 文件 | 用途 | |------|------| | [README_AI.md](README_AI.md) | AI Agent 配置引导（Agent 必读） | | [RULES.md](RULES.md) | 全局路由规则 | | [skills/MASTER-ROUTING.md](skills/MASTER-ROUTING.md) | PRIMARY 快路径 | | [skills/routing.md](skills/routing.md) | 路由矩阵（场景 → Skill） | | [skills/SKILL.md](skills/SKILL.md) | 总控入口 | | [skills/tool-index.md](skills/tool-index.md) | 本机工具索引（自动生成） | | [skills/scripts/master-route.ps1](skills/scripts/master-route.ps1) | 一键分诊 | | [skills/scripts/case-init.ps1](skills/scripts/case-init.ps1) | 作战 case 目录（scope/timeline） | | [skills/ops/](skills/ops/) | Scope / 证据链 / 角色 / 时间线 / skill 供应链安全 | | [skills/references/community-security-skills.md](skills/references/community-security-skills.md) | 社区安全 skill 生态对照（借鉴不并库） | ### 仓库结构 ``` . ├── README.md (English) / README_zh.md / README_AI.md ├── RULES.md / RULES_zh.md # 全局路由（含 scope 门） ├── skills/ │ ├── MASTER-ROUTING.md # PRIMARY 快路径 │ ├── SKILL.md / routing.md # 总控 + 三轴矩阵 │ ├── ops/ # Scope / 证据链 / 角色 / 时间线 │ ├── scripts/ # master-route / case-init / bootstrap / verify │ ├── field-journal/ # 脱敏经验 │ ├── apk-reverse/ mobile-reverse/ js-reverse/ dotnet-reverse/ │ ├── ida-reverse/ radare2/ reverse-engineering/ malware-analysis/ │ ├── pentest-tools/ attack-chain/ pwn-chain/ firmware-pentest/ │ ├── patch-diff-exploit/ edr-bypass-re/ binary-diff/ │ ├── api-security/ supply-chain-security/ llm-security/ │ ├── browser-automation/ diagram-generator/ docs-generator/ │ └── ... ├── CTF-Sandbox-Orchestrator/ # CTF 子技能 ├── docs/ # 平台与架构 ├── kali/ # Kali 脚本与 README-kali.md └── work/ # 本地 case 产物（gitignore） ```

(返回顶部)

## 贡献欢迎任何贡献！Fork 本仓库 → 创建特性分支 → 提交 PR 即可。 1. Fork 项目 2. `git checkout -b feature/AmazingFeature` 3. `git commit -m 'Add some AmazingFeature'` 4. `git push origin feature/AmazingFeature` 5. 提交 Pull Request ## ⚖️ 许可证 `reverse-workbench-skill` 主体采用 **MIT License**（详见 [LICENSE](LICENSE)）。方法论文档源自 reverse-skill 技能路由器；按 MIT 条款要求，其版权声明保留在 LICENSE 文件中。 **Bundled components and third-party dependencies:** - **CTF-Sandbox-Orchestrator/** is distributed under **GNU GPLv3**. - **Pentest Swarm AI**：原始项目为 **AGPL-3.0**，本仓库仅通过命令行/MCP 调用，不包含其源代码 - 其他工具（jadx、frida、nmap、burpsuite-mcp 等）遵循各自官方许可

(返回顶部)

## 致谢感谢所有开源工具和项目的作者们。本仓库集成的工具涵盖逆向工程、渗透测试、CTF、安全分析等领域，每一个工具都是社区智慧的结晶。特别感谢 OLLVM 脱密生态，以及所有协助验证样本、报告问题和改进项目的人员。

(返回顶部)