agentic-flow-kit 1.8.2 → 2.0.0

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

@@ -1,77 +0,0 @@
----
-description: 三处口径一致性检查（doctor §检查项 ↔ check-loop §检查项，显式配对登记表 + 断档/未登记告警）
----
-
-> **装户边界**：本文档中 `src/`、`bin/flow-kit.mjs`、`templates/_agents/`、`modules/hosts/` 为 kit 包源仓视角引用——装户仓（无 `templates/` 包源）对应命令不适用，本仓以 `.agents/` 装副本为准。
-
-# Gate-Checklist · 三处口径一致性（显式配对登记表）
-
-> `src/doctor.mjs` § 检查项 ↔ `.agents/scripts/check-loop.sh` § 检查项，按脚本内 **PAIRS 登记表**对照。
-> 任何一处加新检查项，另一处不会自动同步——本工具报「未登记」；检查项被删/改号而登记未跟报「断档」。
-> 只报告不修复（B-b 决策）：缺点暴露给用户拍板，本工具不自动同步；exit 恒 0。
-
-## 1. 何时跑
-
-- 改 `src/doctor.mjs` 加新 § 检查项后（同时须登记 PAIRS）
-- 改 `.agents/scripts/check-loop.sh` 加新 § 检查项后（同时须登记 PAIRS）
-- 怀疑两处口径不一致时
-- 不跑：仅改既有检查项的提示文案（不动 § 项与登记表）
-
-## 2. 登记表纪律（契约）
-
-`templates/_agents/scripts/gate-checklist.mjs` 内 **PAIRS** 是配对单源，三选一登记：
-
-| 形态 | 写法 | 含义 |
-|------|------|------|
-| 直接配对 | `{ doctor: 'N', cl: 'M' }` | 同一检查两处实现 |
-| 声明独有 | `{ doctor: 'N', cl: null }` | doctor 装户体检面，无 check-loop 对应（原 intent 拍板只报告不修复） |
-| 经 §7 覆盖 | `{ doctor: '7', cl: 'M' }` | doctor §7 整体运行 check-loop，#M 自动流入 doctor |
-
-- 加新 § 检查项不登记 → 工具报「未登记」（新检查项没对账——核心信号）
-- 删/改检查项不动登记表 → 工具报「断档」
-- 关键词匹配已退役（2026-09-25 registry 重写：实测 18×14 项只匹配 2、28 条噪声缺点，真漏点不可见）
-
-## 3. 怎么跑
-
-```bash
-node .agents/scripts/gate-checklist.mjs --diff   # 人类可读（默认）
-node .agents/scripts/gate-checklist.mjs --json   # 机器可读
-```
-
-输出四段：总览计数 → 对照表（登记表展开）→ 断档（如有）→ 未登记（如有）；全绿时输出「登记完整」。
-
-### 3.1 输出示例
-
-```
-▶ flow-kit gate-checklist --diff（显式配对登记表）
-  doctor §检查项: 12  |  check-loop §检查项: 14  |  直接配对 2 + 经 §7 覆盖 12 + 声明独有 9
-  对照表（登记表展开）:
-    ✓ §5 占位符残留 ↔ #2 模板字段占位符残留(YYYY-MM-DD / <主题> 等…)（占位符残留）
-    ● §1 Node 版本（声明独有：Node 版本——装户体检独有）
-    ✓ §7 check-loop ↔ #1 入口文档/spec/plan 同名配对(…（经 §7 整体运行覆盖）
-  ✅ 登记完整（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. 相关留痕
-
-- 立法出处：2026-09-25（登记表重写 + 工具首建；父事件 = owned 漂移未对账，催生本工具）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

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

@@ -1,76 +0,0 @@
----
-description: Maintain 阶段:立 incident + 复盘三件套(修复 / 防复发 / 规范条目)
----
-
-# Maintain · 立 incident + 复盘三件套
-
-> 修复走 incident 流程;incident 在 L1+ 即 **intent 等价物**(check-loop 已认 incident≡intent),不必另造 intent。spec/plan 与 incident 同名即闭环。
-
-> 事故回到 Plan。复盘三件套缺一不可,防复发承诺不留在文档里。
-
-## 1. 执行
-
-> **看板（可选，默认不拉起）**：需要实时看板时手动跑 node .agents/scripts/ensure-board.mjs（跨平台；幂等：探活 / 旧代码自动重启 / 全新启动才弹浏览器；端口 8933 起自动上探，链接以脚本输出为准；不开看板不影响任务流程）。
-
-### 1.1 紧急止血(仍在事故中时)
-
-1. AI 先诊断:读日志 + 代码,给出止血选项(版本回退 / 数据回滚 / 热修 / 降级 / 暂不处理)与各自影响面、耗时
-   - **版本回退**(代码 / 配置,无数据影响):回退到上一 `release/<日期>` tag——运行时 / 管线类事故(认证管线 / DI 注册 / 中间件)的首选,须确认上一 tag 可复现构建
-   - **数据回滚**(库侧):按 `deploy.md` §5 的回滚预案执行——须有备份点、回滚 SQL 已在 dev 演练过;涉及数据安全,不得委派子智能体判断
-2. 止血方案由用户拍板;AI 只执行选定方案,不自行推送修复
-3. 热修代码后仍须补跑 `test.md` 静态门;止血完成再进下面的复盘流程(时间线从本节记起)
-
-### 1.2 起草 incident
-
-1. **先检索同类 incident**：`node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type incidents`——命中同类先读其「根因 / 复盘三件套」，本次三件套须引用其防复发条目（review.md P2 对账项）
-2. 复制 `workflow/incidents/_TEMPLATE.md` → `workflow/incidents/YYYY-MM-DD-<主题>.md`（frontmatter 填 `模块:`，词表见 `.agents/workflow-modules.txt`）
-3. 填 4 节:时间线(发现→定位→止血→恢复,带时刻) / 影响面(页面/接口/数据范围) / 根因(一句话+深层原因) / 为什么之前没拦住(门禁/测试/规范各查一遍)
-
-### 1.3 起草复盘三件套(缺一不可)
-
-> 目的:让事故真正回到 Plan,不让「防复发」承诺停留在文档里。
-
-**1. 结构性修复**
-- 修复 commit:<SHA + 改动文件清单>
-- 影响环境:dev / staging / prod(已上线模块若波及 prod,需附影响用户数 / 持续时长 / 是否回滚)
-- 是否需要新 intent(本 incident 即 intent 等价物,check-loop 已认 incident≡intent,spec/plan 与 incident 同名即闭环):
-  - 否 → 理由:<根因属实现 bug、单点修复已完成,incident 已含目标/约束,等同 intent>
-  - 是 → 根因属「门禁缺位 / 规范未落地 / 系统性问题」时强制立 `workflow/intents/YYYY-MM-DD-<主题>.md` 追踪(即使结构性修复已完成)
-
-**2. 防复发验证**(必须落到自动化用例或回归条目,禁止只写「已人工验证」)
-- 自动化用例:项目测试套件 `<文件>`(`<用例名 / 数量>`)
-- 或 verify 步骤:`.agents/commands/test.md` + <具体操作>
-- 或回归清单条目:`workflow/regression-checklist.md` 防复发验证节(追加一行)
-
-**3. 规范条目**(必须有可追溯落点)
-- 落点优先级(取最前者可行即止):`workflow/regression-checklist.md` 回归条目 / `.agents/hooks/` 或 `tests/` 断言(机器门)→ `.agents/skills/`、`.agents/notes/` → `workflow/` 文档 → `.agents/commands/`
-- **根 `AGENTS.md` 不再是落点**;**入册门槛**:已由机器门强制的内容只留一行指针,禁止在常驻面复述;**一进一出**:落点为常驻面时须在本 commit 内删除或下沉一条被取代条目
-- 常驻面体积预算由 pre-commit 硬拦(`node .agents/scripts/rule-budget.mjs --staged`,表 `.agents/rule-budgets.txt`)——超限先删再增
-- 引用:commit <SHA> / 文件:<路径>#L<行>;若无新增条目,理由:<已有条目覆盖,说明条目位置>
-
-### 1.4 起草后停下
-
-输出草稿全文给用户过目;确认后才执行三件套落地。**确认点不合并**：incident 草稿、spec、plan 各自过目确认（plan 的两道门见 `build.md`）；确认后立即留痕（spec/plan 状态 `approved` + 「确认与复核」节，incident 时间线补「用户确认」条目），`done` 只在关单出现。**L2/L3 机器前置**：起草 spec 时 fill-spec / confirm-doc 校验「时间线含『用户确认』留痕」，未过即拒（exit 2）——被拒回本流程补留痕。
-
-### 1.5 确认后落地
-
-1. **开工前先配 plan**：复制 `workflow/plans/_TEMPLATE.md` 建 incident 同名 plan（L1 极简形态填「改动面 + 验证方式」两节即可）——incident≡intent 免掉的是 intent，**plan 不可免**（pre-commit 增量配对门禁与 pre-push check-loop 均按同名硬拦）
-2. 结构性修复:L1 走 `build.md` → `test.md`;L2/L3 先走 `design.md` 再进 `build.md` → `test.md`
-3. 三件套落地:防复发验证按 §1.3②、规范条目按 §1.3③ 落点优先级逐条落
-4. 若选「需要新 intent」→ 进 `next: .agents/commands/plan.md` 立新 intent 追踪
-
-## 2. 技能辅助(可选,宿主级 skills)
-
-- 根因诊断:难复现/跨层问题用 `diagnosing-bugs` 走诊断循环(红→最小化→假设→插桩→修复→回归)
-- 事故定性/分级:参考 `triage` 技能的状态机思路;产出仍落 incident 模板,不引外部 tracker
-- 处置决策需用户离线拍板:用 `to-questionnaire` 生成问卷
-
-## 3. 子代理调用约定
-
-- 事故诊断、止血选项、根因定性、incident 与三件套起草均由主智能体负责,不委派;用户选定止血方案后,仅有明确复现路径、授权文件与验收条件的局部热修可委派 `implementer`(数据 / Schema / 权限 / 安全 / 破坏性操作不得委派)。
-- 常规结构性修复按级别回流(L1 走 `build.md`;L2/L3 走 `design.md`),不在 Maintain 绕过前置门禁;子智能体返回后由主智能体检查 diff 并补跑 `test.md`。
-
-## 4. 确认后
-
-- incident 状态 → fixed(三件套全落地)；防复发用例通过后 → closed——两跳均走确认门 `node .agents/scripts/confirm-doc.mjs <path>`（open→fixed / fixed→closed，无单跳；2026-09-28 起 check-loop 15 对账，AI 不得直改状态；口径见根 `AGENTS.md` §1.3 确认门）
-- 若需新 intent → 进 `next: .agents/commands/plan.md`

package/modules/hosts/codex/commands/wf-new-task.md

@@ -1,102 +0,0 @@
----
-description: AI-Native 闭环总入口:6 阶段指令索引(Plan→Design→Build→Test→Deploy→Maintain)
----
-
-# New Task · 闭环总入口
-
-> 6 阶段指令索引。AI 读 AGENTS.md 后按阶段路由,不并阶段、不跳阶段。
-
-## 1. 6 阶段指令索引
-
-| 阶段 | 指令 | 触发短语 | 可委派子智能体 | 确认点 |
-|------|------|---------|----------------|--------|
-| **Plan** | [.agents/commands/plan.md](.agents/commands/plan.md) | "起个 intent" / "要做个 <功能>" | 无 | intent 要点确认 |
-| **Design** | [.agents/commands/design.md](.agents/commands/design.md) | "起个 spec" / "intent 看过了" | `independent-reviewer`(L3) | spec 草稿确认(L3 加独立复核) |
-| **Build** | [.agents/commands/build.md](.agents/commands/build.md) | "起个 plan" → "动手吧" | `implementer`(确认后、范围明确时) | plan 确认 + 动手前确认 |
-| **Test** | [.agents/commands/test.md](.agents/commands/test.md) | "改完了" / "跑下 verify" | `ui-verifier`、`independent-reviewer` | 测试全过(L2/L3 独立复核)+ 关单；L1 结束 |
-| **Deploy** | [.agents/commands/deploy.md](.agents/commands/deploy.md) | "可以上了" / "过 release 清单" | 无 | 仅 prod：用户确认 + release tag |
-| **Maintain** | [.agents/commands/maintain.md](.agents/commands/maintain.md) | "线上出事了" / "记一笔 incident" | `implementer`(方案确认后) | 三件套要点确认 |
-| **Review**(横切,不占 6 阶段) | [.agents/commands/review.md](.agents/commands/review.md) | "评审一下" / "过 review 标准" | `independent-reviewer`(L2/L3 必须独立复核) | 问题定性与合入时机确认 |
-
-## 2. 风险定级(第 0 步,先定级再路由)
-
-**第 0 步先取机器面下界(必跑,不是可选提示)**:
-
-```bash
-flow-kit route --files <预计改动面…> --kind require|fix|verify|review|deploy
-```
-
-- **不给 `--files` 就拿不到路径下限**——机器面此时只能按 L1 起步并在降级栏点名,等于白跑;
-  故定级前先把**预计改动面**列出来(不必精确到最终 diff,给到目录/文件前缀即可)。
-- 跑完**再**按 §4 逐条语义判级:机器只给「就高不就低 + 路径下限」,「一处定义、多处消费」仍要你判。
-- **确实跳过**时必须写明理由(入口文档备注或当场告知用户)——判低的后果由两道门兜:
-  起草面 `check-lane-surface` 命中路径下限无合格入口即拦,提交面同门再拦一次。
-  **诚实边界**:机器**无法**发现你没跑 route——定级发生在改动面确定之前,没有可比对的记录面,
-  详见 [ARCHITECTURE §5](../ARCHITECTURE.md) 与 CHANGELOG 1.7.16 B3 条。
-
-动工前按下表定风险级 L1-L3(就高不就低;判据细则见下节「级别判断」,单源 level-criteria.mjs),级别即风险级,决定走哪条泳道——确认放事前,还是审计补事后:
-
-| 泳道 | 级别 | 确认与审计口径 |
-|------|------|---------------|
-| **协作道**(敏捷优先,审计异步补) | L1 实现级 | 一份 plan 即入口(来源 / 目标 / 红线 / 改动 / 验证 / 验收),不另立 intent。独立复核不设同步前置,check-loop 与事后 review 兜底;确认/代录可 `--batch` 批量(仅 L1) |
-| **防御道**(严谨优先,确认同步拦) | L2 规则/契约 / L3 数据与运行时结构 | 同步确认门:spec 确认通过方可起草 plan,plan 确认后方可动手;L3 加新会话独立复核,未确认不放行 |
-
-> **两问定级**（2026-10-13 L0 退役,自源仓收敛系列 1 回灌）:结构面(schema / 迁移 SQL / DI / 认证管线)→ L3;契约或共享口径 → L2;两者都没有 → L1。不要按严重程度从 L1 往上滑。
-> **落位**: L1 写在 plan frontmatter `级别`;L2/L3 写在 intent(intent 另以 `risk_level`=级别双写,`fill-intent.mjs` 自动写入,机器选道用)。
-> **判低拦截**: 入口勾触达红线 → check-loop「红线判低」hard 拦 → 升到 L2/L3 并补同名 spec。
-> **预判留痕**（§25 advisory）: 定级先做结构化预判（有结构化判定工具则对齐本仓判据，无则按两问自判），结果写进入口文档 frontmatter「预判: kind=<kind> level=<L1|L2|L3>」——与实际落位不符 check-loop 出 WARN 留账。kind 词表与对账机理见 `.agents/notes/engine-internals.md`（维护者面）。
->
-> **L2/L3 起草期合并预览**：三件套起草按 [design.md §0](design.md) 一次呈现要点总览（逐件确认代录不变）。
-
-## 3. 路由判断
-
-<!-- route-kinds: require=plan.md | fix=maintain.md | verify=test.md | review=review.md | deploy=deploy.md -->
-<!-- ↑ 本行是 kind→入口指令的**机器单源**：`flow-kit route` 读它得出「该读哪个 md」，不再在包内自带一份映射。
-     增删 kind 或改入口文件名只改这一行（判据单源 level-criteria.mjs 的纪律同源）。 -->
-
-- **自动化驱动（并列入口,可选）**:一句话全程走 [pipeline-run.md](pipeline-run.md)——状态机驱动+工单协议+原话代录,与下述手动路由二选一,同一任务不混用
-- **新需求 / 功能**:从 `plan.md` 进,立 **intent**(`workflow/intents/`)
-- **修复类任务 / 事故**:从 `maintain.md` 进,立 **incident**(`workflow/incidents/`);incident 在 L1+ 即 **intent 等价物**(check-loop 认 incident≡intent),不必另立 intent。先检索同类历史(`node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type incidents,plans`),有同类先读其历史三件套;再按级别走:
-  - L1 → 立 incident 后进 `build.md` 起草并确认同名 Quick-Plan → `test.md`
-  - L2/L3 → 立 incident 后进 `design.md` 起草并确认同名 spec,再进 `build.md` 起草并确认同名 plan → `test.md`
-  - 仅当根因属系统性 / 门禁缺位(maintain.md 三件套「是否需要新 intent」选"是")才另立 `workflow/intents/` 同名 intent
-- **改完代码要验证**:直接进 `test.md`（验证通过即关单；L1 到此结束）
-- **合入前评审**:直接进 `review.md`(横切,P0/P1/P2 分级清单 + L2/L3 独立复核)
-- **准备上线**:直接进 `deploy.md`（仅 prod；文档应已在 test 关单）
-
-## 4. 级别判断(AGENTS.md 第 3 条)
-
-> **判据单源 = [`.agents/scripts/level-criteria.mjs`](../scripts/level-criteria.mjs)**,本节**不复述判据**。
-> 要看判据全文,或要机器可判的部分(路径下限 / 就高不就低 / 混档取高),直接:
->
-> ```bash
-> flow-kit route --files <改动文件…>      # 定级 + 下一阶段 + 该读哪个 md
-> ```
->
-> 单源导出:`LEVELS` `LEVEL_MEANING`(档位语义) / `L2_SURFACES`(四类触达面闭集) / `L3_SURFACES`(结构面) /
-> `L1_NEGATIVES`(判低红线) / `SELF_CHECK`(自查句) / `assessLevel` `hintLevelFor` `parseLevelHints` `routeAdvice`。
->
-> 路径下限清单(装户 owned,默认空):`.agents/level-hints.txt`,每行 `L2 <ERE>` / `L3 <ERE>`,登记「哪些路径一碰就至少是此档」。
-
-**本表只承载流程**(「改什么」判据以单源为准,别在本表增删判据):
-
-| 级别 | 单源语义(摘要) | 流程 |
-|------|-----------------|------|
-| L1 | 实现级改动(未命中 L2/L3) | 快车道:液态草稿(.zcode/drafts) → 实现 → 固化(`solidify-task.mjs`)——用户确认后带 `--delegated "<原话>"` 执行;无确认来源只迁移不落账;亦可一份 plan 即入口(不另立 intent) |
-| L2 | 规则 / 契约(一处改、多处依赖) | 入口文档(intent / incident) + spec + plan 三件套 |
-| L3 | 数据与运行时结构(结构面闭集见单源 `L3_SURFACES`) | 同 L2 + spec 新会话独立复核 |
-
-> 混合改动按最高档定级(就高不就低);**L1 是默认档**——判级只回答「是否命中单源 `L2_SURFACES` 或
-> `L3_SURFACES`」,负例(`L1_NEGATIVES`)命中即不得升档;自查句:`SELF_CHECK`。
-> 机器兜得住的只有「就高不就低」与路径下限;「一处定义、多处消费」是**语义**判定,由你按单源逐条判,
-> 漏判由 lane-surface 触达面门在提交面兜。先例:`workflow/specs/`、`workflow/intents/` 下同类历史(kb 检索主题词)。
-
-## 5. intent 豁免(避免小改动也走完整闭环)
-
-- **L1 新需求**:一份 plan 即入口,不另立 intent(不必 spec)
-- **docs 级改动**(AGENTS.md / workflow/ 模板 / .agents/ 脚本与 commands / yaml):豁免 intent,走 Conventional Commits 直接 commit;若同时触及代码,按代码部分级别立 intent
-- **bootstrap 类改动**(引入规则本身):豁免 intent,commit message 显式声明 `bootstrap`
-
-## 6. 闭环兜底
-
-- 门禁清单与判据以 `.githooks/` / `.agents/hooks/` / `check-loop.sh` 头部注释为准(本文件不复述、不写项数);hard-block = 配对断裂 / 回路断档 / 新建 done 未勾验。本地机器门只有本地钩子,禁 `--no-verify`(见根 `AGENTS.md`)。

package/modules/hosts/codex/commands/wf-pipeline-run.md

@@ -1,35 +0,0 @@
----
-description: pipeline-run 自动化驱动入口——单命令驱动六阶段闭环（工单协议+机器门+原话代录）
----
-
-# pipeline-run · 全自动闭环执行器入口
-
-> 确定性部分由 `pipeline-run.mjs` 状态机驱动（机器门序列：fill-* → confirm-doc → verify.mjs → git，退出码全记录）；
-> AI 槽位经工单协议交宿主执行；人件门到点即停、原话代录。宿主只按本协议驱动，不自行改状态。
-
-## 1. 驱动协议（宿主 AI 逐条执行）
-
-1. **启动**：`node .agents/scripts/pipeline-run.mjs start "<需求原文>"`（可预判则加 `--hint "kind=… level=… module=…"`）。
-2. **循环读停机点**：每次命令的 stdout 末行是机器标记 `PIPELINE-STOP <type> …`，按 type 分流：
-   - `work-order <runId> <工单id>`——读工单全文（目标/步骤/约束/验收），**按单干活**：
-     - triage：判级回填 `next --triage "kind=… level=… module=… topic=<英文kebab>"`（就高不就低）
-     - draft：起草指定文档；implement/fix：按授权文件实现（**偏离即停**——公共接口/计划外文件/新依赖→停机向用户上报，不自行放行）；review/closeout：按单产出并写入指定位
-     - 干完回跑 `next`（implement/fix 须 `--files "a,b"` 回填改动清单；review-only 汇报后 `--done` 收尾）
-   - `await-confirm <runId> <doc>`——**人件门**：向用户转述「要点」索确认；用户明确放行后
-     `next --delegated "<用户原话>"`（逐字原话，**永不编造、永不复用旧句**；一次一份）
-   - `gate-fail <runId> <stage>`——读 problems 原因，修复后原路重跑（不绕门、不加 `--no-verify`）
-   - `done <runId>`——向用户汇报总结（阶段条/门数/提交链），流程结束
-   - `aborted <runId>`——已显式放弃，汇报放弃态与留档位置
-3. **放弃**：用户明确不做时 `abort --run <id> --to superseded|cancelled --delegated "<原话>"`（approved 文档逐份走 confirm-doc --to）。
-4. **观测**（可选）：`status [--run <id>] [--json]` 全量事件流水；`watch` 终端轮询视图。
-
-## 2. 硬纪律（违反即协议破坏）
-
-- 状态迁移唯一入口是脚本内部的 confirm-doc 调用——宿主**永不直改** workflow 文档 frontmatter 状态。
-- `--delegated` 的原话必须是用户当次对话原话（台账 `confirmations.jsonl` 留痕可对质）。
-- 修复环超限（3 次）时停机交人工，不带病推进；verify 非绿不关单。
-- run 文件（.agents/cache/pipeline-runs/）是脚本亲写的机器事实——宿主只读不写。
-
-## 3. 与 new-task 的关系
-
-本命令是**自动化驱动的并列入口**（单命令走全程）；new-task.md 是手动阶段路由入口。同一套门禁与确认语义，二者只选其一驱动一个任务，不混用。

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

@@ -1,40 +0,0 @@
----
-description: Plan 阶段:立 intent(需求来源 / 目标 / 约束 / 触达红线)
----
-
-# Plan · 立 intent
-
-> AI 起草,用户确认。确认前不进下一阶段。
-
-## 1. 执行
-
-> **看板（可选，默认不拉起）**：需要实时看板时手动跑 node .agents/scripts/ensure-board.mjs（跨平台；幂等：探活 / 旧代码自动重启 / 全新启动才弹浏览器；端口 8933 起自动上探，链接以脚本输出为准；不开看板不影响任务流程）。
-
-1. 若 `workflow/intents/` 已有目标 intent 且状态为 approved → 按级别跳 next（L1 → `build.md`，L2/L3 → `design.md`）。
-2. 否则起草新 intent:
-   - **先检索同类**：`node .agents/scripts/kb-search.mjs "<关键词>" --scope workflow --type intents,specs`——命中同类先读其结论与验收,新 intent 引用（防重复立项 / 重复踩坑）
-   - **填空工具先跑**：`node .agents/scripts/fill-intent.mjs --module <模块> --level <L1|L2|L3> --topic <主题> --output workflow/intents/<date>-<主题>.md --notes "<备注>"`——输出含 frontmatter 6 字段（含 risk_level）+ 9 节（背景与问题/历史教训防复发/目标/非目标/约束/影响面/触达红线/验收标准 8 节正文 + 确认与复核）的草稿；AI 据此填实，模板与节标题机器保证不出错
-   - 复制 `workflow/intents/_TEMPLATE.md` → `workflow/intents/YYYY-MM-DD-<主题>.md`
-   - frontmatter 填 `模块:`（词表见 `.agents/workflow-modules.txt`，新建文档必填，check-loop 会警告）
-   - 按 8 节填写:背景与问题 / 历史教训防复发 / 目标(可验证) / 非目标 / 约束 / 影响面 / 触达红线 / 验收标准（L1 微改动可省非目标/约束两节，不硬填）
-   - 红线勾选对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）;**没触及就全不勾**,不要硬填
-3. 写不出可测试判据 = 还没想清楚 → 反问澄清,不要硬填。
-4. 起草后停下,输出草稿全文给用户过目,一句"可以"即确认。
-   **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
-
-## 2. 技能辅助(可选,宿主级 skills)
-
-- 需求模糊、判据写不出时:用 `grilling`/`grill-me` 拷问需求,答完回填 6 节
-- 需要用户离线拍板的决策:用 `to-questionnaire` 生成问卷,问题清单随 intent 草稿一并列出
-- 讨论中需同时沉淀术语表/ADR:用 `grill-with-docs`,文档落 `workflow/` 下与主题同名
-- 技能只辅助澄清,产出仍按 `_TEMPLATE.md` 落 `workflow/intents/`,确认门不变
-
-## 3. 执行主体
-
-- 需求澄清、级别判断与 intent 起草由主智能体负责,本阶段不委派子智能体。
-
-## 4. 确认后
-
-- intent 状态 draft → approved
-- 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)——**提交最早可行点**：入口文档受 pre-commit 闭环配对（增量）门约束，同名 spec / plan 须已在工作区（先例 61ec130）
-- L1 → `.agents/commands/build.md`；L2/L3 → `.agents/commands/design.md`

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

@@ -1,49 +0,0 @@
----
-description: 代码评审标准（按风险分级：机器兜底 + AI 自查出清单，用户决策定性与合入）
----
-
-> **装户边界**：本文档中 `src/`、`bin/flow-kit.mjs`、`templates/_agents/`、`modules/hosts/` 为 kit 包源仓视角引用——装户仓（无 `templates/` 包源）对应命令不适用，本仓以 `.agents/` 装副本为准。
-
-# Review
-
-> 参考 Anthropic REVIEW.md 做法。宗旨是**用户决策 + AI 协作**：AI 跑机器门禁、自查、出分级清单与建议；用户确认问题定性与合入。把"该机器兜底"与"靠 AI 自查"分开列明，避免注意力耗在机械逐行上。
-> 本文件为通用骨架;项目专属红线 / 命名 / 组件约定的具体口径在项目适配区（目录级 `AGENTS.md` 与 `.agents/hooks/`）补充。
-
-## 1. P0 必拦（优先机器兜底，hook 覆盖不到的靠 AI 自查）
-
-- **架构红线**：分层依赖方向约束(如领域 / 应用层禁直接引用基础设施实现;豁免清单见目录级 `AGENTS.md` / 项目适配区)
-  - 机器兜底：项目自有架构门禁(如有,`.agents/hooks/`)
-- **审计字段**：项目约定的公共审计字段必须由统一基础设施自动写入，禁业务代码手工补写
-  - 机器兜底：项目自有门禁(如有,比对新增审计赋值;统一基础设施与初始化写入合法)
-- **删除拦截**：删除前必须查子级 / 业务引用，被引用时按项目统一口径报错拒绝；无数据库外键兜底的引用(值引用 / 跨模块单据引用)必须服务层显式查
-  - 机器兜底：项目自有门禁(如有,删除调用点与 allowlist 比对) + AI 自查守卫正确性(每个调用点核对删前查引用)
-- **入参校验**：必填字符串判空，范围型字段范围校验，非法输入按项目统一错误口径拒绝
-  - 机器兜底：项目验证测试覆盖(如有) + AI 自查
-- **L2 / L3 改动无 spec**：拒收，先回 `workflow/specs/` 立 spec 确认通过
-
-## 2. P1 应拦（自查重点）
-
-- **DB 命名与迁移**：遵循项目表 / 字段 / 外键命名规范与 schema 变更流程(见目录级 `AGENTS.md`);不得擅自引入项目未采用的迁移机制
-- **前端形态**：新增 / 编辑与大数据量选择等交互遵循项目组件约定(弹层 vs 跳页、选择器形态、表格与样式统一等)
-- **表单**：可选字段空值按项目约定归一化后再提交;禁改后端 DTO 规避校验
-- **状态管理**：遵循项目状态管理模式;store 调 API，组件只调 store
-- **API 入参边界**：写操作禁 `[FromBody]` 绑定领域实体（一律 DTO）；入参 DTO 禁含主键与审计字段
-- **导入信任边界**：导入执行端点服务端全量复验，禁信任客户端校验结果；解析失败进错误行汇总，禁静默丢弃
-- **Create/Update 校验同口径**：Create 已有校验 Update 必须同口径；被引用的标识符字段禁改
-- **查询分页与状态语义**：分页参数范围校验 + 服务层钳制；非法状态与不存在分离(按项目统一错误口径,如 400 / 404)
-- **spec 承诺的断言落地**：spec §测试列出的用例 / 断言须真落到测试或验证脚本；「写进 spec」不等于「跑得起来」，且常驻断言禁写成随时间增长的行数常量
-- **跨宿主薄适配正文漂移**：包源仓改 `templates/_agents/{commands,roles}/*.md` 后跑 `flow-kit sync-hosts --apply`，单向同步 `modules/hosts/<h>/{agents,commands}/*.md`。装户由 `flow-kit doctor` §6.7 检查（包源环境跳过）；装户刷新宿主文件用 `flow-kit add-host <宿主> --force`（`sync` 不更新宿主适配，`sync-hosts` 不在装户根运行）
-
-## 3. P2 建议（提醒，不拦合入）
-
-- 样式统一性（深色 / 浅色主题、卡片样式）
-- 注释完整性（复杂逻辑处补注释，AGENTS.md 已说的不重复）
-- Conventional Commits 中文（feat / fix / docs / style / refactor / perf）
-- 历史同类 incident 的复盘三件套是否补齐
-
-## 4. 审查分工（用户决策 + AI 协作）
-
-- **机器兜底**（pre-commit / pre-push / test 自动拦，无需人守）：门禁清单与判据以 `.githooks/`、`.agents/hooks/`、`check-loop.sh` 头部注释为准；`项目测试命令` 跑自动化用例。
-- **AI 复核**：机器门禁完成后优先委派 `independent-reviewer`，聚焦 P0 hook 未覆盖项 + 全部 P1（P2 视精力）——产出分级问题清单 + 修复建议。复核方法走 `.agents/skills/review-method/SKILL.md`（Standards×Spec 双轴 + 坏味道走查 + 合入标尺；有全局 `code-review` 技能时可叠加）；每条 finding 报告前过 `review-verification-protocol` 防误报门（锚定 file:line、给出证据、校准严重级，不确定就降级为提问）。
-- **独立性**：L2 / L3 必须用独立子智能体，宿主不支持时另开新会话，不得由原作者自查冒充；L1 且宿主不支持子智能体时可由主智能体按同一复核契约执行。
-- **用户决策**：问题定性（误报驳回 / P0 成立必修 / P1、P2 处置裁量）+ 合入时机；git 历史即评审记录，追溯靠 commit 与 tag。

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

@@ -1,64 +0,0 @@
----
-description: 跨宿主适配层同步（正文段 sha 比对 + 用户拍板 + 单向 apply；frontmatter 不动）
----
-
-> **装户边界**：本文档中 `src/`、`bin/flow-kit.mjs`、`templates/_agents/`、`modules/hosts/` 为 kit 包源仓视角引用——装户仓（无 `templates/` 包源）对应命令不适用，本仓以 `.agents/` 装副本为准。
-
-# Sync-Hosts · 跨宿主适配层正文段同步
-
-> 本命令只在包源仓运行（需要 `templates/_agents` 与 `modules/hosts`）。改权威源（`templates/_agents/{commands,roles}/*.md`）后薄适配（`modules/hosts/<h>/{agents,commands}/*.md`）要同步——薄适配正文 = 权威源正文，frontmatter 各自保留宿主特化（commands 层文件名 = 宿主命令名，opencode / trae 同用 `wf-` 前缀，单源见 `src/profiles.mjs#HOSTS.commandPrefix`；trae 另有 `name: wf-X`，zcode/omp 各自原描述）。
-> 装户的宿主文件由 `init` / `add-host` 写入。装户漂移由 `flow-kit doctor` §6.7 报告（包源环境跳过）；刷新用 `flow-kit add-host <宿主> --force`。`flow-kit sync` 不更新宿主适配。
-
-## 1. 何时跑
-
-- 改 `templates/_agents/commands/*.md` 正文后（11 个 commands 文件）
-- 改 `templates/_agents/roles/*.md` 正文后（3 个 roles 文件）
-- 不跑：装户仓（本命令会拒绝）；仅改 frontmatter；改 trae 钩子/规则；改包源其他文件
-
-## 2. 怎么跑
-
-### 2.1 默认 `--diff`（仅报告）
-
-```
-node bin/flow-kit.mjs sync-hosts --diff      # 包源仓（在包源根跑，或 --dir <包源根>）
-node bin/flow-kit.mjs sync-hosts --json      # 机器可读
-```
-
-输出三类：
-- **正文对齐 N 对** — sha 一致，无需处理
-- **正文段漂移 N（权威源 vs 薄适配 sha 不一致）** — `--apply` 同步方向；不区分"权威源改了"或"薄适配手改了"，由用户拍板
-- **⚠️ 权威源声明但薄适配缺失** — `add-host <h>` 接管后跑 `--apply` 才会装（apply 不自动创建）
-- **⚠️ 孤儿薄适配（权威源无对应文件）** — 历史残留或宿主特化，apply 不删
-
-### 2.2 `--apply` 单向同步
-
-```
-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
-node bin/flow-kit.mjs doctor                   # 包源环境 §6.7 skipped
-```
-
-## 3. 边界（不要做）
-
-- 不要 `--apply` 反向同步（写权威源）：权威源是真相，薄适配手改会被覆盖——这是设计，apply 前先看 `--diff`
-- 不要删除孤儿薄适配：可能是宿主特化或历史残留，apply 不动
-- 不要改 frontmatter 让 sha 凑齐：frontmatter 是宿主特化字段（trae name: wf-X 等），工具不参与
-- 不要把「避免与权威版本漂移」明文加回去——这是旧契约的指针风格，已被 B-b 正文副本取代
-- 装了新宿主后跑 `--apply`：新宿主目录空白，apply 不会自动创建薄适配（薄适配须经 `add-host <h>` 接管）
-
-## 4. 不在本次同步范围
-
-- trae 钩子（`modules/hosts/trae/hooks/*.cjs`）— 独立演进的工程件
-- trae 规则（`modules/hosts/trae/rules/*.md`）— 同上
-- 门禁脚本与钩子（`templates/_agents/scripts`、`templates/_githooks`）— 由 `flow-kit sync` 按 managed 台账下发，不走 sync-hosts
-
-## 5. 相关留痕
-
-- 立法出处：2026-09-25 cross-host-sync（intent/plan，含 B-b 方案拍板；父事件 = wf-runtime 双源纪律教训，规范 §7.x 包源环境跳过）——留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径

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

@@ -1,68 +0,0 @@
----
-description: Test 阶段:静态门(架构红线 + build + test)+ UI 实测(headless Chrome)
----
-
-> **装户边界**：本文档中 `src/`、`bin/flow-kit.mjs`、`templates/_agents/`、`modules/hosts/` 为 kit 包源仓视角引用——装户仓（无 `templates/` 包源）对应命令不适用，本仓以 `.agents/` 装副本为准。
-
-# Test · 静态门 + UI 实测
-
-> 两道闸:静态门全过 + 涉及 UI 走浏览器实测。失败不放过。
-
-## 1. 静态门(代码改动后必跑)
-
-```bash
-# 项目自有门禁脚本(如有;清单以 .agents/hooks/ 与目录级 AGENTS.md 头部注释为准)
-项目构建命令                                      # 编译
-项目测试命令                                       # 自动化测试
-项目类型检查命令                                  # 前端类型检查/构建(涉及前端时跑)
-node .agents/scripts/verify-wiki-consistency.mjs   # 触及 wiki/ 时跑(exit 1 即先修台账再继续:跑 gen-wiki-board.mjs 补索引/看板;pre-commit 已按增量自动拦,此行用于改完即验)
-npx agentic-flow-kit doctor                        # §6.5 delegations + §6.6 owned 漂移 + §6.7 跨宿主薄适配正文漂移（装户环境；漂移用 add-host <宿主> --force 刷新。包源环境 §6.7 skipped）
-```
-
-> **环境注记**：本地服务占用构建产物导致编译失败、多会话并行时「谁跑静态门 / 提交谁先停服务」等约定——如有,见项目注记 `.agents/notes/runtime-env.md` §2,跑静态门前先过一眼。
-
-> **Windows / PowerShell 取码**：`bash` / `sh` 不在 PATH、命令不存在时 `$LASTEXITCODE` 保持旧值（假绿）——调法与取真码姿势见 `.agents/notes/runtime-env.md` §1(如有),断言「通过」前先确认命令真的跑了。
-
-任一失败 → 不进 UI 实测,回 `build.md` 修复;失败难复现(偶发/跨层)时先用 `diagnosing-bugs` 技能走诊断循环(红→最小化→假设→插桩→修复→回归),修复仍回 `build.md`。
-
-> **门禁 / 看板 / wiki 脚本改动**(`.agents/scripts/`、`.agents/hooks/`、`.agents/board/`):按改动对象跑对应 fixture 回归,须全绿——闭环门禁 `node .agents/scripts/check-loop.test.mjs`、wiki 生成器 `node .agents/scripts/gen-wiki-board.test.mjs`、提交前 hook 测试(如有);涉及看板告警规则时,用同批 workflow fixture 双跑 `check-loop`（经 shim 或 .mjs 直跑）与看板 `/api/board`,断言 hard-block 集合被看板告警覆盖(防口径分叉)。
-
-## 2. 切库冒烟(切换 / 新增目标库后必跑)
-
-改了项目数据库连接配置(或新增目标库)时,静态门不足以保证库-代码一致(编译 / 类型检查不连库;自动化测试覆盖受既有用例限制),必须额外两步:
-
-1. **schema 比对**:代码期望的表与列 vs 目标库实际 schema。范围 = 近期 schema 变更脚本涉及对象 + 项目基础 / 平台只读表(如有)
-2. **接口探活**:跑项目自有冒烟脚本(如有,脚本路径登记于根 `AGENTS.md`「项目适配区」;脚本不可用再手工逐个 GET 关键端点),任一非 200 即判库未同步,**停在此步,不部署**
-
-防复发条目的断言增量登记在 `workflow/regression-checklist.md`(如有)。
-
-## 3. UI 实测(涉及前端改动时)
-
-调用项目 UI 实测技能 `.agents/skills/verify-ui/SKILL.md`(如有)；环境细节(服务起法 / headless Chrome 参数 / CDP 注入 / 进程生命周期)见该技能与项目注记 `.agents/notes/runtime-env.md`(如有)。
-
-## 4. 独立复核(L2/L3 强制)
-
-- L2/L3 改动必须由 `independent-reviewer` 在独立上下文复核;宿主不支持子智能体时另开新会话,避免沿用原修改思路盲区
-- 复核者读入口文档(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 --doc workflow/intents/<本单>.md`（七门编排：语法/测试/编排检查/预算/生效规则视图/闭环/台账不变量，fail-fast 失败行留痕，非绿不关单）；**`--doc` 把绿凭证绑到本单**——不带它落下的绿行不给任何单背书，confirm-doc 前置与检查 8 只认带本单 `--doc` 的绿行（仅 v6+ 生效）；**全绿尾部自动落凭证并重生成 `workflow/verify-evidence.md`**（`effective-policy.md` 同为生成物——两者勿手改，policy/台账变更后重生成随同提交）；**装户仓**（当前目录无 `package.json`）测试门显式跳过且**不落测试绿凭证**（防假绿），按项目口径手工跑或带 `--test-cmd "<项目测试命令>"` 指定
-  - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」（例如：粘贴 CI 运行结果、UI 截图路径、或具体的 commit SHA），intent → done；同名 spec/Quick-Plan（若有）仍 approved → done。**注意：勾选但缺证据会被 check-loop 拦截（hard-block）**
-  - **approved 留痕提交**：done 确认前确认**本次关单文档**的 approved 态已进 git 历史（越早越好——approved 后即应提交；若尚未，先补提交再 done；门为逐份校验，三件套均关单时逐份各自满足）——confirm-doc 的 done 前置门硬校验（历史未出现「状态: approved」→ 拒绝落账）；done 后再提交 done 态与其余改动
-  - **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ done 内容绑定（关单编辑先于 done 确认、confirm-doc 是最后一次写入）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
-  - 修复：防复发验证已落地，incident → closed（经确认门 confirm-doc：open→fixed / fixed→closed 两跳、无单跳；2026-09-28 起 check-loop 15 对账——关单编辑先于 closed 确认，口径同 done 内容绑定）
-  - **沉淀草稿**：intent done / incident closed 后跑 `node .agents/scripts/draft-sediment.mjs workflow/<intents|incidents>/<本单>.md`——自动抽高价值节（intent：影响面/触达红线；incident：影响面/根因/为什么之前没拦住/复盘三件套）落 `wiki/drafts-archive/<日期-主题>/` 草稿、回写源文件 `沉淀` 字段、重跑 gen-wiki-board（归档计数随动，否则 verify-wiki-consistency 拦提交）。全占位单拒抽（正常，无沉淀价值）。`--dry-run` 先预览。草稿是**中间态**：人工读一遍归类到 `wiki/<主题>/`（补主题与用途、保留 `来源` 字段）后跑 gen-wiki-board + verify-wiki-consistency。沉淀是人工判断——机器只代抽与登记，值不值得入库由人定；不沉淀写 `沉淀: 无` 显式豁免（check-loop 的 `[WARN 未沉淀]` 随之消除）
-  - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）
-  - 主智能体自做的 L1+ 新需求在 `workflow/delegations.md`「自做任务结果表」记一行（修复类不重复记）
-  - **委派快照回写**：关单后若 `workflow/delegations.md` §月度聚合快照缺当月行或 doctor §6.5 报陈旧 → 跑 `node .agents/scripts/agg-delegations.cjs` 并回贴当月快照行
-- L1：本阶段结束，不进 deploy
-- L2/L3：仅当用户确认要上 prod 时进 `.agents/commands/deploy.md`

package/modules/hosts/codex/skills/flow-kit/SKILL.md

@@ -1,14 +0,0 @@
----
-name: flow-kit
-description: 按仓库内的 AI 闭环开工。用户说开工、走闭环、起 intent、起 spec 时使用。
----
-
-# flow-kit
-
-仓库根 AGENTS.md 是 Codex 自动读取的项目说明。阶段命令的权威正文在 .agents/commands/。
-
-- 总入口：.agents/commands/new-task.md
-- 与 Claude / Cursor 同形的薄转发，供显式引用：.codex/commands/wf-*.md
-- 角色薄转发：.codex/agents/*.md，行为以 .agents/roles/ 为准
-
-Codex 会装入本技能。.codex/commands 不会被注册成斜杠命令。

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

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