setup-pentester-tools

name	setup-pentester-tools
description	初始化渗透测试环境——检查并安装 Playwright 浏览器、Docker Kali 镜像等依赖。

Setup Pentester Tools

初始化渗透测试环境所需的依赖。每项会检查是否已安装，如果没有则询问用户是否要装，可选择跳过。

---

检查列表

#	检查项	修复命令	需网络
1	Playwright + Chromium 浏览器	npm run setup	✅
2	Docker Kali 镜像 kalilinux/kali-rolling	docker pull kalilinux/kali-rolling	✅
3	Pi skill 引用	mkdir -p .pi && echo '{"skills":["../.pentester/skills"]}' > .pi/settings.json	❌
4	Claude Code skill 引用	.claude/skills/ → .pentester/skills/ 符号链接	❌

---

执行流程

逐项检查，每项检查到缺失时，询问用户是否初始化。用户同意才执行，拒绝则跳过。

1. Playwright 检查

# 检查是否已安装
ls .pentester/skills/playwright-skill/node_modules/.package-lock.json 2>/dev/null

• 已安装 → ✅ 跳过
• 未安装 → 询问: "Playwright 浏览器未安装，需要初始化吗？(需要下载 ~300MB Chromium)"
  • 是 → 执行 cd .pentester/skills/playwright-skill && npm run setup
  • 否 → ⏭️ 跳过

2. Docker Kali 镜像检查

# 检查镜像是否存在
docker images kalilinux/kali-rolling -q 2>/dev/null

• 存在 → ✅ 跳过
• 不存在 → 询问: "Docker Kali 镜像未拉取，需要现在下载吗？(~1.3GB)"
  • 是 → 执行 docker pull kalilinux/kali-rolling
  • 否 → ⏭️ 跳过（首次使用时自动拉取）

3. Pi 项目 skill 引用

# 检查 .pi/settings.json 是否存在
test -f .pi/settings.json && grep -q '\.pentester/skills' .pi/settings.json 2>/dev/null

• 已配置 → ✅ 跳过
• 未配置 → 执行 mkdir -p .pi && echo '{"skills":["../.pentester/skills"]}' > .pi/settings.json （不需要网络，纯配置）

4. Claude Code skill 引用

# 检查 .claude/skills/ 是否存在且有链接
ls -d .claude/skills/ptes-intelligence 2>/dev/null

• 已配置 → ✅ 跳过
• 未配置 → 创建 .claude/skills/ 目录，为 .pentester/skills/ 下每个 skill 创建符号链接

---

输出

检查完成后输出状态表：

┌──────────────────────┬──────────┐
│ 依赖                  │ 状态     │
├──────────────────────┼──────────┤
│ Playwright + Chromium│ ✅ 已安装 │
│ Docker Kali 镜像     │ ✅ 已就绪 │
└──────────────────────┴──────────┘

如某项跳过，状态为 ⏭️ 跳过。用户随时可以重新运行此 skill 补装。