# 核心工具（任意子集均可 — Pentx 会自动适配）
sudo apt install nmap nuclei httpx sqlmap ffuf nikto amass subfinder
# 或在 Termux 上：
pkg install nmap nuclei httpx sqlmap ffuf nikto amass subfinder

# Python 依赖
pip3 install requests beautifulsoup4

git clone https://github.com/yashas-13/pentx-vapt-skill.git
cd pentx-vapt-skill

# 1. 检查哪些工具可用
python3 scripts/pentx.py --check

# 2. 运行完整 5 阶段 VAPT（只读、安全）
python3 scripts/pentx.py https://target.example.com ./output --no-exploit

# 3. 完整评估（需要授权 — 请阅读阶段 1 提示）
python3 scripts/pentx.py https://target.example.com ./output

# 4. 仅运行特定阶段
python3 scripts/pentx.py https://target.example.com ./output --phase 3

# 5. 从现有发现重新生成报告
python3 scripts/pentx.py ./output --phase 5

output/
├── phase1-recon/
│   ├── assets.txt        → 所有发现的资产
│   ├── live.json         → 存活主机（httpx）
│   └── subdomains.txt    → 子域名枚举
├── phase2-scan/
│   ├── nmap_full.json    → 完整 nmap 结果
│   ├── ffuf_dirs.json    → 目录模糊测试
│   └── nikto.json        → Nikto 发现
├── phase3-vuln/
│   └── findings.jsonl    → 漏洞发现（JSONL）
├── phase4-exploit/
│   └── exploits.jsonl    → 已确认的利用 + PoC
├── report.html           → 完整 HTML 报告
├── report.md             → 完整 Markdown 报告
├── exec-summary.md       → 执行摘要
├── findings-merged.json  → 所有合并的发现
└── poc-full/
    └── poc-*.txt         → 原始 PoC 工件（*.txt）

pentx-vapt-skill/
├── SKILL.md                        # pi-agent 技能规范
├── README.md                       # 本文件
├── LICENSE                         # MIT
├── CONTRIBUTING.md                 # 贡献指南
├── assets/
│   └── report_template.md          # 报告模板
├── references/
│   ├── methodology.md              # 5 阶段方法论 + PoC 模板 + CVSS
│   └── tools-matrix.md             # 工具能力 + 准确性策略
└── scripts/
    ├── pentx.py                    # 主 CLI 编排器
    ├── tools_check.sh              # 工具可用性检查器
    └── lib/
        ├── pentx_common.py         # 发现存储、PoC 捕获、回退机制
        ├── phase_recon.py          # 阶段 1
        ├── phase_scan.py           # 阶段 2
        ├── phase_vuln.py           # 阶段 3
        ├── phase_exploit.py        # 阶段 4
        └── report_gen.py           # 阶段 5

# 安装或更新 Pentx 技能
bash -c "$(curl -fsSL https://raw.githubusercontent.com/yashas-13/pentx-vapt-skill/main/scripts/install.sh)"

# 或使用 pi-agent（如果已安装）
/pentx install

#!/usr/bin/env bash
set -euo pipefail
REPO="yashas-13/pentx-vapt-skill"
BRANCH="main"
INSTALL_DIR="${HOME}/.pi/agent/skills/pentx"

echo "🔧 正在安装 Pentx VAPT 技能..."
mkdir -p "${INSTALL_DIR}"
curl -fsSL "https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz" | \
  tar -xz --strip-components=1 -C "${INSTALL_DIR}"

# 检查工具
python3 "${INSTALL_DIR}/scripts/pentx.py" --check

echo "✅ Pentx 已安装到 ${INSTALL_DIR}"
echo "📖 运行：python3 ${INSTALL_DIR}/scripts/pentx.py https://target.example.com ./output --no-exploit"