blackbox-pentest

KO | EN

gitlite — search

#python #typescript #android #deep-learning #docker #nodejs #java #windows #awesome #cli #vue #ios #mcp #openai

blackbox-pentest

(★ 9)

Codex skill for authorized black-box penetration testing and bug bounty workflows.

blackbox-pentest Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# blackbox-pentest

> 只画边界，不教狩猎。

一个面向 ZCode / AI Agent 的授权黑盒渗透测试与 SRC 漏洞挖掘 Skill。它不向 AI 灌输固定测试清单、Payload、漏洞优先级或绕过方法，只定义测试边界、行为红线、无效成果和漏洞证据门槛，让 AI 根据目标反馈自主侦察、推理、验证与调整策略。

## 设计理念

AI 已具备足够强的安全知识。过多的方法论和固定决策树反而可能造成锚定、限制推理空间。这个 Skill 只回答四个问题：

1. **哪里不能去**：授权范围与 Scope。
2. **什么不能做**：破坏性、扩大化和不必要的数据访问。
3. **什么不是猎物**：没有独立、可复现实际影响的现象。
4. **什么才算捕获**：真实执行、能够复现并证明影响的完整因果链。

除此之外，AI 可以自主选择工具、Payload、编码、协议、测试顺序、绕过方式和验证策略。

## 核心特性

- **高自由度**：不提供固定漏洞清单或测试路线，不限制 AI 的技术思路。
- **范围约束**：只测试用户明确给出的资产及项目规则允许的关联资产。
- **非破坏性验证**：禁止 DoS、批量数据操作、持久化、横向扩散和不必要的影响扩大。
- **线索不丢弃**：CORS、开放重定向、信息泄露等弱现象可以继续参与利用链推理，但不能在没有实际影响时单独上报。
- **证据优先**：只有真实执行过、可复现且能直接证明影响的 PoC 才能形成已确认漏洞。
- **反幻觉**：禁止编造请求、响应、回显、PoC 或为了完成任务而虚构漏洞。
- **项目规则优先**：Scope、禁止事项、速率限制和评级均以具体 SRC / 测试项目规则为准。
- **门禁退出态落盘**：报告前 `scripts/check_state.py` 把真实退出态写入 `state/gates.json`，`blocking_count==0` 为唯一判据，机器写、不可空口"通过"。
- **有纪律的放行**：客观走不通的硬错误可在 `gates.json` 的 `acknowledged` 登记固定 `reason_code` + `note` 放行；卫生类错误必须修。
- **工作守则持久化**：用户测试中下发的补充规则写入 `state/config.json` 的 `work_guidelines`，不依赖对话记忆。
- **子代理体系（强制分工）**：主代理深度找资产、调度与验收；`blackbox-reviewer` 子代理逐端点独立测试（防锚定），高危漏洞上报前经**证伪式复核**（尝试推翻，验证稳定性与边界）；`blackbox-bypasser` 专项绕过 filtered 信号。调度 prompt 按固定模板组织。
- **时间盒与人工登录**：验证码/人机校验前置限时处理；图形验证码可半自动人工登录（浏览器人工识别），短信验证码属前置条件问题快速 blocked，防单点拖死全局。
- **会话隔离**：多子代理并行时按批次分配独立账号（根治）；单账号时破坏会话类接口只能探测型测；快照仅作文件卫生。
- **CVSS 高价值链挖掘**：评级按 CVSS v3.1 统一标尺；每个发现评估"链潜力"，主动追踪通向 RCE/数据全量/ATO/文件读写/管理面的链条，每环实测、按最终影响上报。
- **狩猎机制**：思考模型（终局←原语←升级←组合）、数据流追踪（响应即 Fuzz 字典）、信号表（信号只给方向不给结论）、客户端视角（前端能渲染=代码在手里）、单步成功后必须继续、防误报直觉——是思考框架与线索识别，不是固定测试路径（见 `references/hunting-mechanisms.md`）。
- **专项指南体系（按攻击面触发）**：SSRF 专项（回显四档/绕过六层/元数据族）、鉴权绕过专项（静态后缀/路径归一化/头部注入/指纹选择/判定标准）、业务逻辑专项（谁算五问/竞态五步/配额绑定断裂/流程边界）、认证链深化（JWT 实操/OAuth/MFA 绑定断裂/加密参数/生物认证）、非 SQL 注入专项（反序列化/SSTI/XXE 最小破坏验证链）、云存储四层权限与签名测试、链放大判据（原语分类/六维问句/三档优先级）、侦察分级（P0-P3/时间盒/环境实战）、第三方组件专项（组件≠普通库/CVE 核验）、客户端信任链（App/H5 形态触发）——均为机制与判据级，不规定 payload。
- **可选强化**：代理录制证据增强——环境具备时启用，不改变测试路径。

## 目录结构

```text
blackbox-pentest/
├── agents/
│   ├── blackbox-bypasser.md
│   ├── blackbox-reviewer.md
│   └── openai.yaml
├── scripts/
│   └── check_state.py
├── SKILL.md
└── references/
    ├── agent-prompt-template.md
    ├── auth-bypass-guide.md
    ├── auth-chain-guide.md
    ├── banned-patterns.md
    ├── business-logic-guide.md
    ├── client-trust-guide.md
    ├── coverage-checklist.md
    ├── coverage-guide.md
    ├── cvss-chain-guide.md
    ├── frontend-spa-routing-guide.md
    ├── hunting-mechanisms.md
    ├── js-deep-analysis-guide.md
    ├── junk-list.md
    ├── nonsqli-injection-guide.md
    ├── recon-guide.md
    ├── report-template.md
    ├── sqli-waf-bypass-guide.md
    ├── ssrf-guide.md
    ├── state-schemas.md
    ├── third-party-acl-guide.md
    └── third-party-component-guide.md
```

- [`SKILL.md`](SKILL.md)：核心原则、授权范围、行为红线和证据门槛（含深度挖掘与策略多样性、攻击面不止 HTTP 页面、执行纪律层、分工与子代理调度强制条款、时间盒与人工登录、会话隔离、测试收尾）。
- [`agents/blackbox-reviewer.md`](agents/blackbox-reviewer.md)：端点测试执行子代理——主代理找资产，它逐端点独立测试并写回 state；高危漏洞上报前由另一实例做**证伪式复核**（尝试推翻，验证稳定性与边界），安装到 `~/.zcode/agents/`。
- [`agents/blackbox-bypasser.md`](agents/blackbox-bypasser.md)：专项绕过子代理——对 filtered 信号做多族绕过，安装到 `~/.zcode/agents/`。
- [`agents/openai.yaml`](agents/openai.yaml)：Codex UI 元数据（ZCode 环境不使用，可忽略）。
- [`scripts/check_state.py`](scripts/check_state.py)：报告前校验状态文件并把真实退出态落盘 `state/gates.json`（含 acknowledged 放行机制）。
- [`references/banned-patterns.md`](references/banned-patterns.md)：测试行为和结论判定中禁止出现的模式（BP 详版唯一来源）。
- [`references/agent-prompt-template.md`](references/agent-prompt-template.md)：子代理调度 Prompt 模板（批量测试 / 专项绕过 / 高危复核三套，主代理调度时按此组织任务信息）。
- [`references/auth-bypass-guide.md`](references/auth-bypass-guide.md)：鉴权绕过专项（静态后缀/路径归一化/编码/大小写/方法/头部注入/协议降级/IP 编码等价类、按指纹选高命中族、baseline code+size+md5 判定标准、非破坏纪律）。
- [`references/auth-chain-guide.md`](references/auth-chain-guide.md)：认证链判据深化（JWT 六步+实操判定（密钥挖掘/4 组对比/claim 信任/hex 坑）/报错→原语映射/表述强度分级/OAuth 劫持五层/MFA 绑定断裂四测试/加密参数五策略/身份映射与归属落点/生物认证五判据/枚举多维度/注册参数输入面）。
- [`references/business-logic-guide.md`](references/business-logic-guide.md)：业务逻辑专项（谁算五问/状态机拆解三问/竞态五步检测法/配额绑定断裂四问/授权三问/流程边界/权限状态机跃迁与残留）。
- [`references/client-trust-guide.md`](references/client-trust-guide.md)：客户端信任链专项（DeepLink/WebView/JSBridge/本地存储/会话借用五边界、响应篡改泛化、CSRF 组合链、借谁的浏览器身份）——目标有 App/H5/多端时触发。
- [`references/coverage-checklist.md`](references/coverage-checklist.md)：输出前用于盘点覆盖状态的自问清单。
- [`references/coverage-guide.md`](references/coverage-guide.md)：正式报告输出前的覆盖度闸门（含门禁退出态与放行机制）。
- [`references/cvss-chain-guide.md`](references/cvss-chain-guide.md)：CVSS v3.1 快速评分标尺与高价值链挖掘指南（链节点类型、追踪流程、每环实测、示例链、链放大判据：原语分类/六维问句/三档优先级）。
- [`references/js-deep-analysis-guide.md`](references/js-deep-analysis-guide.md)：JS 深度信息收集（sourcemap 还原/混淆处理/调用模式与参数提取/敏感信息扫描 + 完整读取纪律（sourcemap→美化→AST）/按功能模块分块分析/JS 逻辑漏洞族/DOM XSS source→sink/运行时提取/完整请求签名）。
- [`references/frontend-spa-routing-guide.md`](references/frontend-spa-routing-guide.md)：前端 SPA 路由攻击面（路由数组定位/未加载路由枚举/浏览器访问隐藏页面/参数复用）。
- [`references/hunting-mechanisms.md`](references/hunting-mechanisms.md)：狩猎机制——思考模型（终局←原语←升级←组合）、数据流追踪（响应即 Fuzz 字典、ID 调用链即攻击链）、信号表（信号只给方向不给结论）、客户端视角（前端能渲染=代码在手里）、单步成功后必须继续、防误报直觉（系统生成值不是漏洞、公开数据里的隐藏 PII 是）。
- [`references/junk-list.md`](references/junk-list.md)：默认不能作为独立成果的发现；这些发现仍可作为线索继续组合。仅在报告阶段读取。
- [`references/nonsqli-injection-guide.md`](references/nonsqli-injection-guide.md)：非 SQL 注入专项（技术栈→攻击向量映射、统一最小破坏验证链、反序列化/SSTI/XXE）——与 SQLi 专项独立互补。
- [`references/recon-guide.md`](references/recon-guide.md)：侦察决策层（P0-P3 资产分级、30% 时间盒、发现≠成果、边缘资产切入顺序、技术栈指纹、分流规则）。
- [`references/report-template.md`](references/report-template.md)：以因果链和可复核证据为中心的漏洞报告模板。
- [`references/sqli-waf-bypass-guide.md`](references/sqli-waf-bypass-guide.md)：SQL 注入检测与 WAF 绕过专项（注入点识别/类型判定/DB 指纹/语义破坏测试 + WAF 指纹识别/针对性绕过/验证闭环）。
- [`references/ssrf-guide.md`](references/ssrf-guide.md)：SSRF 专项（入口分级、回显四档、标准验证顺序、绕过六层、元数据端点族、流程阶段绕过、放大边界）。
- [`references/state-schemas.md`](references/state-schemas.md)：状态文件结构定义唯一权威（含枚举映射表、未开展 vs not_found 约定、放行机制）。
- [`references/third-party-acl-guide.md`](references/third-party-acl-guide.md)：第三方服务与 ACL 配置错误专项（技术栈识别、暴露面检测、实际权限 vs 预期权限验证、最小查询红线、云存储四层权限与签名四轮测试、STS 角色链、控制面/资源面二分）。
- [`references/third-party-component-guide.md`](references/third-party-component-guide.md)：第三方平台级组件专项（OnlyOffice/CKEditor/TinyMCE/draw.io/Grafana 等——组件≠普通库、指纹表机制、每组件必产出清单、CVE 核验纪律（NVD 复核）、攻击面方向）。

## 安装

克隆到 ZCode Skills 目录：

```bash
git clone https://github.com/yanglittlecat/blackbox-pentest.git \
  "${ZCODE_HOME:-$HOME/.zcode}/skills/blackbox-pentest"
```

更新已安装版本：

```bash
git -C "${ZCODE_HOME:-$HOME/.zcode}/skills/blackbox-pentest" pull
```

安装子代理（ZCode 需注册到 `~/.zcode/agents/`）：

```bash
cp ~/.zcode/skills/blackbox-pentest/agents/blackbox-reviewer.md \
   ~/.zcode/skills/blackbox-pentest/agents/blackbox-bypasser.md \
   ~/.zcode/agents/
```

> 子代理安装后需**重启 ZCode / 新开会话**才会被扫描注册生效。

安装后，当用户提出授权黑盒渗透、SRC 挖洞、bug bounty、pentest、recon、越权、SSRF、注入、未授权访问、上传绕过、漏洞验证或漏洞报告等任务时，ZCode 可自动触发该 Skill。

## 使用示例

```text
使用 blackbox-pentest 对 https://example.com 进行授权黑盒安全评估。
Scope 仅包含 example.com 和 api.example.com；禁止压力测试和影响真实用户。
请自主选择测试路径，只汇报有真实 PoC 和影响证据的发现。
```

也可以直接提供授权目标与项目边界，AI 会自行选择后续侦察和验证策略。

## 什么算“已确认漏洞”

一个发现至少需要同时满足：

- 所有关键动作和受影响资产都在授权范围内；
- 缺陷、可控条件、触发过程与最终影响之间具有清晰因果关系；
- PoC 已真实执行，而不是静态匹配、猜测或未运行的示例；
- 请求、响应、回显或状态差异足以供第三方复核；
- 证据直接支持机密性、完整性或可用性影响；
- 严重级别遵循目标项目的评级规则并有明确依据。

未达到门槛的内容应标记为“线索”或“未确认”，不能包装成漏洞报告。

## 安全边界

本 Skill 仅用于已获授权的安全评估、SRC 漏洞赏金、自有资产测试或正式渗透测试项目。使用者应遵守目标项目的 Scope、测试规则、法律法规和数据最小化原则。

核心原则：**用最小动作证明真实影响，证据成立后立即停止扩大。**

blackbox-pentest

blackbox-pentest Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

blackbox-pentest

blackbox-pentest Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README