🔍 Pentest Skill — 黑盒Web渗透测试自动化框架

中文 | EN

一套可被任何 AI Agent（Claude Code、Codex、Cursor、WorkBuddy 等）直接调用的黑盒 Web 渗透测试框架。通过标准化的 CLI 接口，支持从侦察到报告的完整渗透测试流程。

⚠️ 免责声明

本工具仅供授权的安全测试和研究使用。 使用前必须获得目标系统所有者的明确书面授权。未经授权的渗透测试属于违法行为。作者对任何滥用不承担任何责任。

🚀 快速开始

# 1. 克隆仓库
git clone https://github.com/wudidike/pentest_skill.git
cd pentest_skill

# 2. 一键安装（自动下载 Go 工具 + Python 依赖 + Payload 同步）
bash setup.sh

# 3. 环境检查
python scripts/health_check.py

# 4. 开始渗透测试
python scripts/phase0_fingerprint.py --target https://example.com --output-dir ./output

可选安装

bash setup.sh --with-playwright   # 安装 Playwright（Phase 4 深度渲染）
bash setup.sh --with-sqlmap       # 安装 sqlmap（Phase 7D SQL注入验证）
bash setup.sh --update            # 更新所有工具到最新版本

📋 功能概览

🏗️ 架构

pentest_skill/
├── SKILL.md              # Agent 指令（AI 读这个文件）
├── config.yaml           # 配置文件
├── requirements.txt      # Python 依赖
├── setup.sh              # 一键安装脚本
├── Makefile              # 自动化入口
├── phases/               # 详细 Phase 指令
├── references/payloads/  # 本地 Payload (自动同步自 PATT)
├── wordlists/            # 目录枚举字典
├── scripts/              # Python 脚本
│   ├── core/             # 核心基础设施
│   ├── vuln/             # 漏洞模块化体系
│   ├── phase*.py         # 各 Phase 入口
│   ├── health_check.py   # 环境检查
│   ├── sync_payloads.py  # Payload 同步
│   └── run_benchmark.py  # 基准测试
├── tests/                # 回归测试
└── tools/                # 外部工具（setup.sh 自动下载）

🛠️ 外部工具依赖

🧪 测试

# 回归测试
make test
# 或
python tests/test_core.py

# 基准测试
make benchmark
# 或
python scripts/run_benchmark.py

# 环境检查
python scripts/health_check.py

📖 使用方式

AI Agent 使用（推荐）

1. 将 SKILL.md 加载到你的 AI Agent（Claude Code / Cursor / WorkBuddy）
2. 告诉 Agent："对 https://target.com 进行渗透测试"
3. Agent 会自动执行完整管道

CLI 直接使用

# 完整管道
python scripts/cli.py --target https://example.com --mode url

# 单独运行某个 Phase
python scripts/phase0_fingerprint.py --target https://example.com --output-dir ./output

# 只做侦察
python scripts/phase0_fingerprint.py --target URL --output-dir ./output
python scripts/phase4_render.py --target URL --output-dir ./output --deep
python scripts/phase5_dir_enum.py --target URL --output-dir ./output

⚙️ 配置

编辑 config.yaml 自定义行为：

validation:
  report_language: "zh-CN"  # 报告语言 (zh-CN / en)
network:
  proxy: ""                 # HTTP 代理
  timeout: 15               # 超时秒数
tools:
  nuclei:
    path: ""                # 留空自动检测

📄 License

MIT License. 仅供授权安全测试使用。

🔗 链接

• GitHub
• Issues
• PayloadsAllTheThings