SuperAPI AI 工具集

pentest-skills-framework

安全与审计

查看项目

更新于 10-15 15:40

技能介绍

Pentest-Skills Framework 是由 ara.so 提供的 Security Skills 集合中的一套技能,定位为面向 AI CLI 工具的模块化渗透测试框架。它支持 Claude Code、Gemini CLI、Cursor 等 AI 命令行工具,通过自然语言命令实现专业安全测试。每个技能由知识文档、自动化脚本、参考文档和资源文件组成。

用途

该框架为渗透测试工作流提供原子级能力,主要包括两类:

  1. 信息收集:端口扫描、子域枚举、目录扫描、指纹识别。
  2. 漏洞利用:SQL 注入、XSS、LFI、文件下载漏洞。

主要能力

  • 自然语言接口:用平实语言描述测试目标,由 AI 选择工具并执行。
  • 自动化分析:由 AI 解读结果并生成可操作报告。
  • 模块化技能:每个技能可独立加载,包含完整文档、脚本与资源。

技能结构遵循统一模式:skill-name/ 下含 SKILL.md(核心文档,触发 AI)、scripts/(Python/Bash 自动化脚本)、references/(详细工具文档)、assets/(字典、payload、wordlist 等资源)。

可用技能列表:

  • recon-port-scan:端口扫描与服务识别
  • recon-subdomain:子域枚举与 DNS 侦察
  • recon-dir-scan:目录与文件枚举
  • recon-fingerprint:Web 指纹识别与 WAF 检测
  • exploit-sqli:SQL 注入检测与利用
  • exploit-xss:跨站脚本检测
  • exploit-lfi:本地文件包含与目录遍历
  • exploit-file-download:不安全文件下载与路径遍历

安装与使用方式

前置依赖:

  • 基础工具(Ubuntu/Debian):sudo apt update && sudo apt install -y nmap python3 python3-pip git
  • macOS:brew install nmap python3 git
  • Go 工具(子域枚举、目录扫描需要):使用 go install 安装 subfinder、dnsx、httpx、nuclei、ffuf
  • 其他工具:pip3 install sqlmap xsstrike dalfox

安装技能:

Clone the repository

git clone https://github.com/crazyMarky/pentest-skills.git cd pentest-skills

Copy all skills to Claude Code skills directory

mkdir -p ~/.claude/skills cp -r * ~/.claude/skills/

Or copy specific skills

cp -r recon-port-scan ~/.claude/skills/ cp -r exploit-sqli ~/.claude/skills/

重启 AI 编码代理以加载技能。

典型使用模式:

  • 端口扫描:自然语言“扫描 localhost 的开放端口并分析服务版本”;也可直接用 nmap -sV -T4 localhost,或运行 scripts/port_scanner.py。
  • 子域枚举:自然语言“查找 example.com 的所有子域”;也可用 subfinder、dnsx、httpx 组合命令,或运行 scripts/subdomain_enum.py。
  • SQL 注入测试:自然语言“测试该 URL 是否存在 SQL 注入”;也可用 sqlmap 命令,或运行 scripts/sqli_tester.py。
  • XSS 测试:自然语言“检查该表单参数是否存在 XSS 漏洞”;也可用 xsstrike、dalfox 命令,或运行 scripts/xss_tester.py。
  • 目录枚举:自然语言“枚举 http://target.com 上的目录和文件”;也可用 ffuf、gobuster、feroxbuster。

配置方式:

  • 通过环境变量存放敏感数据,如 SHODAN_API_KEY、VIRUSTOTAL_API_KEY、DB_HOST/DB_USER/DB_PASS、HTTP_PROXY/HTTPS_PROXY。
  • 每个技能可带 config.yaml,配置默认时序、端口、输出格式与保存路径等。

组合与扩展:

  • 可将多个技能串联为完整侦察流程(如 scripts/full_recon.py:端口扫描→子域枚举→目录扫描→指纹识别,输出 JSON)。
  • 可通过 scripts/generate_report.py 生成含严重性分级的 HTML 渗透测试报告。

排错要点:权限不足时可用 sudo 或加入 pcap 组;工具找不到时检查 PATH 并配置 Go bin 目录;可设置限速、代理与超时。

适用场景

仅限获得明确书面授权的系统,用于授权渗透测试、CTF 竞赛或教育目的。

限制与合规

框架明确警告:未经授权的测试违法,可能依据网络犯罪法律(如美国 CFAA、英国 Computer Misuse Act)受到处罚。使用者须获取书面授权、遵守当地法律法规,并对自身行为承担全部责任。