opencode-skills-collection 4.0.43 → 4.0.45

package/bundled-skills/pentest-tools/references/pentest-loop.md

@@ -0,0 +1,270 @@
+# 授权渗透测试自主循环
+
+> 本文件定义了 AI 执行渗透测试时的完整自主循环框架。
+> AI 在进入渗透测试模式后，必须按此框架运行。
+
+你正在一个授权的渗透测试工作区内，以谨慎、专业的安全测试助手身份操作。
+
+你的目标是帮助完成 `scope.md` 中描述的安全评估，同时严格遵守 `rules.md`。
+
+这不是一个不受限制的攻击循环。你必须安全地操作，记录所有内容，并在风险增加时停止并请求批准。
+
+---
+
+## 必需文件
+
+在每次迭代之前，请阅读或刷新以下文件：
+
+1. `scope.md` — 授权范围
+2. `rules.md` — 测试规则
+3. `task_plan.md` — 测试计划
+4. `findings.md` — 发现记录
+5. `progress.md` — 进度记录
+
+将这些文件视为事实来源。
+
+如果缺少其中任何文件，从 `templates/` 目录复制对应模板并填写，然后继续。
+
+---
+
+## 核心循环
+
+对于每次迭代，请遵循以下顺序：
+
+### 1. 重新对齐目标
+
+问自己：
+
+- 用户的授权目标是什么？
+- 当前项目的目标是什么？
+- 我处于测试的哪个阶段？
+- 已经完成了哪些工作？
+- 还有哪些未完成？
+- 哪些是被明确禁止的？
+
+### 2. 审查已知发现
+
+检查 `findings.md` 并识别：
+
+- 已知的端点
+- 参数
+- 认证行为
+- 授权行为
+- 有趣的响应头
+- JavaScript 文件
+- API 路由
+- 错误信息
+- 技术线索
+- 之前失败的尝试
+- 已收集的证据
+
+### 3. 决定下一个最安全且有价值的操作
+
+选择恰好一个下一步操作。
+
+该操作必须：
+
+- 在授权范围内
+- 默认低风险
+- 对推进任务有用
+- 以证据为导向
+- 在可能的情况下是可逆的或只读的
+- 在速率和体量上保持保守
+
+优先选择被动或低风险的操作。
+
+### 4. 风险门控
+
+将下一步操作分类为：
+
+- **低风险**：被动审查、读取本地文件、整理笔记、分析已捕获的流量
+- **中风险**：向范围内目标发送少量受控的 HTTP 请求
+- **高风险**：模糊测试、暴力破解、漏洞利用、文件上传测试、认证绕过验证、OAST 载荷、可能改变服务端状态的操作
+- **严重风险**：破坏性操作、大流量、超出范围、数据外渗、拒绝服务、持久化、横向移动
+
+规则：
+
+- 低风险、中风险、高风险操作可以继续
+- **严重风险操作不得执行**。需要明确的用户批准才能执行
+
+### 5. 执行或请求批准
+
+如果操作是低/中/高风险：
+
+- 仅执行最小必要的操作
+- 避免激进的扫描
+- 除非已配置并获得批准，否则避免不必要的代理
+- 避免触碰范围外的主机
+- 避免破坏性载荷
+
+如果操作是严重风险：
+
+- 不执行
+- 写出提议的操作、理由、风险和预期证据
+- 请求用户批准
+
+### 6. 记录结果
+
+每次操作后，更新：
+
+- `progress.md`：记录做了什么、何时做的、发生了什么
+- `findings.md`：记录任何有用的发现、证据或假设
+- `task_plan.md`：记录阶段进度和下一步计划
+
+不要仅依赖聊天上下文。
+
+### 7. 继续前的自我检查
+
+问自己：
+
+- 我取得进展了吗？
+- 我更新了正确的文件吗？
+- 我收集了证据吗？
+- 我重复了失败的操作吗？
+- 我是否保持在授权范围内？
+- 下一步操作仍然安全吗？
+- 成功标准是否已经达成？
+
+### 8. 完成检查
+
+仅在以下情况下任务才算完成：
+
+- `task_plan.md` 中所有计划的阶段都已完成，或已明确跳过并给出理由
+- 重要发现附有证据
+- 风险已分类
+- 剩余的不确定项已记录
+- 最终报告草稿已存在或已准备好生成
+
+如果完成：停止循环 → 总结最终状态 → 列出证据 → 列出未解决项 → 生成最终报告
+
+如果未完成：继续执行下一个最安全且有价值的操作
+
+---
+
+## 硬性安全规则
+
+永远不要执行：
+
+- 拒绝服务测试
+- 高频率扫描
+- 密码喷洒
+- 凭证填充
+- 破坏性利用
+- 持久化
+- 横向移动
+- 数据外渗
+- 在授权范围外测试
+- 绕过用户的明确限制
+
+如果不确定某个操作是否被允许，请停止并询问。
+
+---
+
+## 用户协助
+
+当需要用户帮助时请随时提出：
+
+1. 打开浏览器进行点击
+2. 输入验证码
+3. 查看你看不到的变化
+4. 验证某个东西
+
+---
+
+## 每次迭代的输出格式
+
+```markdown
+### 循环迭代摘要
+
+当前阶段：
+上一步已完成的操作：
+新发现：
+下一步操作的风险等级：
+下一步操作：
+理由：
+已更新的文件：
+是否需要批准：是/否
+```
+
+如果需要批准，停止并询问用户。
+
+---
+
+## 上下文压缩
+
+每次循环结束后，必须对当前上下文进行压缩总结。压缩不是简单摘要，而是为了让下一轮渗透测试能够安全、连续、可复盘地进行。
+
+### 必须保留的信息
+
+1. **授权范围** — 域名/IP/应用/API/账号/环境 + 禁止项 + 限制条件
+2. **当前目标** — 测试阶段 + 本轮目标 + 完成状态
+3. **已发现资产** — URL/接口/参数/认证流程（区分已确认 vs 推测）
+4. **已测试内容** — 测过什么 + 用了什么方法 + 结果如何（避免重复低价值测试）
+5. **漏洞发现与线索** — 已确认漏洞 + 潜在漏洞 + 可疑行为 + 异常报错
+6. **证据** — 关键请求/响应 + 状态码 + 截图/日志/文件路径 + 时间戳
+7. **风险与安全** — 已执行操作 + 主动避免的操作 + 是否合规
+8. **敏感信息** — 不存完整密码/Token，只保留类型和状态描述
+9. **假设与下一步** — 未验证假设 + 下一轮低风险验证方向
+
+### 压缩格式
+
+```markdown
+## Loop Context Summary
+
+### 1. Authorization Scope
+- In scope:
+- Out of scope:
+- Constraints:
+- Approval required for:
+
+### 2. Current Phase and Objective
+- Current phase:
+- Loop objective:
+- Status:
+- Reason:
+
+### 3. Confirmed Assets
+- Domains/subdomains:
+- URLs/endpoints:
+- Parameters:
+- Auth/session details:
+- JS/API clues:
+
+### 4. Tested Items
+- Tested:
+- Method:
+- Result:
+- Already ruled out:
+
+### 5. Findings and Clues
+- Confirmed findings:
+- Potential vulnerabilities:
+- Suspicious behavior:
+- Error messages:
+- Access control observations:
+
+### 6. Evidence
+- Important requests:
+- Important responses:
+- Status codes:
+- Burp/Repeater/Collaborator references:
+- Screenshots/logs/files:
+- Timestamps:
+
+### 7. Risk and Safety
+- Low-risk actions performed:
+- High-risk actions avoided:
+- Actions requiring approval:
+- Compliance with rules:
+
+### 8. Sensitive Data Handling
+- Secrets stored: No
+- Redacted values:
+- Authentication state:
+
+### 9. Next Recommended Steps
+- Next low-risk step:
+- Hypothesis to verify:
+- Required tools:
+- Stop condition:
+```

package/bundled-skills/pentest-tools/references/recon-pipeline.md

@@ -0,0 +1,154 @@
+# 授权侦察流水线（Bug Bounty / 渗透）
+
+> 来源启发：社区 bug bounty recon 管线（subfinder→httpx→katana→nuclei→ffuf 等）、claude-bug-bounty 类 /recon 流程  
+> 日期：2026-07-17（P0 ops：CF 浏览器头 / Windows nmap / Evidence append）  
+> **MUST** 先满足 `ops/scope-contract.md`；禁止「只给一个域名就全网狂扫」
+
+## 0. 门闩
+
+```text
+□ auth.status = granted（SRC/BB in-scope / 书面授权）
+□ in_scope.assets 非空（域名/IP/URL 列表）
+□ network_profile = authorized_target_only | lab_only
+□ out_of_scope 已读（禁止 DoS、禁止超范围）
+```
+
+Ready case in one shot:
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\case-init.ps1 `
+  -Hint "web pentest app.example" -CaseName "demo-case" `
+  -AuthGranted -TargetUrl "https://app.example/" -NetworkProfile authorized_target_only
+
+# ACT 前轻量门禁（未就绪 exit 2）
+powershell -File skills\scripts\case-guard.ps1 -CaseRoot work\demo-case
+```
+
+## 0.1 Cloudflare / CDN 边缘：浏览器客户端头（MUST 先试）
+
+很多 SaaS 在 **裸 curl / 数据中心 UA** 上返回 WAF `403 access-policy`（例如 `ap3`），但带浏览器 Origin/Referer 后 API 正常。
+
+**默认先用可复制模板**（再谈目录爆破/nuclei）：
+
+```bash
+# Headers only
+curl -sS -D - -o NUL --max-time 15 \
+  -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36" \
+  -H "Accept: application/json, text/plain, */*" \
+  -H "Origin: https://app.example" \
+  -H "Referer: https://app.example/" \
+  "https://api.example/v1/health"
+
+# Same-site style API call
+curl -sS --max-time 15 \
+  -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36" \
+  -H "Accept: application/json" \
+  -H "Origin: https://app.example" \
+  -H "Referer: https://app.example/" \
+  -H "Sec-Fetch-Site: same-site" \
+  -H "Sec-Fetch-Mode: cors" \
+  -H "Sec-Fetch-Dest: empty" \
+  "https://api.example/app/v1/clock"
+```
+
+```text
+□ 裸 curl 403 + JSON access-policy / CF-RAY → 换浏览器 UA + Origin/Referer 重试
+□ 仍 403 且 HTML 含 Cf-Mitigated: challenge → 需要真实浏览器 / 登录会话，不要盲扫打爆
+□ SPA 任意路径 200 + 相同 body 大小 → 多为前端路由，不是真实 API 命中
+```
+
+## 0.2 Windows curl：`[]` 被当成范围（原型污染 URL）
+
+```text
+curl: (3) bad range in position N: ... __proto__[test]=...
+```
+
+**MUST** 使用 `--globoff`，或 `--data-urlencode`：
+
+```bash
+curl.exe --globoff -sS "https://target/?__proto__%5Btest%5D=polluted"
+curl.exe --globoff -sS -G "https://target/path" --data-urlencode "__proto__[test]=polluted"
+```
+
+客户端 / DOM 面进一步见 `client-side-lab-playbook.md`。
+
+## 0.3 Windows nmap 坑（本机）
+
+在部分 Windows 环境，默认 Nmap 可能报：
+
+```text
+dnet: Failed to open device eth0
+QUITTING!
+```
+
+**处理：**
+
+```text
+□ 优先 TCP connect 扫描：nmap -sT -sV --top-ports 50 -Pn -T3 target
+□ 目标在 Cloudflare/CDN 后：应用层（HTTPS/API/JS）优先，全端口 raw 扫描收益低
+□ 仍失败：记录为环境限制，继续 http/curl 侦察，不要卡死在 nmap
+```
+
+## 1. 推荐阶段（可裁剪）
+
+| 阶段 | 典型工具 | 产出 |
+|------|----------|------|
+| 1 被动子域 | subfinder / amass / crt | domains.txt |
+| 2 存活 | httpx（注意：Windows 上 `httpx` 可能是 Python 库 CLI，不是 projectdiscovery） | live.txt + tech |
+| 3 URL/爬虫 | katana / gau / wayback（按授权） | urls.txt |
+| 4 指纹/模板 | nuclei -severity critical,high | candidates |
+| 5 目录/参数 | ffuf / arjun | 隐藏面 |
+| 6 验证 | 手工 / sqlmap / 专用 PoC | **E-*** 证据 |
+| 7 报告 | docs-generator | F/P 链 |
+
+工具未在 bootstrap-manifest 中的：**文档安装或 Kali 预装**，禁止假装可 bootstrap。
+
+## 2. Evidence 门（降误报 — 本包特色）
+
+```text
+nuclei/ffuf 命中 ≠ Finding validated
+□ 每条候选：复现命令 + 响应摘录（脱敏）→ E-id
+□ 仅 validated 进报告 High+
+□ timeline 每阶段至少 1 条
+```
+
+### 2.1 追加 Evidence（固定结构，禁止自创目录）
+
+契约字段见 `skills/ops/evidence-finding-path.md`。  
+一键写入 case 目录：
+
+```powershell
+# Prefer -RawExcerptFile when excerpt has quotes/spaces (nested powershell -File splits multi-word values)
+Set-Content work\demo-case\excerpt.txt -Value '{"clock":"...","status":true}' -Encoding utf8
+powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\append-evidence.ps1 `
+  -CaseRoot "work\demo-case" `
+  -Id "E-001" `
+  -Title "Public clock API returns 200" `
+  -ReproCommand 'curl -s "https://api.example/app/v1/clock" -A "Mozilla/5.0" -H "Origin: https://app.example" -H "Referer: https://app.example/"' `
+  -Severity info `
+  -Status observed `
+  -RawExcerptFile "work\demo-case\excerpt.txt" `
+  -Location "https://api.example/app/v1/clock"
+```
+
+产物：
+
+- `work/<case>/evidence/E-001.md`（含 title / repro_command / raw_excerpt / status）
+- `work/<case>/evidence/INDEX.md` 索引行
+
+社区「7-question gate / 检测与验证分离」思路：与我们的 Evidence→Finding 一致。
+
+## 3. 与 src-hunter / api-security
+
+深度漏洞类型 playbook → `pentest-tools/src-hunter/`。  
+本流水线解决 **怎么从资产到候选**；playbook 解决 **怎么验某一类洞**。  
+Web SaaS 未登录面 → 本流水线；拿到 token/会话后的 BOLA/IDOR → 可交接 `api-security/`。
+
+## 4. 明确禁止
+
+```text
+□ 无 scope 的 masscan 全网段
+□ 对 out_of_scope 子公司/第三方自动扩展
+□ 把 scanner 输出直接当已确认漏洞写 HackerOne
+□ 在 Cloudflare challenge 上硬刚爆破打崩边缘
+```

package/bundled-skills/pentest-tools/references/templates/findings.md

@@ -0,0 +1,21 @@
+# 发现记录 (Findings)
+
+## 已确认漏洞
+
+<!-- 格式：
+### [编号] 漏洞名称
+- 风险等级：高/中/低
+- 位置：URL/接口/参数
+- 证据：请求/响应摘要
+- 复现步骤：
+- 修复建议：
+-->
+
+## 潜在漏洞（待验证）
+
+## 信息泄露
+
+## 有趣的线索
+
+## 已排除（测试过但不存在）
+

package/bundled-skills/pentest-tools/references/templates/progress.md

@@ -0,0 +1,17 @@
+# 进度记录 (Progress)
+
+## 时间线
+
+| 时间 | 操作 | 结果 | 风险等级 |
+|------|------|------|---------|
+| | | | |
+
+## 当前状态
+
+- 当前阶段：
+- 已完成轮次：0
+- 发现漏洞数：0
+- 待验证线索：0
+
+## 备注
+

package/bundled-skills/pentest-tools/references/templates/rules.md

@@ -0,0 +1,35 @@
+# 测试规则 (Rules)
+
+## 允许的操作
+
+- [x] 被动信息收集
+- [x] 端口扫描（低速率）
+- [x] 漏洞扫描（Nuclei 模板）
+- [x] Web 应用测试（SQL 注入、XSS、SSRF 等）
+- [ ] 暴力破解（需确认）
+- [ ] 社会工程（需确认）
+
+## 禁止的操作
+
+- 拒绝服务（DoS/DDoS）
+- 数据外渗（不得下载用户数据）
+- 持久化（不得植入后门）
+- 横向移动（不得攻击范围外主机）
+- 物理渗透
+
+## 速率限制
+
+- 最大并发请求：
+- 扫描间隔：
+- 每分钟最大请求数：
+
+## 时间窗口
+
+- 允许测试时间：
+- 禁止测试时间：
+
+## 报告要求
+
+- 发现高危漏洞时：立即通知
+- 报告格式：Markdown
+- 报告交付时间：

package/bundled-skills/pentest-tools/references/templates/scope.md

@@ -0,0 +1,29 @@
+# 授权范围 (Scope)
+
+## 目标
+
+| 类型 | 目标 | 备注 |
+|------|------|------|
+| 域名 | | |
+| IP | | |
+| 应用 | | |
+| API | | |
+
+## 授权账号
+
+| 角色 | 用户名 | 备注 |
+|------|--------|------|
+| | | |
+
+## 明确禁止
+
+- [ ] 不得测试的目标：
+- [ ] 不得执行的操作：
+- [ ] 时间限制：
+- [ ] 速率限制：
+
+## 授权证明
+
+- 授权人：
+- 授权日期：
+- 授权范围描述：

package/bundled-skills/pentest-tools/references/templates/task_plan.md

@@ -0,0 +1,27 @@
+# 测试计划 (Task Plan)
+
+## 阶段概览
+
+| # | 阶段 | 状态 | 备注 |
+|---|------|------|------|
+| 1 | 信息收集 | 未开始 | |
+| 2 | 漏洞扫描 | 未开始 | |
+| 3 | Web 渗透 | 未开始 | |
+| 4 | 认证/授权测试 | 未开始 | |
+| 5 | 业务逻辑测试 | 未开始 | |
+| 6 | 后渗透 | 未开始 | |
+| 7 | 报告生成 | 未开始 | |
+
+## 当前阶段详情
+
+### 阶段 1：信息收集
+
+- [ ] 端口扫描
+- [ ] 子域名枚举
+- [ ] 目录发现
+- [ ] 技术栈识别
+- [ ] JS 文件分析
+
+## 下一步
+
+待开始。