pentest-tools

Imported from boisenoise/skills-collections (skills/antigravity-pentest-tools/SKILL.md). Install upstream with npx skills add boisenoise/skills-collections --skill antigravity-pentest-tools. Copyright stays with the author (MIT).

⚠️ AUTHORIZED USE ONLY This skill is for educational purposes or authorized security assessments only. You must have explicit, written permission from the system owner before using this tool. Misuse of this tool is illegal and strictly prohibited.

Mandatory confirmation gate Before running any command that probes, exploits, changes, persists on, extracts data from, or attempts credential access against a target:

1. Ask the user to state the exact target URL, IP, account, or resource.
2. Ask the user to confirm written authorization and the permitted scope.
3. Show the exact command(s) and explain their expected effect.
4. Wait for explicit confirmation in the current conversation.

Without that confirmation, remain read-only and provide defensive guidance only. Prefer a sandbox, disposable VM, or controlled lab.

When to Use

• An authorized assessment needs standard tooling orchestrated coherently.
• Choosing and sequencing the right tool per recon/exploitation phase.

适用范围

当任务属于以下场景时使用本 skill：

• 目标信息收集（端口扫描、子域名枚举、服务识别）
• 漏洞扫描（Web 漏洞、CVE 检测、配置错误）
• Web 渗透（SQL 注入、XSS、SSRF、目录爆破）
• 密码破解（哈希破解、字典攻击）
• 网络渗透（服务利用、横向移动辅助）

与其他 skill 的分工

简单判断：

• 需要"扫描目标、发现漏洞、利用漏洞" → 本 skill
• 需要"分析程序内部逻辑" → 逆向类 skill
• 需要"操作浏览器/桌面" → browser-automation

工具矩阵

信息收集

漏洞扫描

Web 渗透

密码破解

利用框架

MCP 后端选择

本 skill 支持两种 MCP 后端，选一个即可：

方案 A：pentestMCP（推荐，Docker 一键）

• 项目：https://github.com/ramkansal/pentestmcp
• 特点：20+ 工具打包成单个 Docker 容器，MCP server 直接暴露
• 工具：Nmap、Nuclei、ZAP、SQLMap、FFUF、Nikto、Gobuster、Subfinder、httpx 等
• 安装：

# 拉取并运行
docker pull ramkansal/pentestmcp
docker run -d -p 8080:8080 ramkansal/pentestmcp

# 或本地构建
git clone https://github.com/ramkansal/pentestmcp.git
cd pentestmcp
docker build -t pentestmcp .
docker run -d -p 8080:8080 pentestmcp

• MCP 注册：

{
  "mcpServers": {
    "pentest": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

方案 B：mcp-security-hub（模块化）

• 项目：https://github.com/FuzzingLabs/mcp-security-hub
• 特点：每个工具独立 MCP server，按需启用
• 工具：Nmap、Ghidra、Nuclei、SQLMap、Hashcat
• 安装：按各子模块 README 操作

方案 C：单工具 MCP（最轻量）

如果只需要某一个工具：

Reqable MCP（本地抓包与 API 工作台）

Reqable 桌面客户端可通过官方 Reqable MCP Server 暴露本地抓包、API、断点和规则能力。先单独安装并启动 Reqable，再登记 MCP：

powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp -McpHostTarget Codex

将 Codex 替换为 Claude 或 Both 可选择对应客户端；省略 -McpHostTarget 时不会写任何客户端全局配置。

登记后的 stdio 配置为：

{
  "mcpServers": {
    "reqable-mcp": {
      "command": "npx",
      "args": ["-y", "reqable-mcp-server@1.0.1", "--scope", "minimal"]
    }
  }
}

• 默认使用 Reqable 的本地 API；必要时按官方文档配置 --host、--port 或 --scope minimal|all。
• minimal 是推荐默认范围；all 会暴露更多会改变代理、规则、环境或已保存数据的工具。
• 对捕获流量、请求重放和规则修改仍须先满足 scope.md 的授权与网络限制；不得因 MCP 已注册而扩大目标范围。

工作流

标准渗透流程

重要：执行渗透测试时，必须按 references/pentest-loop.md 的自主循环框架运行。 该框架定义了完整的风险门控、记录规范、上下文压缩和完成检查机制。

1. 信息收集
   - Nmap 端口扫描 → 确认开放服务
   - Subfinder 子域名枚举 → 扩大攻击面
   - httpx 存活检测 → 过滤有效目标

2. 漏洞扫描
   - Nuclei 模板扫描 → 快速发现已知漏洞
   - ZAP/Nikto → Web 应用深度扫描

3. 漏洞利用
   - SQLMap → SQL 注入
   - FFUF → 发现隐藏路径/参数
   - 手动验证 → 确认可利用性

4. 后渗透（如果授权范围内）
   - 权限提升
   - 横向移动
   - 数据提取

5. 报告
   - 调用 docs-generator skill 生成渗透测试报告

快速扫描流程（5 分钟出结果）

1. nmap -sV -sC target → 端口+服务
2. nuclei -u target -severity critical,high → 高危漏洞
3. 有 Web 服务 → ffuf -u target/FUZZ -w common.txt → 目录
4. 汇总发现 → 决定下一步

注意事项

• 必须有授权 — 所有扫描/攻击操作必须在授权范围内
• 控制扫描速率 — 避免触发 WAF/IDS 或打崩目标
• 先被动后主动 — 先信息收集，再漏洞扫描，最后利用
• 记录所有操作 — 每个命令和结果都要记录，用于报告
• 不要盲目自动化 — AI 应该在每个关键步骤等待确认

按需自举（On-Demand Bootstrap）

自动化能力边界

自举策略

1. 如果用户有 Docker → 推荐 pentestMCP（一键全家桶）
2. 如果没有 Docker → 按需单独安装各工具
3. 优先安装 Nmap + Nuclei + SQLMap（覆盖 80% 场景）

手动安装引导

⚠️ **渗透工具未安装**

**推荐方案（需要 Docker）**：
docker pull ramkansal/pentestmcp
docker run -d -p 8080:8080 ramkansal/pentestmcp

**轻量方案（逐个安装）**：
- Nmap: winget install Insecure.Nmap
- Nuclei: go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
- SQLMap: pip install sqlmap
- FFUF: 从 https://github.com/ffuf/ffuf/releases 下载

**安装后告诉我，我继续当前任务。**

参考资源

• awesome-pentest — 25k+ stars 渗透工具大全
• SecLists — 字典/payload 集合（FFUF/Gobuster 必备）
• PayloadsAllTheThings — 各类漏洞 payload
• HackTricks — 渗透技巧百科
• pentest-ai-agents — 35 个 Claude Code 渗透子 agent（参考其 prompt 模式）
• Pentest Swarm AI — 群体智能自主渗透框架（多 agent 协同，支持 MCP server）
• ProxyCat — 代理池中间件（批量扫描防封 IP）
• planning-with-files — 计划任务 skill（循环测试用）

本 skill 内参考文档

• references/pentest-loop.md — 核心循环框架（风险门控 + 记录规范 + 上下文压缩）
• references/recon-pipeline.md — 授权侦察流水线（CF 头 / nmap / Evidence）
• references/client-side-lab-playbook.md — DOM XSS / 原型污染 / agent-browser（靶场客户端面）
• references/burpsuite-mcp-guide.md — BurpSuite MCP 完整指南（63 工具 + 7 大使用场景 + AI Prompt 模板）
• references/automation-loop-pattern.md — 自动化循环测试模式（轻量版）
• references/awesome-pentest-digest.md — 渗透工具精华速查
• references/pentest-ai-agents-matrix.md — 35 agent 覆盖矩阵
• payloads/ — 自定义 payload 目录（AI 优先使用）
• templates/ — 渗透测试必需文件模板（scope/rules/plan/findings/progress）

src-hunter 漏洞挖掘知识库

src-hunter/ 目录包含完整的 SRC/Bug Bounty 漏洞挖掘方法论：

• 19 类攻击 playbook（IDOR、RCE、XSS、SQLi、SSRF、OAuth、文件上传等）
• 305 个结构化 payload + 263 个 WAF/EDR 绕过步骤
• 2887 份 HackerOne 已披露 High/Critical 报告
• 88,636 条 WooYun 历史案例统计
• 国产组件指纹和默认凭据
• CVSS 4.0 报告模板

使用方式：AI 在 hunt 阶段自动读取对应 playbook，按其流程测试。

详见 src-hunter/SKILL.md 和 src-hunter/references/。

路由上下文

上游入口: skills/SKILL.md（总控）、routing.md 触发条件: 需要主动扫描/攻击目标（端口扫描、漏洞检测、注入测试等） 下游出口:

• 发现 Web 漏洞需要进一步分析 → js-reverse/
• 发现二进制漏洞需要逆向 → ida-reverse/ 或 radare2/
• 需要操作浏览器验证漏洞 → browser-automation/
• 完成后生成报告 → docs-generator/

同级关联模块: CTF-Sandbox-Orchestrator/（CTF 中的 Web/Pwn 题会用到这些工具）

任务完成自检（声称完成前 MUST 通过）

• 我是否执行了工作流中的每一步（而不是只阅读）？
• 我是否基于 tool-index 使用了真实工具路径？
• 我是否产出了可复现证据（命令/脚本/截图/报告）？
• 我是否完成并回写了 RULES 要求的 Checklist 项？

Limitations

• Tool availability varies by platform; verify installs before engagements.
• Noisy scanning can disrupt fragile targets; tune timing and scope.

Adapted from zhaoxuya520/reverse-skill (MIT).