agentic-flow-kit 1.8.2 → 2.0.0

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

@@ -1,36 +0,0 @@
----
-name: wf-pipeline-run
-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/trae/commands/wf-plan.md

@@ -1,41 +0,0 @@
----
-name: wf-plan
-description: Plan 阶段 · 立 intent（AI 起草、用户确认；本阶段不委派子智能体）
----
-
-# 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/trae/commands/wf-review.md

@@ -1,50 +0,0 @@
----
-name: wf-review
-description: Review · 代码评审（横切，合入前使用；P0/P1/P2 分级清单 + 用户定性与合入时机）
----
-
-> **装户边界**：本文档中 `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/trae/commands/wf-sync-hosts.md

@@ -1,65 +0,0 @@
----
-name: wf-sync-hosts
-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/trae/commands/wf-test.md

@@ -1,69 +0,0 @@
----
-name: wf-test
-description: Test 阶段 · 静态门 + 切库冒烟 + UI 实测 + L2/L3 独立复核（关单在本阶段）
----
-
-> **装户边界**：本文档中 `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/trae/hooks/post-edit-check.cjs

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-/**
- * PostToolUse(Edit|Write) hook — 编辑 .cs 文件后即时跑架构红线检查
- *
- * Trae 宿主事实：PostToolUse 不能撤销已完成的编辑，但可用 hookSpecificOutput.additionalContext
- * 把违例喂回模型，让它在提交前自行修掉；硬阻断在 PreToolUse 的 pre-shell-check.cjs（走 .githooks/pre-commit）。
- *
- * stdin: { tool_name, llm_tool_name, tool_input: { file_path, ... }, cwd, workspace_roots, ... }
- */
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-const { resolveShell } = require('./resolve-shell.cjs');
-
-// --- 读取 stdin ---
-let raw = '';
-try {
-  raw = fs.readFileSync(0, 'utf8');
-} catch {
-  process.exit(0);
-}
-
-let data;
-try {
-  data = JSON.parse(raw);
-} catch {
-  process.exit(0);
-}
-
-const toolName = `${data.tool_name || ''} ${data.llm_tool_name || ''}`;
-if (!/edit|write/i.test(toolName)) {
-  process.exit(0);
-}
-
-// 文件路径字段名跨宿主/版本可能不同，逐个候选取第一个命中的
-function extractFilePath(input) {
-  if (!input || typeof input !== 'object') return '';
-  for (const k of ['file_path', 'filePath', 'path', 'target_file', 'file']) {
-    if (typeof input[k] === 'string' && input[k]) return input[k];
-  }
-  return '';
-}
-
-const filePath = extractFilePath(data.tool_input);
-if (!/\.cs$/i.test(filePath)) {
-  process.exit(0); // 非 .cs 文件，跳过
-}
-
-const projectRoot = data.cwd || (Array.isArray(data.workspace_roots) && data.workspace_roots[0]) || process.cwd();
-
-const shellBin = resolveShell();
-if (!shellBin) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PostToolUse',
-      additionalContext: '⚠️ 架构红线检查未执行：未找到可用的 bash / sh。安装 Git for Windows 后重试，或提交前手动跑 .agents/hooks/check-architecture.sh。'
-    }
-  }));
-  process.exit(0);
-}
-
-// timeout 单位是毫秒：架构检查实测约 0.6 秒，30 秒预算够用；
-// （2026-09-19 修复：原值 30 是 30 毫秒，必然 ETIMEDOUT，导致每次 .cs 编辑都误报「发现违例」）
-try {
-  execFileSync(shellBin, ['.agents/hooks/check-architecture.sh'], {
-    cwd: projectRoot, stdio: ['ignore', 'pipe', 'pipe'], timeout: 30000
-  });
-  // 通过，无输出
-} catch (e) {
-  if (e.code === 'ETIMEDOUT') {
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext: '⚠️ 架构红线检查超时（30 秒）：本次编辑未验证，请在提交前手动跑 .agents/hooks/check-architecture.sh。'
-      }
-    }));
-    process.exit(0);
-  }
-  // 门禁脚本未装（未跑 add-gate dotnet-ca）≠ 发现违例——区分口径，对齐 pre-shell-check 的 ENOENT 处理（2026-09-24）；
-  // status 127 同义（2026-09-27 host-gates-p1 P2-B4：存在的 bash 跑缺失脚本返回 127 而非 ENOENT，实测原分支不可达）
-  if (e.code === 'ENOENT' || e.status === 127) {
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext: '⚠️ 架构红线检查未执行：check-architecture.sh 未安装（flow-kit add-gate dotnet-ca 装入）——本次编辑未验证。'
-      }
-    }));
-    process.exit(0);
-  }
-  const err = String((e.stderr || '') + (e.stdout || '')).slice(0, 800);
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PostToolUse',
-      additionalContext: `⚠️ 架构红线检查发现违例（check-architecture.sh）：\n${err}\n请在提交前修复；硬阻断在 git commit 时执行。`
-    }
-  }));
-}
-
-process.exit(0);

package/modules/hosts/trae/hooks/pre-shell-check.cjs

@@ -1,192 +0,0 @@
-#!/usr/bin/env node
-/**
- * PreToolUse(RunCommand) hook — 两道关卡：
- * 1) deny/ask 命令门禁（口径同 .agents/settings.json 的 deny/ask 策略）
- * 2) git commit / git push 前置检查：直接调 .githooks/pre-commit / pre-push
- *
- * 为什么调 .githooks/*：那是项目唯一的门禁权威（pre-commit 门禁链 + pre-push 闭环断档）。
- * 本钩子是**宿主侧冗余**——core.hooksPath 漏配时 git 侧门禁静默失效（2026-09-16 Trae 侧缺档事故），
- * 由这里在命令执行前拦下；门禁清单只维护 .githooks/ 一份，本文件不复制。
- *
- * Trae 宿主事实（docs.trae.ai/ide/hook-configuration-reference）：
- *   - 终端工具的 matcher 名是 RunCommand（不是 Shell/Bash）；timeout 单位是**秒**。
- *   - stdin: { session_id, cwd, hook_event_name, workspace_roots, tool_use_id, tool_name, llm_tool_name, tool_input }
- *   - stdout: hookSpecificOutput.permissionDecision = allow / deny / ask；无输出 = 放行。
- */
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-const { resolveShell } = require('./resolve-shell.cjs');
-
-// --- 读取 stdin ---
-let raw = '';
-try {
-  raw = fs.readFileSync(0, 'utf8');
-} catch {
-  process.exit(0); // 无 stdin，放行
-}
-
-let data;
-try {
-  data = JSON.parse(raw);
-} catch {
-  process.exit(0); // JSON 解析失败，放行（不阻塞正常工作流）
-}
-
-// 工具名兼容：Trae 规范化名为 RunCommand，llm_tool_name 为原始名；保留 Claude 风格别名防宿主差异
-const toolName = `${data.tool_name || ''} ${data.llm_tool_name || ''}`;
-if (!/runcommand|bash|shell|terminal|executecommand/i.test(toolName)) {
-  process.exit(0);
-}
-
-// 取命令文本：优先约定的 command 字段；字段名缺失时退回扫描 tool_input 的字符串值
-// （信任边界上的宿主 payload，字段名跨版本可能不同——漏读会让门禁静默失效，故兜底扫描）
-function extractCommand(input) {
-  if (!input || typeof input !== 'object') return '';
-  if (typeof input.command === 'string' && input.command) return input.command;
-  return Object.values(input).filter(v => typeof v === 'string').join('\n');
-}
-
-const command = extractCommand(data.tool_input);
-if (!command) {
-  process.exit(0);
-}
-
-const projectRoot = data.cwd || (Array.isArray(data.workspace_roots) && data.workspace_roots[0]) || process.cwd();
-
-function deny(reason) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PreToolUse',
-      permissionDecision: 'deny',
-      permissionDecisionReason: reason
-    }
-  }));
-  process.exit(0);
-}
-
-function ask(reason) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PreToolUse',
-      permissionDecision: 'ask',
-      permissionDecisionReason: reason
-    }
-  }));
-  process.exit(0);
-}
-
-// ── 1) deny/ask 命令门禁 ──────────────────────────────
-// 清单权威源 = .agents/settings.json（p2-batch2 对齐：旧清单多抄了一项 'dotnet ef' 造成双源漂移——
-// settings.json 无此项；EF Migrations 禁令属 dotnet-ca 门禁域，如需恢复请先加进 settings.json 再同步此处）
-const denyList = [
-  { pat: 'git reset --hard',  reason: '禁破坏性重置' },
-  { pat: 'drop database',     reason: '禁删库' }
-];
-const askList = [
-  { pat: 'git checkout',  reason: '可能切换/丢弃工作区改动' },
-  { pat: 'git clean',     reason: '可能删除未跟踪文件' },
-  { pat: 'git branch -D', reason: '可能删除未合并分支' },
-  { pat: 'rm -rf',        reason: '可能递归删除文件' }
-];
-
-// stripMessages：剥 -c/-m 的值（含引号整段）——deny/ask 门与强推检测共用，防 commit 消息字样误触发
-function stripMessages(cmd) {
-  return cmd
-    .replace(/(^|\s)-[cm]\s+"[^"]*"(?=\s|$)/g, ' ')
-    .replace(/(^|\s)-[cm]\s+'[^']*'(?=\s|$)/g, ' ')
-    .replace(/(^|\s)-[cm]\s+\S+(?=\s|$)/g, ' ')
-    .replace(/\s+/g, ' ').trim();
-}
-
-// 强推检测 token 化（2026-09-27 host-gates-p1 P1-B2）：子串模式 'git push --force' 挡不住换序
-// （git push origin main --force）与 +refspec 变体（git push origin +main）——改为 token 级判定。
-// 复核 P2 收窄（同日）：①按 &&/||/;/| 分段，--force 只在 push 段内计数（dotnet build --force 不误并）；
-// ②组合短旗标（-vf）与 -f 同为 force；③--force-with-lease 是带尾巴的独立 token 不匹配。
-// p2-batch2 补：先剥 commit 消息（引号感知）再分段——"git commit -m "修 push --force"" 曾被误拦。
-// 本钩子是 core.hooksPath 漏配时的主要强推执行点，语义必须完整。
-function isForcePush(cmd) {
-  const stripped = stripMessages(cmd);
-  return stripped.split(/&&|\|\||;|\|/).some((seg) => {
-    const tokens = seg.replace(/\s+/g, ' ').trim().split(' ').filter(Boolean);
-    if (!tokens.includes('push')) return false;
-    return tokens.some((t) => t === '--force'
-      || (t.startsWith('-') && !t.startsWith('--') && /^-[a-zA-Z]*f/.test(t))
-      || (t.startsWith('+') && t.length > 1));
-  });
-}
-
-// gateMatch：比裸 includes 收紧三处（2026-09-24；p2-batch2 补 ③）——
-//   ① token 边界：'git checkout' 不再误吃 'git commit-msg'
-//   ② 剥离 git 全局参 -c <k=v> 与 -m <msg> 后以剥后文本为准——堵 'git -c x=y reset --hard' 绕过
-//   ③ 消息字样误触（p2-batch2）：带引号多词消息（-m "修 git push --force 误拦"）单 token 剥不净——
-//     剥离逻辑收敛到 stripMessages 单源（引号感知）
-function gateMatch(cmd, pat) {
-  const re = new RegExp(pat.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '(?![\\w-])');
-  const norm = stripMessages(cmd);
-  return norm !== cmd ? re.test(norm) : re.test(cmd);
-}
-
-if (isForcePush(command)) {
-  deny('禁止执行: git push 强制推送（--force / -f / +refspec；项目红线：禁强制推送）');
-}
-for (const d of denyList) {
-  if (gateMatch(command, d.pat)) {
-    deny(`禁止执行: ${d.pat}（项目红线：${d.reason}）`);
-  }
-}
-for (const a of askList) {
-  if (gateMatch(command, a.pat)) {
-    ask(`需确认: ${a.pat}（项目 ask 策略：${a.reason}）`);
-  }
-}
-
-// ── 2) git commit / git push 前置检查 ──────────────────
-const isCommit = /git\s+commit/.test(command);
-const isPush = /git\s+push/.test(command);
-
-if (!isCommit && !isPush) {
-  process.exit(0); // 非 commit/push，放行
-}
-
-const shellBin = resolveShell();
-if (!shellBin) {
-  deny('门禁未执行：未找到可用的 bash / sh——请安装 Git for Windows，或在 Git Bash 终端手动跑 .githooks/pre-commit');
-}
-
-// runGate：把 .githooks/ 门禁原始输出透传给 AI；未执行（脚本缺失）与判定失败分开报，避免把 ENOENT 误报成代码违例
-// 127 分支（2026-09-27 host-gates-p1 P2-B4）：shell 报 127 = 脚本未装（二进制已在 resolveShell 预检排除）——
-// 实测 ENOENT 分支不可达（execFileSync 对存在的 bash 跑缺失脚本返回 status 127 而非 e.code ENOENT）
-function runGate(scriptRelPath, label, budgetMs) {
-  try {
-    execFileSync(shellBin, [scriptRelPath], {
-      cwd: projectRoot,
-      stdio: ['ignore', 'pipe', 'pipe'],
-      timeout: budgetMs
-    });
-  } catch (e) {
-    if (e.code === 'ETIMEDOUT') {
-      deny(`${label}超时（${scriptRelPath}，${Math.round(budgetMs / 1000)} 秒未完成）——检查 dotnet build / npm run build 是否卡住`);
-    }
-    if (e.code === 'ENOENT' || e.status === 127) {
-      deny(`门禁未执行（${label}）：${scriptRelPath} 不可达——确认仓库完整后重试`);
-    }
-    const err = String((e.stdout || '') + (e.stderr || '')).slice(0, 1200);
-    deny(`${label}未通过（${scriptRelPath}）：\n${err}`);
-  }
-}
-
-if (isCommit) {
-  // pre-commit 门禁链（通用包口径）：闭环配对（增量）+ wiki 台账（增量）+ 常驻面预算 + 项目门禁（local-pre-commit）+ 敏感信息扫描与条件构建
-  // 预算 5 分钟覆盖 dotnet build / npm run build（.githooks/pre-commit 内部无超时）
-  runGate('.githooks/pre-commit', '提交前门禁', 300000);
-}
-
-if (isPush) {
-  // pre-push：check-loop.sh 扫 workflow/ 闭环断档（hard-block = 配对断裂 / 回路断档 / 新建 done 未勾验）
-  // 预算 7 分钟：2026-09-19 实测 check-loop.sh 全量扫描耗时 2 分 53 秒（231 任务卡），
-  // 原定 2 分钟会误报超时——不要按「脚本应该很快」调小
-  runGate('.githooks/pre-push', '推送前闭环扫描', 420000);
-}
-
-// 全部通过，放行
-process.exit(0);

package/modules/hosts/trae/hooks/resolve-shell.cjs

@@ -1,30 +0,0 @@
-// shell 探测（供 .trae/hooks/ 各钩子共用）
-// Windows 下 bash 常不在 PATH：优先 Git Bash 绝对路径，回退 PATH 的 bash/sh。
-// 返回 null 表示不可用——调用方须 fail-closed 报告「门禁未执行」，不要当成检查通过。
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-
-function resolveShell() {
-  const candidates = [
-    'C:\\Program Files\\Git\\bin\\bash.exe',
-    'C:\\Program Files (x86)\\Git\\bin\\bash.exe'
-  ];
-  for (const p of candidates) {
-    try { fs.accessSync(p); return p; } catch { /* 尝试下一个 */ }
-  }
-  // PATH 回退须避开 WSL 启动器：C:\Windows\System32\bash.exe 能过 exit 0 探测，但路径/行尾语义是 Linux 侧的（2026-09-24）
-  for (const c of ['bash', 'sh']) {
-    let cand = c;
-    try {
-      const hits = execFileSync('where.exe', [c], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] })
-        .split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
-      const good = hits.find((p) => !/system32/i.test(p)); // 全部命中都在 System32（纯 WSL）→ 跳过该候选
-      if (good) cand = good;
-      else continue;
-    } catch { /* where 不可用（非 Windows）：按原名探测，保持旧行为 */ }
-    try { execFileSync(cand, ['-c', 'exit 0'], { stdio: 'pipe', timeout: 5000 }); return cand; } catch { /* 尝试下一个 */ }
-  }
-  return null;
-}
-
-module.exports = { resolveShell };

package/modules/hosts/trae/hooks.json

@@ -1,29 +0,0 @@
-{
-  "version": 1,
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "RunCommand|Bash|Shell|Terminal",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .trae/hooks/pre-shell-check.cjs",
-            "timeout": 800
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .trae/hooks/post-edit-check.cjs",
-            "timeout": 60
-          }
-        ]
-      }
-    ]
-  }
-}

package/modules/hosts/trae/rules/beautify-input-chinese.md

@@ -1,6 +0,0 @@
----
-alwaysApply: false
-scene: beautify_input
----
-
-请使用中文回复。所有解释、说明、注释和对话均使用中文。

package/modules/hosts/trae/rules/git-commit-message.md

@@ -1,10 +0,0 @@
----
-alwaysApply: false
-scene: git_message
----
-
-提交信息一律中文，遵循 Conventional Commits：`<类型>(<范围>): <说明>`，例如 `fix(采购订单): 页签切换浮层收纳`、`docs(trae): 同步工作流适配层`。
-
-- 类型枚举：feat / fix / docs / style / refactor / perf；`.githooks/commit-msg` 按此硬校验首行，非枚举前缀会被拦下，merge / revert 提交豁免。
-- 范围可省：`fix: 说明` 同样合法；分隔符 `:` 或 `（` 均可。
-- 禁止 `[feat] 说明` 这类方括号写法。