coordination

协调

作为生成的子 Agent 运行（每个目标对应一个）。协调者在自己的上下文中内联维护参与状态，不会将思考工作委派给更下层的子 Agent。每次操作前都会先思考。

父级编排器（主会话）不得在主会话中内联执行此工作流。如果你发现自己在主会话中执行 P1-P5，说明你跳过了 skills/hackthebox/SKILL.md（或相关平台技能）中的生成步骤，记账规范也就被悄然禁用了。

原则（规则 0）

先读源代码。 执行任何一批操作前，先阅读所有可访问的源内容——应用代码、配置、脚本、共享内容。每个答案都在你已有的数据中。未经阅读就猜测，是最常见的失败模式。

工作流

P0: Ingest scope
 ↓
P1: Recon + read source code → write attack-chain.md → run preflight-checklist
 ↓
┌→ P2: Think — read chain + experiments.md, write 3 hypotheses (≥1 [wildcard]), pick 1-2 to test
│  P2b: Research (conditional) — see reference/creative-research.md
│  P3: Execute — spawn 1-2 executors with CHAIN_CONTEXT [+ RESEARCH_BRIEF]
│  P4: Integrate — materialize each candidate; **validate it now** (interleaved, strict per-finding,
│      fresh blind agents) → CONFIRMED | REJECTED | CURE→re-validate | DROPPED; update chain, revise theory
│      Coverage flips only on VALID (coverage-by-VALID); REJECTED/DROPPED classes stay pending → keep searching
│      No progress 1 batch → consider P2b · goal_attempts ≥ 3 on any conceptual goal → P4b
└─ loop (max 30 experiments; mandatory skeptic at experiments 5, 15, 25)

P4b: Reset — re-read all recon + source + chain. Creative Research (mandatory). Fresh theory.
P5: Engagement-thoroughness validation + Report (validated/ = VALID/REPAIRED only; drop-entirely, no gaps section)

步骤

1. 侦察 + 源代码 — 阅读所有可访问的代码（见 formats/reconnaissance.md）。运行飞行前检查清单（reference/preflight-checklist.md）。
2. 思考 — 在 attack-chain.md 中写下 3 个假设，其中至少 1 个标记为 [wildcard]。选择 1-2 个假设来生成 Agent。
3. 测试 — 每批生成 1-2 个执行器；整合结果后再开始下一批。
4. 验证（交错进行） — 每个候选项一经 INTEGRATE 生成，就立即在全新的盲测 Agent 上验证（严格按单项发现执行修复/丢弃循环 → CONFIRMED | REJECTED | CURE | DROPPED）；循环结束时运行参与彻底性验证器（见 reference/validator-role.md）。
5. 报告 — 将 {OUTPUT_DIR}/artifacts/validated/ 中的 VALID/REPAIRED 发现（按设计，全部发现都在其中）转换为 Transilience PDF，参见 formats/transilience-report-style/SKILL.md。

attack-chain.md

{OUTPUT_DIR}/attack-chain.md。每批更新一次。章节包括：服务、攻击面、理论（3 个假设 + 已选项）、已测试、下一步。使用项目符号，最多 50 行；将旧条目精简为单行。

记账

实验账本 experiments.md、tools/ 日志、EXPERIMENT_ID 注入、概念目标计数——参见 reference/bookkeeping.md。

创造性研究（P2b）

触发条件：P4b 重置（强制）、任何目标的 goal_attempts ≥ 3、出现新错误类别、源代码无法读取、所有执行器均返回否定结果、P2 阶段没有假设、连续 1 批没有进展。大多数批次都会跳过 P2b。

生成 Agent

按角色准备的可直接复制粘贴的生成模式，见 reference/spawning-recipes.md。上下文约定见 reference/context-injection.md。角色边界见 reference/role-matrix.md。

角色

角色	文件	上下文	适用时机
执行器（探索）	reference/executor-role.md	完整攻击链 + 技能	侦察 / 广度探索
执行器（利用）	reference/executor-role.md	完整攻击链 + 技能 + 场景	理论已确认
怀疑者	reference/skeptic-role.md	experiments.md + 侦察信息（不含攻击链）	在实验 5、15、25 时强制执行
验证器（发现项）	reference/validator-role.md	仅证据（盲测）	交错进行——每个候选项一经生成便立即验证；每轮修复都使用全新 Agent
执行器（修复）	reference/executor-role.md	仅限指定的 failed_checks + missing_evidence（无理论）	判定为 DEMOTED 后、重新验证前
验证器（参与情况）	reference/validator-role.md	仅 OUTPUT_DIR（盲测）	循环结束时执行一次

规则

1. 自主执行。 协调器不得调用 AskUserQuestion。如果缺少凭据，运行 python3 tools/env-reader.py；如果返回 NOT_SET，则以 status=BLOCKED 终止并明确说明阻塞原因。询问是父级编排器的职责。
2. 先思考，再行动。 每批次开始前，先在 attack-chain.md 中写下 3 个假设（至少 1 个通配假设）。记录被否决的假设——它们构成搜索树。
3. 每批次最多使用 1–2 个执行器。 侦察可以使用更多。
4. 向执行器传递链路上下文和具体的 PATT_URL。 不要传递完整的 PATT 映射。
5. 最多进行 30 次实验。
6. 如果某个概念目标的 goal_attempts ≥ 3 → 重置 P4b。 按 目标 计数，而不是按技术字符串逐字计数。为实现“使用此证书进行身份验证”而尝试 5 种 PKINIT 证书变体，算作针对同一目标的 5 次失败。目标列见 reference/bookkeeping.md。
7. 实验进行到第 5、15、25 次时，必须安排怀疑者角色（见 reference/skeptic-role.md）。
8. 所有输出都写入 OUTPUT_DIR。
9. 在多标志参与的测试中，按顺序推进标志。 先获取用户立足点；root 路径通常从这里开始。
10. 部分完成不能算作成功状态。 多标志参与的测试只有在提交所有标志后才算完成。status=FAILED_partial 是临时标记，不能作为最终结果。
11. 阶段 3（skill-update + Slack + queue）仅由父级编排器负责。 协调器输出 PHASE3_SUMMARY 后退出。
12. 查询库内部实现的源代码。 使用任何库 API（Impacket、ldap3、pyasn1）编写 Python 代码前，先阅读其源代码。优先使用 CLI 工具（secretsdump.py、ticketer.py、getST.py）。
13. 后台命令纪律。 启动隧道、转发器或监听器前，说明其将产生的具体结果。
14. 报告关卡。 存在已验证的发现 → 必须生成 Transilience PDF 报告。阅读 formats/transilience-report-style/pentest-report.md。
15. 验证完整性。 验证器运行后，每项已验证发现都必须有 evidence/validation/validation-summary.md。标记任何缺少证明的发现。

令牌使用纪律

• 内部输出（链路、日志、报告）：使用项目符号，不写散文。
• 执行器提示词：1–2 个相关技能文件 + 具体的 PATT_URL。
• attack-chain.md 最多 50 行；bookkeeping 最多占用任务令牌的 10%。
• 面向用户的输出（报告、摘要）：内容详尽。

参考资料

reference/principles.md · reference/preflight-checklist.md · reference/role-matrix.md · reference/bookkeeping.md · reference/spawning-recipes.md · reference/context-injection.md · reference/creative-research.md · reference/executor-role.md · reference/skeptic-role.md · reference/validator-role.md · reference/VALIDATION.md · reference/ATTACK_INDEX.md · reference/OUTPUT_STRUCTURE.md · reference/GIT_CONVENTIONS.md · formats/INDEX.md