agentic-flow-kit 1.8.7 → 2.1.0

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. 未解决的阻塞或剩余风险

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

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

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

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

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

@@ -1,69 +0,0 @@
----
-description: Build 阶段:起 plan + 实现代码 + 自验(确认后才动代码)
----
-
-> **装户边界**：本文档中 `src/`、`bin/flow-kit.mjs`、`templates/_agents/`、`modules/hosts/` 为 kit 包源仓视角引用——装户仓（无 `templates/` 包源）对应命令不适用，本仓以 `.agents/` 装副本为准。
-
-# Build · 起 plan + 写代码
-
-> AI 起草 plan,用户确认;进计划模式列改动,用户确认;最后才动代码。两道确认门。
-
-## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
-
-起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
-验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：plan 任务拆解与两道确认门位置。
-
-## 1. 执行
-
-### 1.1 起草 plan
-
-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 "<授权摘要>"` 每件单独一次——摘要为人类可读留痕,复用同句不削弱判据(分辨力由落账自动记录的改动面 `scope{files,sha256}` 与文档指纹承担,2026-10-09 起)。
-   **确认落态**：唯一入口 `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 的根因 / 防复发条目列入改动自查
-   - 列改动文件清单(读后改 vs 新建)
-   - 列步骤(改 X 文件做 Y → 改 Z 文件做 W)
-   - **owned 文件同步**：kit.owned 列表文件（AGENTS.md / workflow 模板等）sync 不动，须列「手动同步装副本」步骤（仅包源/dogfood 双形态仓适用；纯装户仓 owned 即项目自有文件，无此步）
-   - 标注触达红线(对照根 `AGENTS.md` 红线/约束相关节（如「项目适配区」「门禁与提交」）+ 改动域目录级 `AGENTS.md`（如有）)
-6. 停下,等用户确认改动清单。
-
-### 1.3 实现
-
-7. 确认后按 plan 顺序推进;每个任务对照判据自验。若任务满足 `.agents/roles/implementer.md` 的边界,主智能体可将单个工作包连同必读材料、授权文件和验收条件委派给 `implementer`;否则由主智能体执行。
-8. 自验:按改动域跑 `项目构建命令` / `项目类型检查命令` / `项目测试命令`(对应编译 / 前端类型检查 / 自动化测试;静态门全集见 `test.md` §1);范围对账 `node .agents/scripts/check-scope.mjs workflow/plans/YYYY-MM-DD-<主题>.md`——越界件(改了未声明)即收口(回填 plan 或回滚),plan 不可读 exit 2;默认 advisory exit 0,`--strict` 供门禁化调用。
-9. **项目架构红线**:数据访问模式、公共字段写入等以根与目录级 `AGENTS.md`(如有)红线为准,不自创旁路。
-10. **L3 且含 schema 变更时**:schema 变更走项目约定的维护方式(人工 SQL / 迁移工具,以目录级 `AGENTS.md` 或 spec 约束为准),不得擅自引入项目未采用的迁移机制（仅运行时 / 管线类 L3 无此约束）。
-11. 实现中若需偏离已确认的 plan(改公共接口 / 动 plan 未列文件 / 引新依赖 / 影响任务判据)→ 停下,向用户说明原因与影响,确认后再继续。
-
-## 2. 技能辅助(可选,宿主级 skills)
-
-- plan 任务多、依赖复杂时:用 `to-tickets` 拆 tracer-bullet 任务单(每张带阻塞边);结果回填 plan「任务拆解」节,不发布外部 tracker
-- 后端逻辑改动:有测试基建的用 `tdd` 测试先行(红→绿→重构);整体实现纪律可用 `implement` 驱动
-- 遇合并冲突:用 `resolving-merge-conflicts` 按意图逐 hunk 处理
-- 技能不改变两道确认门、红线检查与委派边界
-
-## 3. 红线提示(本阶段高频踩)
-
-- 红线(架构 / 数据 / 安全等)正文与豁免见根与目录级 `AGENTS.md`(如有)——已由 pre-commit 机器门强制的部分以钩子为准，写代码前先过一遍目录级 AGENTS
-
-## 4. 子代理调用约定
-
-- plan 起草、风险判断、改动清单与两道确认门由主智能体负责;仅两道确认后范围明确的工作包可委派 `implementer`,公共接口 / Schema / 依赖 / 安全 / 权限 / 破坏性操作不得委派。
-- 多工作包并行 / 链式推进:编排机制(声明随 plan 草稿一并确认;确认后读 `.agents/workflows/` 按机制文档执行,`steps/` 为项目自定义步骤扩展点);详见 `.agents/workflows/_TEMPLATE.md`。
-- 子智能体返回后,主智能体须检查 diff 与授权文件范围、确认未覆盖既有修改并重跑相关验证;不支持子智能体时 `fallback: main`,验收标准不变。
-
-## 5. 确认后
-
-- plan 状态保持 `approved`，**不在此置 `done`**——实现完成 ≠ 关单；`done` 在 `test.md` §6 验收勾验后经 confirm-doc 置（intent / spec / 修复的同名 plan 亦在 test 一并收口；build 直跳 `done` 会绕过确认门、触发检查 15 指纹对账）
-- commit：L1+ 入口文档 / spec / plan 随代码同一提交（Conventional Commits 中文 feat/fix/refactor/perf）；docs 豁免与 bootstrap 可单独 `docs(*)`
-- 进 `next: .agents/commands/test.md`

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

@@ -1,58 +0,0 @@
----
-description: Deploy 阶段:prod 上线清单(静态门 + 配对检查 + 回归 + DB + 授权 + 24h 观察；文档关单在 test)
----
-
-# Deploy · 上线清单
-
-> 仅 prod。文档关单（验收勾验 / intent done）在 `test.md`，本阶段不重复关单。个人工作流:唯一授权人是用户本人——上线授权 = 用户一句确认 + `release/<日期>` tag 留痕,追溯靠 git,不依赖第二人审批。
-> 环境定位:dev 为开发自测;staging 即人工验证环境(不设独立发布门);prod 上线必须过本清单。
-
-## 1. 静态门(必跑,全过方可继续)
-
-同 `test.md` §1(静态门全集:`项目构建命令` / `项目测试命令` / `项目类型检查命令` 与项目自有门禁;含环境注记与 Windows 取码注记),逐条跑完再继续。
-
-## 2. 文档闭环(必查)
-
-- L2 / L3 变更:入口文档(`workflow/intents/` 或 `workflow/incidents/`) + `workflow/specs/` + `workflow/plans/` 三件同名配对齐全；intent/spec/plan 状态为 done（test 已关单）。若仍为 approved，先回 `test.md` 补关单再上
-- 若属修复:`workflow/incidents/` 同时须满足复盘三件套完整(结构性修复 / 防复发验证 / 规范条目)，状态 closed
-- 新 intent 是否已立:根因属门禁缺位 / 规范未落地 / 系统性问题时强制立(即使修复已完成)
-
-## 3. 回归清单(必过)
-
-- `workflow/regression-checklist.md` 中涉及模块的关键路径条目全过
-- 项目自动化测试用例全过(`项目测试命令`;不得跳过失败用例)
-- 历史同类 incident 的防复发验证条目(清单「防复发验证」节)逐条过
-
-## 4. 数据库(若涉及 schema 变更)
-
-- 迁移 SQL 已按项目约定的 schema 变更流程验证并留档
-- 实体映射与迁移 SQL 已人工核对一致
-- 备份点已记录 + 回滚 SQL 就绪(L3 且含 schema 变更时强制)
-
-## 5. 上线授权(用户本人最后一关)
-
-- 授权人:用户本人(个人工作流,无第二审批人);对话内一句"上"即授权
-- 授权记录:打 `release/<日期>` tag + commit SHA——tag 是「prod 跑的是哪个 commit」的追溯依据,`git log` 可查
-- 发布流水线(可选):若项目 CI/CD 配置了人工审批卡点,按提示在流水线平台自行批准;批准人仍是本人,不构成第二人评审
-- 回滚决策人:用户本人
-- 回滚预案(按 L3 类型分叉):含 schema 变更 → <备份点 + 回滚 SQL 路径>;仅运行时 / 管线(无 schema,如认证管线 / DI 注册 / 中间件) → 回退上一 `release/<日期>` tag + 配置开关回退
-- 回滚 SQL 必须在 dev 演练执行过(没跑过的回滚脚本等于没有);回退版本类预案须确认上一 tag 可复现构建
-
-## 6. 上线后观察(用户观察,Maintain 阶段接手)
-
-- 观察期:上线后 24h;由用户观察错误率 / 延迟 / 关键业务流(无监控时人工看)
-- 异常判据(观察期退出规则):项目口径填 `workflow/regression-checklist.md`——无监控时的最低判据:错误日志 / 异常告警 / 关键业务流失败**任一出现即触发 §5 回滚预案,不等 24h**;无异常满 24h 方可闭环
-- 闭环宣告:用户确认无异常后才算闭环;AI 不得自行宣告
-- 异常回落:超阈值 → 生成 `workflow/incidents/YYYY-MM-DD-<主题>.md`,进 `maintain.md`(止血方案用户拍板,见 maintain.md §0)
-- 事故响应:单用途账号 + 最小权限;不得跨智能体协作推送修复(参考 Anthropic 教训)
-
-## 7. 子代理调用约定
-
-- 上线清单、回滚方案、授权、tag 与事故决策均由主智能体处理,本阶段不委派子智能体;回滚方案(尤其含数据回滚 SQL)涉及数据安全,不得以通用实现子智能体代替主智能体判断与用户确认。
-
-## 8. 确认后
-
-- 打 `release/<日期>` tag（commit SHA 可追溯）
-- 上线 + 用户观察 24h
-- 用户确认无异常 → prod 闭环（文档 done 应已在 test 写好；若漏写在此补勾验收并置 done）
-- 异常 → 进 `next: .agents/commands/maintain.md`

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

@@ -1,49 +0,0 @@
----
-description: Design 阶段:起 spec(L2/L3 强制,L1 可省略)
----
-
-# Design · 起 spec
-
-> L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
-
-## 0. 三件套合并预览（L2/L3 起草期，2026-10-09 engine-quality-round2 C）
-
-起草 intent / spec / plan 任一件后，**在输出草稿全文前先给三件要点总览**（各一件：目标 / 关键取舍 /
-验收判据 diff，合计 ≤12 行）——用户一次看整体再逐件拍板，省三次盲确认的上下文切换。
-确认纪律不变：逐件过目全文 + 逐件 `confirm-doc` 代录（禁并录；摘要可复用——分辨力由 scope+指纹承担，2026-10-09 起）。本阶段总览侧重：spec 方案取舍与 L3 复核安排。
-
-## 1. 执行
-
-1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）。
-2. 级别判断(对照 AGENTS.md 第 3 条;判据单源 = `.agents/scripts/level-criteria.mjs`，**本文件只承载流程映射，不复述判据闭集**):
-   - **L1**（未命中 L2/L3）→ 快车道：省略 spec，直接跳 `next: build.md` 起草 Quick-Plan
-   - **L2**（触达面闭集见单源 `L2_SURFACES`）→ 必须有 spec
-   - **L3**（结构面闭集见单源 `L3_SURFACES`）→ 必须有 spec + **新会话独立复核**
-   - 判哪一档：逐条对照单源的 `L2_SURFACES` / `L3_SURFACES` / `L1_NEGATIVES`，不要凭记忆——判据只读单源一处
-3. 起草 spec:
-   - **填空工具先跑**：`node .agents/scripts/fill-spec.mjs --level <L1|L2|L3> --topic <主题> --output workflow/specs/<date>-<主题>.md`——输出含 frontmatter 5 字段 + 5 节正文（功能行为/数据流/系统改动/约束遵守映射/风险评估）的草稿；AI 据此填实
-   - 复制 `workflow/specs/_TEMPLATE.md` → `workflow/specs/YYYY-MM-DD-<主题>.md`(与入口文档同名)
-   - 按 5 节填写:功能行为 / 数据流 / 系统改动 / 约束遵守映射 / 风险评估
-   - 约束映射必须对照根 `AGENTS.md` 红线与「工程原则」节及约束相关节（如「项目适配区」「门禁与提交」）与改动域目录级 `AGENTS.md`（如有）逐条说明如何满足
-   - 存在多个可行方案时,在 spec 中列出各方案取舍与 AI 建议项,由用户选定后方可确认
-   - **页面/交互入口形态必须用户确认**:spec 须写明入口是「表单（字段清单）」还是「选择器/弹窗」，禁止自行推定交互形态
-4. 起草后停下,输出草稿全文给用户过目。
-5. L3 必须独立复核:宿主支持子智能体时调用 `independent-reviewer`,并要求其读取 `.agents/roles/independent-reviewer.md`;不支持时另开新会话。复核者读 spec + 根 AGENTS.md 与改动域目录级 AGENTS.md 的红线挑漏洞,结论写入 spec「确认与复核」节;复核未过不得确认。
-
-## 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
-- **确认落态**：唯一入口 `node .agents/scripts/confirm-doc.mjs <path>`（draft→approved / approved→done；TTY 两形态 / 逐件代录（摘要可复用——分辨力由 scope+指纹承担）/ 台账对质全口径见根 `AGENTS.md` §1.3 确认门）。
-- 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
-- 进 `next: .agents/commands/build.md`

package/modules/hosts/cursor/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，装户径不引实例路径