agentic-flow-kit 1.3.0 → 1.5.0

package/modules/hosts/claude/commands/wf-review.md

@@ -9,7 +9,7 @@ description: 代码评审标准（按风险分级：机器兜底 + AI 自查出
 > 参考 Anthropic REVIEW.md 做法。宗旨是**用户决策 + AI 协作**：AI 跑机器门禁、自查、出分级清单与建议；用户确认问题定性与合入。把"该机器兜底"与"靠 AI 自查"分开列明，避免注意力耗在机械逐行上。
 > 本文件为通用骨架;项目专属红线 / 命名 / 组件约定的具体口径在项目适配区（目录级 `AGENTS.md` 与 `.agents/hooks/`）补充。
 
-## P0 必拦（优先机器兜底，hook 覆盖不到的靠 AI 自查）
+## 1. P0 必拦（优先机器兜底，hook 覆盖不到的靠 AI 自查）
 
 - **架构红线**：分层依赖方向约束(如领域 / 应用层禁直接引用基础设施实现;豁免清单见目录级 `AGENTS.md` / 项目适配区)
   - 机器兜底：项目自有架构门禁(如有,`.agents/hooks/`)
@@ -21,7 +21,7 @@ description: 代码评审标准（按风险分级：机器兜底 + AI 自查出
   - 机器兜底：项目验证测试覆盖(如有) + AI 自查
 - **L2 / L3 改动无 spec**：拒收，先回 `workflow/specs/` 立 spec 确认通过
 
-## P1 应拦（自查重点）
+## 2. P1 应拦（自查重点）
 
 - **DB 命名与迁移**：遵循项目表 / 字段 / 外键命名规范与 schema 变更流程(见目录级 `AGENTS.md`);不得擅自引入项目未采用的迁移机制
 - **前端形态**：新增 / 编辑与大数据量选择等交互遵循项目组件约定(弹层 vs 跳页、选择器形态、表格与样式统一等)
@@ -34,14 +34,14 @@ description: 代码评审标准（按风险分级：机器兜底 + AI 自查出
 - **spec 承诺的断言落地**：spec §测试列出的用例 / 断言须真落到测试或验证脚本；「写进 spec」不等于「跑得起来」，且常驻断言禁写成随时间增长的行数常量
 - **跨宿主薄适配正文漂移**：改 `templates/_agents/{commands,roles}/*.md` 后必须跑 `flow-kit sync-hosts --apply` 单向同步注册表内全部宿主薄适配（`modules/hosts/<h>/{agents,commands}/*.md`）；装户视角由 `flow-kit doctor` §6.7 检查（包源环境 §6.7 skipped）
 
-## P2 建议（提醒，不拦合入）
+## 3. P2 建议（提醒，不拦合入）
 
 - 样式统一性（深色 / 浅色主题、卡片样式）
 - 注释完整性（复杂逻辑处补注释，AGENTS.md 已说的不重复）
 - Conventional Commits 中文（feat / fix / docs / style / refactor / perf）
 - 历史同类 incident 的复盘三件套是否补齐
 
-## 审查分工（用户决策 + AI 协作）
+## 4. 审查分工（用户决策 + AI 协作）
 
 - **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
 - **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法参考 `code-review` 技能（Standards×Spec 双轴）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。

package/modules/hosts/claude/commands/wf-source-sync-check.md

@@ -9,16 +9,16 @@ description: 装户面同步一致性检查（包源 templates/_agents/ vs 装
 > `templates/_agents/` 包源 vs `.agents/` 装副本——三类差异报告：缺失 / 孤儿 / 漂移。
 > managed 文件由 `flow-kit sync` 跟踪；owned 文件由 `flow-kit doctor` §6.6 校验——本工具补"两者都没扫"的真空地带（结构级差异）。
 
-## 何时跑
+## 1. 何时跑
 
 - 改 `templates/_agents/*` 包源后
 - 怀疑装副本未跟包源更新
 - 体检装副本完整性（清理前 / 发版前）
 - 不跑：仅改装副本 `.agents/*`（B-b 决策「只报告」+ 不反向同步）
 
-## 怎么跑
+## 2. 怎么跑
 
-### 默认 `--diff`（仅报告）
+### 2.1 默认 `--diff`（仅报告）
 
 ```
 node .agents/scripts/source-sync-check.mjs --diff
@@ -35,7 +35,7 @@ node .agents/scripts/source-sync-check.mjs --pkg-root <path> --target <path>   #
 - `templates/_agents/cache/`（运行时缓存，与 `flow-kit sync` 既有约定一致）
 - `.agents/kit.json` / `.agents/settings.json`（init 渲染产物，不属双源）
 
-### 输出示例
+### 2.2 输出示例
 
 ```
 ▶ flow-kit source-sync-check --diff
@@ -50,7 +50,7 @@ node .agents/scripts/source-sync-check.mjs --pkg-root <path> --target <path>   #
     - scripts/ensure-board.mjs  pkg=e66653b0…  tgt=b6f3cc9b…
 ```
 
-### 自验
+### 2.3 自验
 
 ```
 node .agents/scripts/source-sync-check.test.mjs   # 11 场景全过
@@ -58,7 +58,7 @@ npm test                                            # 含 source-sync-check 套
 flow-kit doctor                                     # 10/0/0
 ```
 
-## 边界（不要做）
+## 3. 边界（不要做）
 
 - 不要自动化同步（B-b 决策「只报告不修复」——与 `gate-checklist` 同源）
 - 不改 managed 台账跟踪逻辑（`sync.mjs` 不动）
@@ -66,7 +66,7 @@ flow-kit doctor                                     # 10/0/0
 - 不反向同步——装副本独自有文件（如 hooks/commit-check.config.json）可能是装户配置，不应被删
 - 不检查注册表内宿主 `modules/hosts/` 薄适配漂移（那是 `flow-kit sync-hosts` 范围）
 
-## 当前已识别的真实漂点（首次实测，2026-09-25）
+## 4. 当前已识别的真实漂点（首次实测，2026-09-25）
 
 - **缺失**：本工具写完后未同步装副本（预期内——随本次 commit 解决）
 - **孤儿**：`.agents/hooks/commit-check.config.json`（装副本独有，疑似装户配置）
@@ -74,7 +74,7 @@ flow-kit doctor                                     # 10/0/0
 
 修复留后续 incident / intent 跟踪（不在本次范围）。
 
-## 与既有工具的关系
+## 5. 与既有工具的关系
 
 | 工具 | 作用域 | 算法 |
 |---|---|---|
@@ -84,8 +84,8 @@ flow-kit doctor                                     # 10/0/0
 
 三者互补，不重叠。
 
-## 相关留痕
+## 6. 相关留痕
 
 - intent：`workflow/intents/2026-09-25-source-sync-check.md`
 - plan：`workflow/plans/2026-09-25-source-sync-check.md`
-- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（包源改了装副本未同步——本工具预防性体检）
+- 父 incident：`workflow/incidents/2026-09-25-wf-runtime.md`（包源改了装副本未同步——本工具预防性体检）

package/modules/hosts/claude/commands/wf-sync-hosts.md

@@ -12,16 +12,16 @@ description: 跨宿主适配层同步（正文段 sha 比对 + 用户拍板 +
 > 比 `templates/_agents` ↔ `modules/hosts/<宿主键>/`；含 `.agents` → 装户：比 `.agents` ↔ 项目根下 `<宿主点目录>/`），
 > 目标根取 `--dir <目录>` > 当前目录。
 
-## 何时跑
+## 1. 何时跑
 
 - 改 `templates/_agents/commands/*.md` 正文后（11 个 commands 文件）
 - 改 `templates/_agents/roles/*.md` 正文后（3 个 roles 文件）
 - 装户跑 `flow-kit doctor` 报"跨宿主薄适配正文漂移 N 对" WARN 时
 - 不跑：仅改 frontmatter；改 trae 钩子/规则；改包源其他文件
 
-## 怎么跑
+## 2. 怎么跑
 
-### 默认 `--diff`（仅报告）
+### 2.1 默认 `--diff`（仅报告）
 
 ```
 node bin/flow-kit.mjs sync-hosts --diff      # 包源仓（在包源根跑）
@@ -35,7 +35,7 @@ flow-kit sync-hosts --diff                   # 装户仓（在装户根跑；或
 - **⚠️ 权威源声明但薄适配缺失** — `add-host <h>` 接管后跑 `--apply` 才会装（apply 不自动创建）
 - **⚠️ 孤儿薄适配（权威源无对应文件）** — 历史残留或宿主特化，apply 不删
 
-### `--apply` 单向同步
+### 2.2 `--apply` 单向同步
 
 ```
 node bin/flow-kit.mjs sync-hosts --apply
@@ -43,7 +43,7 @@ node bin/flow-kit.mjs sync-hosts --apply
 
 按权威源正文覆盖薄适配正文段；薄适配原 frontmatter 保留（trae name: wf-X、opencode 描述、zcode/omp 中文风格各自不动）。apply 不反向同步——薄适配手改了正文也会被覆盖（这是设计选择，避免漂移方向歧义）。
 
-### 自验
+### 2.3 自验
 
 ```
 npm test                                       # 含 sync-hosts.test.mjs 8 场景
@@ -51,7 +51,7 @@ node bin/flow-kit.mjs doctor                   # 装户跑 §7.x PASS；包源
 sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已探测分流
 ```
 
-## 边界（不要做）
+## 3. 边界（不要做）
 
 - 不要 `--apply` 反向同步（写权威源）：权威源是真相，薄适配手改会被覆盖——这是设计，apply 前先看 `--diff`
 - 不要删除孤儿薄适配：可能是宿主特化或历史残留，apply 不动
@@ -59,14 +59,14 @@ sh .agents/scripts/check-loop.sh                # Windows 无 sh 时 doctor 已
 - 不要把「避免与权威版本漂移」明文加回去——这是旧契约的指针风格，已被 B-b 正文副本取代
 - 装了新宿主后跑 `--apply`：新宿主目录空白，apply 不会自动创建薄适配（薄适配须经 `add-host <h>` 接管）
 
-## 不在本次同步范围
+## 4. 不在本次同步范围
 
 - trae 钩子（`modules/hosts/trae/hooks/*.cjs`）— 独立演进的工程件
 - trae 规则（`modules/hosts/trae/rules/*.md`）— 同上
 - 包源 .agents/scripts/*.cjs（pre-commit 等钩子）— 同步由 `flow-kit sync` 走 managed 台账负责
 
-## 相关留痕
+## 5. 相关留痕
 
 - intent：`workflow/intents/2026-09-25-cross-host-sync.md`
 - plan：`workflow/plans/2026-09-25-cross-host-sync.md`（含 B-b 方案拍板）
-- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）
+- incident：`workflow/incidents/2026-09-25-wf-runtime.md`（双源纪律教训，规范 §7.x 包源环境跳过）

package/modules/hosts/claude/commands/wf-test.md

@@ -46,20 +46,19 @@ node bin/flow-kit.mjs doctor                       # §6.5 delegations + §6.6 o
 - 复核者读入口文档(intent / incident) + spec + plan + diff,判断变更意图与风险
 - 复核意见交用户定性(采纳 / 驳回);采纳项回 `build.md` 修改
 
-## 子代理调用约定
+## 5. 子代理调用约定
 
 - 静态门不委派;UI 实测委派 `ui-verifier`(静态门通过后)、独立复核委派 `independent-reviewer`,均要求读取对应 `.agents/roles/*.md`;宿主不支持时按 frontmatter `fallback`(reviewer 必须另开新会话,不得主智能体自查冒充)。
 - 子智能体只返回证据与结论——失败项修复仍回 `build.md`,不得在 Test 阶段顺手改代码;修复后重跑本阶段,全过后用户确认再关单。
 
-## 确认后
+## 6. 确认后（关单）
 
-- 输出测试报告(通过项 / 失败项)
-- 失败项已修复并复测通过
+- 输出测试报告(通过项 / 失败项);失败项已修复并复测通过。
 - **关单**（日常闭环点，不依赖是否上 prod）:
-  - 关单前一键过门：`node .agents/scripts/verify.mjs`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定（2026-10-07 papercut）
-  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent $\rightarrow$ done；同名 spec/Quick-Plan（若有）仍 approved $\rightarrow$ done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
+  - 关单前一键过门：`node .agents/scripts/verify.mjs --doc workflow/intents/<本单>.md`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）；**`--doc` 把测试绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 对账只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**装户仓**（根目录无 `package.json`，工程在子目录）默认 `npm test` 不可跑 → 脚本**显式跳过步骤 1 且不落测试绿凭证**（防假绿）并提示；此时按项目口径手工跑测试，或带 `--test-cmd "<项目测试命令>"` 指定（2026-10-07 papercut）
+  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent → done；同名 spec/Quick-Plan（若有）仍 approved → done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
   - **approved 留痕提交**（2026-09-30 起）：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——**关单编辑（勾验/回填确认结果）先于 done 确认、confirm-doc 是最后一次写入**，此后修订走 superseded 或新 intent。
+  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件+逐件原话 / done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
   - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
   - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）

package/modules/hosts/codex/agents/implementer.md

@@ -6,7 +6,7 @@ description: 公共契约见 .agents/roles/implementer.md
 
 > 公共角色契约（本文件）：`.agents/roles/implementer.md`。宿主薄适配（各宿主目录下 `agents/implementer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
-## 职责
+## 1. 职责
 
 执行已经由主智能体和用户确认、范围明确的实现任务。适用范围仅限：
 
@@ -15,7 +15,7 @@ description: 公共契约见 .agents/roles/implementer.md
 - 编写或调整任务直接要求的测试
 - 修复与任务直接相关的编译错误
 
-## 必需输入
+## 2. 必需输入
 
 开始前必须获得：
 
@@ -26,7 +26,7 @@ description: 公共契约见 .agents/roles/implementer.md
 
 任一输入缺失或相互冲突时，停止并向主智能体报告，不自行扩大范围。
 
-## 行为边界
+## 3. 行为边界
 
 - 只修改明确授权的文件；若必须触及其他文件，先停止并说明原因。
 - 仓库可能有其他智能体或用户同时工作；保留现有改动，不回退、不覆盖无关修改。
@@ -35,13 +35,13 @@ description: 公共契约见 .agents/roles/implementer.md
 - 不执行提交、推送、发布、数据迁移或破坏性操作。
 - 不顺手重构、格式化或清理与任务无关的代码。
 
-## 验证
+## 4. 验证
 
 - 运行任务指定的最小相关检查。
 - 检查失败时只修复由本次改动引起且仍在授权范围内的问题。
 - 同一验证连续失败三次，或继续需要猜测需求时，停止并报告阻塞。
 
-## 输出
+## 5. 输出
 
 返回给主智能体：
 
@@ -49,4 +49,3 @@ description: 公共契约见 .agents/roles/implementer.md
 2. 每个文件的改动摘要
 3. 已运行的验证及结果
 4. 未解决的阻塞或剩余风险
-

package/modules/hosts/codex/agents/independent-reviewer.md

@@ -6,11 +6,11 @@ description: 公共契约见 .agents/roles/independent-reviewer.md
 
 > 公共角色契约（本文件）：`.agents/roles/independent-reviewer.md`。宿主薄适配（各宿主目录下 `agents/independent-reviewer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
-## 职责
+## 1. 职责
 
 在独立上下文中对 spec、plan 或代码 diff 做只读复核，发现原作者可能遗漏的正确性、契约、架构、数据安全和回归风险。
 
-## 必需输入
+## 2. 必需输入
 
 开始前必须获得：
 
@@ -21,7 +21,7 @@ description: 公共契约见 .agents/roles/independent-reviewer.md
 
 输入不足以确定范围时，停止并向主智能体报告。
 
-## 行为边界
+## 3. 行为边界
 
 - 只读，不修改任何仓库文件。
 - 不替用户决定问题定性、方案取舍、合入或上线。
@@ -30,7 +30,7 @@ description: 公共契约见 .agents/roles/independent-reviewer.md
 - 不把样式偏好、假设性风险或既有无关问题包装成缺陷。
 - 无法验证的事项明确标为未验证，不声称已经通过。
 
-## 复核重点
+## 4. 复核重点
 
 1. 实现是否满足入口文档和验收标准
 2. 是否违反根 `AGENTS.md` 与改动域目录级 `AGENTS.md` 的架构、数据和所在域红线
@@ -38,7 +38,7 @@ description: 公共契约见 .agents/roles/independent-reviewer.md
 4. 是否缺少能防止回归的验证
 5. 是否存在数据丢失、安全、权限或发布风险
 
-## 输出
+## 5. 输出
 
 按严重度输出问题清单：
 
@@ -46,4 +46,4 @@ description: 公共契约见 .agents/roles/independent-reviewer.md
 - `P1`：功能错误、明确回归或违反项目硬约束
 - `P2`：非阻断但有证据的维护性问题
 
-每项必须包含：位置、问题、证据、建议。没有发现时明确输出“未发现阻断问题”，并列出未验证范围。
+每项必须包含：位置、问题、证据、建议。没有发现时明确输出"未发现阻断问题"，并列出未验证范围。

package/modules/hosts/codex/agents/ui-verifier.md

@@ -6,11 +6,11 @@ description: 公共契约见 .agents/roles/ui-verifier.md
 
 > 公共角色契约（本文件）：`.agents/roles/ui-verifier.md`。宿主薄适配（各宿主目录下 `agents/ui-verifier.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
 
-## 职责
+## 1. 职责
 
 对已经实现的 UI 改动执行浏览器实测并收集可复核证据。只验证，不修复。
 
-## 必需输入
+## 2. 必需输入
 
 开始前必须获得：
 
@@ -21,7 +21,7 @@ description: 公共契约见 .agents/roles/ui-verifier.md
 
 缺少可观察的预期结果时，停止并向主智能体报告。
 
-## 执行
+## 3. 执行
 
 1. 读取项目根目录 `AGENTS.md`，以及改动域目录级 `AGENTS.md`（如有，前端改动域）。
 2. 读取并遵循项目 UI 实测技能 `.agents/skills/verify-ui/SKILL.md`（如有）。
@@ -30,14 +30,14 @@ description: 公共契约见 .agents/roles/ui-verifier.md
 5. 收集控制台、网络请求、DOM 数据或截图等证据。
 6. 结束时关闭本次启动的后台进程。
 
-## 行为边界
+## 4. 行为边界
 
 - 不修改代码、配置、测试数据或工作流文档。
 - 不自行修复发现的问题；将失败证据交还主智能体。
 - 不使用生产环境或真实业务数据。
 - 无法启动环境或完成关键路径时，报告阻塞，不把部分验证标记为通过。
 
-## 输出
+## 5. 输出
 
 返回：
 

package/modules/hosts/codex/commands/wf-build.md

@@ -8,20 +8,20 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 
 > AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
 
-## 执行
+## 1. 执行
 
-### 起草 plan
+### 1.1 起草 plan
 
-1. 确认同名入口文档（approved intent 或已确认的 incident）+ spec（若 L2/L3）均已确认；否则回上一阶段（fill/confirm 未过即拒）
+1. 确认同名入口文档（approved intent 或已确认的 incident）+ spec（若 L2/L3）均已确认；否则回上一阶段（fill/confirm 未过即拒）。
 2. 起草 plan:
    - 复制 `workflow/plans/_TEMPLATE.md` → `workflow/plans/YYYY-MM-DD-<主题>.md`(与入口文档同名)
    - L2/L3 按 4 节填写:改动方案 / 任务拆解(每个任务有判据) / 执行顺序 / 验证计划（与 fill-plan.mjs 单源一致）
    - L1 使用 Quick-Plan 极简三节:改动方案 / 约束与风险(原 Spec 核心) / 验证计划；多文件多步骤时可补任务拆解/执行顺序
-3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——关单编辑（勾验/回填）先于 done 确认、confirm-doc 是最后一次写入，此后修订走 superseded 或新 intent。
-4. 确认后 → plan 状态 draft → approved,并在 plan 内补「确认与复核」节(确认结果 + 日期)。确认环节须在文档留痕:`approved` 是确认的机器可见态,`done` 只在关单出现,禁从 `draft` 直跳 `done`;确认后立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
+3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28。
+   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 一次一份多份并录被拒 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
+4. 确认后 → plan 状态 draft → approved,并在 plan 内补「确认与复核」节(确认结果 + 日期)。确认环节须在文档留痕:`approved` 是确认的机器可见态,`done` 只在关单出现,禁从 `draft` 直跳 `done`;确认后立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)。
 
-### 进计划模式列改动
+### 1.2 进计划模式列改动
 
 5. **不要直接动代码**。先进「计划模式」:
    - **先拉同模块历史坑**：按入口文档 `模块:` 跑 `node .agents/scripts/kb-search.mjs --scope workflow --module <token> "<关键词>"`——命中 incident 的根因 / 防复发条目列入改动自查
@@ -29,38 +29,38 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
    - 列步骤(改 X 文件做 Y → 改 Z 文件做 W)
    - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（见 incidents/2026-09-25-wf-runtime 复盘）
    - 标注触达红线(对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）)
-6. 停下,等用户确认改动清单
+6. 停下,等用户确认改动清单。
 
-### 实现
+### 1.3 实现
 
-7. 确认后按 plan 顺序推进;每个任务对照判据自验。若任务满足 `.agents/roles/implementer.md` 的边界,主智能体可将单个工作包连同必读材料、授权文件和验收条件委派给 `implementer`;否则由主智能体执行
-8. 自验:按改动域跑 `项目构建命令` / `项目类型检查命令` / `项目测试命令`(对应编译 / 前端类型检查 / 自动化测试;静态门全集见 `test.md` §1)
-9. **项目架构红线**:数据访问模式、公共字段写入等以根与目录级 `AGENTS.md`(如有)红线为准,不自创旁路
-10. **L3 且含 schema 变更时**:schema 变更走项目约定的维护方式(人工 SQL / 迁移工具,以目录级 `AGENTS.md` 或 spec 约束为准),不得擅自引入项目未采用的迁移机制（仅运行时 / 管线类 L3 无此约束）
-11. 实现中若需偏离已确认的 plan(改公共接口 / 动 plan 未列文件 / 引新依赖 / 影响任务判据)→ 停下,向用户说明原因与影响,确认后再继续
+7. 确认后按 plan 顺序推进;每个任务对照判据自验。若任务满足 `.agents/roles/implementer.md` 的边界,主智能体可将单个工作包连同必读材料、授权文件和验收条件委派给 `implementer`;否则由主智能体执行。
+8. 自验:按改动域跑 `项目构建命令` / `项目类型检查命令` / `项目测试命令`(对应编译 / 前端类型检查 / 自动化测试;静态门全集见 `test.md` §1)。
+9. **项目架构红线**:数据访问模式、公共字段写入等以根与目录级 `AGENTS.md`(如有)红线为准,不自创旁路。
+10. **L3 且含 schema 变更时**:schema 变更走项目约定的维护方式(人工 SQL / 迁移工具,以目录级 `AGENTS.md` 或 spec 约束为准),不得擅自引入项目未采用的迁移机制（仅运行时 / 管线类 L3 无此约束）。
+11. 实现中若需偏离已确认的 plan(改公共接口 / 动 plan 未列文件 / 引新依赖 / 影响任务判据)→ 停下,向用户说明原因与影响,确认后再继续。
 
-## 技能辅助(可选,宿主级 skills)
+## 2. 技能辅助(可选,宿主级 skills)
 
 - plan 任务多、依赖复杂时:用 `to-tickets` 拆 tracer-bullet 任务单(每张带阻塞边);结果回填 plan「任务拆解」节,不发布外部 tracker
 - 后端逻辑改动:有测试基建的用 `tdd` 测试先行(红→绿→重构);整体实现纪律可用 `implement` 驱动
 - 遇合并冲突:用 `resolving-merge-conflicts` 按意图逐 hunk 处理
 - 技能不改变两道确认门、红线检查与委派边界
 
-## 红线提示(本阶段高频踩)
+## 3. 红线提示(本阶段高频踩)
 
 - 红线(架构 / 数据 / 安全等)正文与豁免见根与目录级 `AGENTS.md`(如有)——已由 pre-commit 机器门强制的部分以钩子为准，写代码前先过一遍目录级 AGENTS
 
-## 改权威源后必跑（薄适配同步防漏）
+## 4. 改权威源后必跑（薄适配同步防漏）
 
 - 改 `templates/_agents/{commands,roles}/*.md` 正文后跑 `node bin/flow-kit.mjs sync-hosts --diff` → 拍板 → `--apply` 单向同步（只动正文段，frontmatter 不动）；口径与边界详见 `.agents/commands/sync-hosts.md`
 
-## 改 doctor / check-loop 后必跑（三处口径对账）
+## 5. 改 doctor / check-loop 后必跑（三处口径对账）
 
 - 改 `src/doctor.mjs` 加新 § 检查项 → 跑 `node .agents/scripts/gate-checklist.mjs --diff` 看 doctor ↔ check-loop 对照表
 - 改 `.agents/scripts/check-loop.sh` 加新 § 检查项 → 同上
 - 任一处有而另一边无 → 工具报"缺点"，由用户拍板是否补齐（不自动同步，B-b 决策）；详见 `.agents/commands/gate-checklist.md`
 
-## 改包源后必跑（装户面同步一致性）
+## 6. 改包源后必跑（装户面同步一致性）
 
 - 改 `templates/_agents/*` 包源后 → 跑 `node .agents/scripts/source-sync-check.mjs --diff` 看装副本 `.agents/` 是否同步（缺失 / 孤儿 / 漂移三类差异）
 - 漂移说明包源改了装副本未跟；缺失说明新增文件 init 未执行；孤儿说明装副本独有（可能是装户配置，不删）
@@ -68,13 +68,13 @@ description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码
 - 门禁边界（pre-commit 双源一致性）：比较工作树非暂存区——两侧改好、分两笔提交不拦（最终一致即可）；包源删除文件退化为「孤儿」只报告不拦，删包源须手动清理装副本残件（复核 P2-2 声明，2026-09-27 gate-hardening-p2-batch）
 - B-b 决策「只报告不修复」；详见 `.agents/commands/source-sync-check.md`
 
-## 子代理调用约定
+## 7. 子代理调用约定
 
 - plan 起草、风险判断、改动清单与两道确认门由主智能体负责;仅两道确认后范围明确的工作包可委派 `implementer`,公共接口 / Schema / 依赖 / 安全 / 权限 / 破坏性操作不得委派。
 - 多工作包并行 / 链式推进:编排机制(声明随 plan 草稿一并确认;确认后读 `.agents/workflows/` 按机制文档执行,`steps/` 为项目自定义步骤扩展点);详见 `.agents/workflows/_TEMPLATE.md`。
 - 子智能体返回后,主智能体须检查 diff 与授权文件范围、确认未覆盖既有修改并重跑相关验证;不支持子智能体时 `fallback: main`,验收标准不变。
 
-## 确认后
+## 8. 确认后
 
 - plan 状态 → done（实现完成；intent / spec 关单在 test）
 - commit：L1+ 入口文档 / spec / plan 随代码同一提交（Conventional Commits 中文 feat/fix/refactor/perf）；docs 豁免与 bootstrap 可单独 `docs(*)`

package/modules/hosts/codex/commands/wf-deploy.md

@@ -45,11 +45,11 @@ description: Deploy 阶段:prod 上线清单(静态门 + 配对检查 + 回归 +
 - 异常回落:超阈值 → 生成 `workflow/incidents/YYYY-MM-DD-<主题>.md`,进 `maintain.md`(止血方案用户拍板,见 maintain.md §0)
 - 事故响应:单用途账号 + 最小权限;不得跨智能体协作推送修复(参考 Anthropic 教训)
 
-## 子代理调用约定
+## 7. 子代理调用约定
 
 - 上线清单、回滚方案、授权、tag 与事故决策均由主智能体处理,本阶段不委派子智能体;回滚方案(尤其含数据回滚 SQL)涉及数据安全,不得以通用实现子智能体代替主智能体判断与用户确认。
 
-## 确认后
+## 8. 确认后
 
 - 打 `release/<日期>` tag（commit SHA 可追溯）
 - 上线 + 用户观察 24h

package/modules/hosts/codex/commands/wf-design.md

@@ -6,9 +6,9 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
 
 > L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
-## 执行
+## 1. 执行
 
-1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）
+1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。
 2. 级别判断(对照 AGENTS.md 第 3 条):
    - **L1**(实现级改动,未命中 L2/L3)→ 走快车道,省略 spec,直接跳 `next: build.md` 起草 Quick-Plan
    - **L2**(改规则 / 契约:编码权威 / 共享契约 / 既有接口语义 / 全局横切口径,闭集见 `new-task.md` §级别判断)→ 必须有 spec
@@ -20,23 +20,23 @@ description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
    - 约束映射必须对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）与改动域目录级 `AGENTS.md`（如有）逐条说明如何满足
    - 存在多个可行方案时,在 spec 中列出各方案取舍与 AI 建议项,由用户选定后方可确认
    - **页面/交互入口形态必须用户确认**:spec 须写明入口是「表单（字段清单）」还是「选择器/弹窗」，禁止自行推定交互形态
-4. 起草后停下,输出草稿全文给用户过目
-5. L3 必须独立复核:宿主支持子智能体时调用 `independent-reviewer`,并要求其读取 `.agents/roles/independent-reviewer.md`;不支持时另开新会话。复核者读 spec + 根 AGENTS.md 与改动域目录级 AGENTS.md 的红线挑漏洞,结论写入 spec「确认与复核」节;复核未过不得确认
+4. 起草后停下,输出草稿全文给用户过目。
+5. L3 必须独立复核:宿主支持子智能体时调用 `independent-reviewer`,并要求其读取 `.agents/roles/independent-reviewer.md`;不支持时另开新会话。复核者读 spec + 根 AGENTS.md 与改动域目录级 AGENTS.md 的红线挑漏洞,结论写入 spec「确认与复核」节;复核未过不得确认。
 
-## 技能辅助(可选,宿主级 skills)
+## 2. 技能辅助(可选,宿主级 skills)
 
 - 对话已充分、无需再访谈时:用 `to-spec` 直接综合成 spec 草稿;其"发布到 issue tracker"默认行为一律改为写入 `workflow/specs/` 同名文件,按 `_TEMPLATE.md` 格式
 - L2/L3 模块设计:用 `codebase-design`(深模块/接缝/接口收窄);术语混乱或需记 ADR:用 `domain-modeling`
 - 方案取舍需压力测试:用 `grilling`;技能产出不越过用户确认门,L3 独立复核流程不变
 
-## 委派约定
+## 3. 委派约定
 
 - spec 起草、方案取舍与用户确认由主智能体负责,不委派;只有 L3 确认前的独立复核委派 `independent-reviewer`(必需输入:入口文档、spec、根 `AGENTS.md` + 改动域目录级 `AGENTS.md`、固定复核目标)。
 - 宿主不支持子智能体时必须 `fallback: new-session`,不得由原主智能体自查冒充独立复核。
 
-## 确认后
+## 4. 确认后
 
 - spec 状态 draft → approved
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——关单编辑（勾验/回填）先于 done 确认、confirm-doc 是最后一次写入，此后修订走 superseded 或新 intent。
+- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件调用+逐件原话 / 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
 - 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
 - 进 `next: .agents/commands/build.md`

package/modules/hosts/codex/commands/wf-gate-checklist.md

@@ -10,14 +10,14 @@ description: 三处口径一致性检查（doctor §检查项 ↔ check-loop §
 > 任何一处加新检查项，另一处不会自动同步——本工具报「未登记」；检查项被删/改号而登记未跟报「断档」。
 > 只报告不修复（B-b 决策）：缺点暴露给用户拍板，本工具不自动同步；exit 恒 0。
 
-## 何时跑
+## 1. 何时跑
 
 - 改 `src/doctor.mjs` 加新 § 检查项后（同时须登记 PAIRS）
 - 改 `.agents/scripts/check-loop.sh` 加新 § 检查项后（同时须登记 PAIRS）
 - 怀疑两处口径不一致时
 - 不跑：仅改既有检查项的提示文案（不动 § 项与登记表）
 
-## 登记表纪律（契约）
+## 2. 登记表纪律（契约）
 
 `templates/_agents/scripts/gate-checklist.mjs` 内 **PAIRS** 是配对单源，三选一登记：
 
@@ -31,7 +31,7 @@ description: 三处口径一致性检查（doctor §检查项 ↔ check-loop §
 - 删/改检查项不动登记表 → 工具报「断档」
 - 关键词匹配已退役（2026-09-25 registry 重写：实测 18×14 项只匹配 2、28 条噪声缺点，真漏点不可见）
 
-## 怎么跑
+## 3. 怎么跑
 
 ```bash
 node .agents/scripts/gate-checklist.mjs --diff   # 人类可读（默认）
@@ -40,7 +40,7 @@ node .agents/scripts/gate-checklist.mjs --json   # 机器可读
 
 输出四段：总览计数 → 对照表（登记表展开）→ 断档（如有）→ 未登记（如有）；全绿时输出「登记完整」。
 
-### 输出示例
+### 3.1 输出示例
 
 ```
 ▶ flow-kit gate-checklist --diff（显式配对登记表）
@@ -52,27 +52,27 @@ node .agents/scripts/gate-checklist.mjs --json   # 机器可读
   ✅ 登记完整（0 断档 / 0 未登记）
 ```
 
-### 自验
+### 3.2 自验
 
 ```bash
 node .agents/scripts/gate-checklist.test.mjs   # 13 场景全过
 npm test                                       # 含 gate-checklist 套件
 ```
 
-## 边界（不要做）
+## 4. 边界（不要做）
 
 - 不要把「登记完整」当作强制门 —— B-b 决策「只报告不修复」：断档/未登记暴露给 follow-up，exit 恒 0
 - 不要改 doctor / check-loop 检查项来消音 —— 登记表才是该改的地方（配对 / 独有 / 经 §7 三选一）
 - 不要扩展到看板告警 —— 看板当前无告警规则（gen-wiki-board.mjs 不做判定），扩展超出范围
 - 不要绕过登记直接改解析正则 —— 解析面只认 doctor `// N.` 节注释与 check-loop `// N.` 项注释（.mjs 头部清单，fallback 旧装户 .sh `# N.`）
 
-## 不在本次同步范围
+## 5. 不在本次同步范围
 
 - `.agents/board/` 看板告警（无告警规则）
 - `wiki/知识沉淀总览.html` 渲染（数据来源是 workflow/INDEX.md 与 wiki 目录，非本工具对照）
 - `flow-kit sync` managed 台账追踪（gate-checklist 不在 managed 范围）
 
-## 相关留痕
+## 6. 相关留痕
 
 - intent（登记表重写）：`workflow/intents/2026-09-25-gate-checklist-registry.md`
 - intent（工具首建）：`workflow/intents/2026-09-25-gate-checklist.md`