/vibe-pentest

name: vibe-pentest
description: |
  AI 渗透测试：多 Agent 并行架构的 Web 应用渗透测试技能。
  流程: 指纹识别 → 后台入口扫描 → API 预扫描 → 浏览器登录提取凭证（可选） → GoSpider 爬虫 →
  过滤数据 → 指纹汇总 → 多 Agent 并行渗透测试 → 攻击链分析 → 漏洞证据复查 → 生成报告。
metadata:
  author: helloworld
  version: "1.0.32"
  date: 2026-09-21

Vibe Pentest — 多 Agent 并行 Web 渗透测试

启动前快速 Git 自更新

每次调用本 skill 时，在开始正式任务前优先执行：

`python {SKILL_ROOT}/scripts/auto_update_skill.py {SKILL_ROOT} --json`

该脚本负责快速检查并同步当前 skill 项目；如果更新失败、超时、无网络、无法获取远端状态，或 `SKILL_ROOT` 目录不是 Git 仓库，直接跳过更新并继续执行用户任务，不要卡住。

如果 `git pull` 有文件冲突，脚本会自动将远端最新文件覆盖到本地冲突文件，但不会执行 `git reset --hard` 之类的全局破坏性操作。

如果自动更新结果的 `reason` 为 `updated` 或 `updated_with_conflict_resolution`，必须先重新读取主 `SKILL.md`，再继续后续步骤。

启动前运行子 Agent 创建脚本

开始渗透前，在**当前项目目录**下，直接调用脚本创建Agent `python {SKILL_ROOT}/scripts/install_sub_agents.py --provider {provider} --force` 提前创建实际启用的子 Agent。

`--provider` 应根据当前智能体平台选择，例如 `qoder`、`opencode`、`trae`、`claude`、`workbuddy`、`codebuddy`，也支持自定义名称。

命令示例：

python {SKILL_ROOT}/scripts/install_sub_agents.py --provider qoder --force

启动前创建本次任务工作目录

每次新任务使用独立工作目录；历史 `workspace*` 目录一律只读保留，不得重命名、移动或删除。

1. 在**当前项目目录**下创建本次任务的工作目录，目录名格式 `workspace_{YYYYMMDD_HHmmss}`（时间戳取当前时间），并记录其**绝对路径**：

• **Windows (PowerShell) 示例**：`$ws = (New-Item -ItemType Directory -Force -Path "workspace_$(Get-Date -Format 'yyyyMMdd_HHmmss')").FullName; $ws`
• **Linux/macOS (Bash) 示例**：`ws="workspace_$(date +%Y%m%d_%H%M%S)"; mkdir -p "$ws"; ws="$(cd "$ws" && pwd)"; echo "$ws"`

2. 本次任务全程复用该绝对路径。下文所有 `{WORKSPACE_DIR}` 均指它，执行命令前必须替换为真实绝对路径，不得保留占位符，也不得退回相对目录名。

**每条读写工作目录的命令都必须显式传入 `{WORKSPACE_DIR}`**（通过 `--workspace`、`-o` 或位置参数）。并发任务、新开终端与子 Agent 之间不共享任何隐式状态，显式传绝对路径是唯一可靠方式；未显式传入时脚本会按当前 cwd 退回 `./workspace`，导致产物写错目录。

SKILL 目录结构（全部使用相对路径）

vibe-pentest/
├── SKILL.md                     # 主 skill（整体架构、数据协议、工作流）
├── agents/
│   ├── injection-agent/         # Agent 1: 注入类漏洞正式执行规范
│   ├── auth-agent/              # Agent 2: 认证、会话、令牌与协议流正式执行规范
│   ├── file-agent/              # Agent 3: 文件系统访问、解析链与 RCE 升级正式执行规范
│   ├── api-agent/               # Agent 4: API 资源授权、对象归属与接口扩散正式执行规范
│   ├── business-agent/          # Agent 5: 业务状态机、竞争条件与真实业务影响正式执行规范
│   ├── misc-agent/              # Agent 6: 外围攻击面、协议边界与配置风险正式执行规范
│   ├── poc-agent/               # Agent 7: 基于指纹的已知漏洞 POC 验证正式执行规范
│   └── vuln-analysis-agent/     # Agent 8: 攻击链分析与漏洞证据复查正式执行规范
├── scripts/
│   ├── run_fingerprint.py        # Phase 0: Web 指纹识别
│   ├── fingerprints_rules/       # Phase 0: 指纹规则库（run_fingerprint.py 依赖）
│   ├── poc/                      # Phase 5 POC Agent: Nuclei YAML 格式 POC 文件
│   ├── admin_scanner.py          # Phase 0.5: 后台管理面板扫描
│   ├── extract_credentials.py    # Phase 2: 浏览器登录 + 凭证提取
│   ├── run_gospider.py           # Phase 3: GoSpider 爬虫
│   ├── clean_targets.py          # Phase 4: 数据清洗 + 域名过滤
│   ├── api_discovery.py          # API 预扫描 1: 接口发现
│   ├── sensitive_extract.py      # API 预扫描 2: 敏感参数提取
│   ├── deduplicate.py            # API 预扫描 3: 去重与聚合
│   ├── prepare_agent_findings.py # Phase 5: 预生成 findings 骨架
│   ├── verify_findings.py        # Phase 5.6: 漏洞证据复查
│   ├── generate_report.py        # Phase 6: 生成 JSON 报告
│   ├── install_sub_agents.py     # 安装 8 个子 Agent 定义到平台目录
│   ├── auto_update_skill.py      # 启动前快速 Git 自更新
│   ├── workspace_env.py          # 统一工作目录解析（各脚本复用）
│   ├── http_test.py              # ★ 统一 HTTP 发包工具
│   ├── dnslog.py                 # ★ DNS 回调 OOB 验证工具
│   ├── ws_test.py                # WebSocket 发包工具
│   └── deserialization_payload.py # Java 反序列化 payload 生成工具
├── references/
│   ├── sub_agents/               # 8 个子 Agent 的可直接复制创建定义
│   ├── pentest_skills/           # 各漏洞专项测试 Skill 与 INDEX 路由
│   ├── common-paths.md           # 常见后台/登录路径列表
│   ├── report-json-format.md     # 最终报告 JSON 格式约束
│   ├── dnslog-usage.md           # dnslog.py 用法参考
│   ├── http-test-usage.md        # http_test.py 用法参考
│   └── ws-test-usage.md          # ws_test.py 用法参考
├── report_renderers/
│   ├── generate_word.py          # Word 报告渲染器
│   └── generate_html.py          # HTML 报告渲染器
└── tools/
    ├── gospider_downloads.json   # GoSpider 多平台下载清单
    ├── gospider(.exe)            # GoSpider 可执行文件
    └── .cache/                   # GoSpider 下载与解压缓存

> **注意**：所有路径均为相对路径，skill 可整体移动到任意位置使用。

架构总览

┌──────────────────────────────────────────────────────────────────────────────┐
│                             Main Skill Flow                                 │
├──────────────────────────────────────────────────────────────────────────────┤
│ Phase 0   : 指纹识别                                                        │
│ Phase 0.5 : 后台入口扫描 - 377+ 路径探测 + 80+ 产品指纹识别                │
│ Phase 1   : 授权确认                                                        │
│ Phase 2   : 浏览器登录 + 凭证提取          (scripts/extract_credentials.py) │
│ Phase 3   : GoSpider 爬虫                (scripts/run_gospider.py)          │
│ Phase 4   : 数据清洗                    (scripts/clean_targets.py)          │
│ Phase 4.5 : 指纹汇总（汇总 fingerprint/admin_scan/api_discovery 到 tech_stack）│
│ Phase 5   : 生成 findings 骨架        (scripts/prepare_agent_findings.py)  │
│           : 并行分发启用的渗透 Agent（按提示词指定）                         │
│ Phase 5.5 : 调用漏洞综合分析 Agent - 跨 Agent 漏洞组合                   │
│ Phase 5.6 : 复用漏洞综合分析 Agent - 逐一审查 confirmed 漏洞证据            │
│ Phase 6   : 聚合结果 + JSON 报告导出   (scripts/generate_report.py)        │
├────────────┬────────────┬────────────┬────────────┬────────────┬────────────┬────────────┤
│ Injection  │ Auth       │ File       │ API        │ Business   │ Misc       │ POC        │
│ Agent      │ Agent      │ Agent      │ Agent      │ Agent      │ Agent      │ Agent      │
└────────────┴────────────┴────────────┴────────────┴────────────┴────────────┴────────────┘

需要创建的渗透 agent（按提示词指定启用）

| # | Agent 名称 | 类型 | 职责范围 | 创建 Agent 定义文件 | |---|-----------|------|------|---------| | 1 | **injection-agent** | 渗透 | 负责所有注入类漏洞检测：SQLi/NoSQL/XSS(存储/反射/DOM)/SSRF/XXE/SSTI/RCE/反序列化/CRLF/XSLT/EL/JNDI | `references/sub_agents/injection-agent.md` | |