agentic-flow-kit 1.8.7 → 2.1.0

package/modules/gates/generated-readonly/check-generated.mjs

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-// 暂存 diff 不得改写 GENERATED:BEGIN / GENERATED:END 之间的行。
-// 区间按索引里的文件计算（git show :path），不读工作区。
-// 生成器重写该区域时设 FLOW_KIT_ALLOW_GENERATED=1。
-import { spawnSync } from 'node:child_process';
-
-if (process.env.FLOW_KIT_ALLOW_GENERATED === '1') process.exit(0);
-
-const git = process.platform === 'win32' ? 'git.exe' : 'git';
-const listed = spawnSync(git, ['diff', '--cached', '--name-only', '--diff-filter=ACMR'], { encoding: 'utf8' });
-if (listed.status !== 0) {
-  console.error('check-generated: git diff --cached 失败（需在 git 仓库的暂存区上运行）');
-  process.exit(1);
-}
-const diff = spawnSync(git, ['diff', '--cached', '-U0', '--'], { encoding: 'utf8' });
-if (diff.status !== 0) process.exit(1);
-
-function rangesOf(text) {
-  const out = [];
-  let start = -1;
-  String(text).split(/\n/).forEach((line, i) => {
-    if (line.includes('GENERATED:BEGIN')) start = i + 1;
-    else if (line.includes('GENERATED:END') && start > 0) {
-      out.push([start, i + 1]);
-      start = -1;
-    }
-  });
-  return out;
-}
-
-const files = new Map();
-let cur = null;
-for (const line of String(diff.stdout).split(/\n/)) {
-  const name = /^diff --git a\/(.+?) b\//.exec(line);
-  if (name) { cur = name[1]; if (!files.has(cur)) files.set(cur, []); continue; }
-  const hunk = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/.exec(line);
-  if (hunk && cur) files.get(cur).push([Number(hunk[1]), hunk[2] === undefined ? 1 : Number(hunk[2])]);
-}
-
-let bad = 0;
-for (const rel of listed.stdout.split(/\n/).map((s) => s.trim()).filter(Boolean)) {
-  const norm = rel.split('\\').join('/');
-  const shown = spawnSync(git, ['show', `:${norm}`], { encoding: 'utf8' });
-  if (shown.status !== 0) {
-    console.error(`${norm}: 读不到暂存内容`);
-    bad += 1;
-    continue;
-  }
-  const text = shown.stdout;
-  const ranges = rangesOf(text);
-  if (!ranges.length) continue;
-  for (const [start, len] of files.get(norm) || []) {
-    const from = start;
-    const to = len === 0 ? start : start + len - 1;
-    if (!ranges.some(([s, e]) => !(to < s || from > e))) continue;
-    console.error(`${norm}: 暂存改动落入 GENERATED 区（${ranges.map(([s, e]) => `${s}-${e}`).join('、')}）。生成器重写时设 FLOW_KIT_ALLOW_GENERATED=1`);
-    bad += 1;
-    break;
-  }
-}
-process.exit(bad ? 1 : 0);

package/modules/gates/generated-readonly/local-pre-commit.line

@@ -1 +0,0 @@
-node .agents/hooks/check-generated.mjs

package/modules/gates/node-layer/README.md

@@ -1,9 +0,0 @@
-# node-layer
-
-暂存的 `src/**/*.{js,mjs,cjs,jsx,ts,tsx}` 不得 `import` / `require` `tests/`、`test/` 或 `__tests__/`。
-
-```sh
-npx agentic-flow-kit add-gate node-layer
-```
-
-装进 `.agents/hooks/` 后归项目所有。目录名或更多禁引路径直接改脚本里的判断。

package/modules/gates/node-layer/check-node-layer.mjs

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-// 暂存区内 src/ 下的脚本不得引用 tests/、test/ 或 __tests__/。
-// 正文只读索引（git show :path），不读工作区。
-import { spawnSync } from 'node:child_process';
-
-const git = process.platform === 'win32' ? 'git.exe' : 'git';
-const listed = spawnSync(git, ['diff', '--cached', '--name-only', '--diff-filter=ACMR'], { encoding: 'utf8' });
-if (listed.status !== 0) {
-  console.error('check-node-layer: git diff --cached 失败（需在 git 仓库的暂存区上运行）');
-  process.exit(1);
-}
-const re = /['"](?:[^'"]*\/)?(?:tests?|__tests__)(?:\/[^'"]*)?['"]/;
-let bad = 0;
-for (const rel of listed.stdout.split(/\n/).map((s) => s.trim()).filter(Boolean)) {
-  const norm = rel.split('\\').join('/');
-  if (!norm.startsWith('src/') || !/\.(?:[cm]?js|jsx|tsx?)$/.test(norm)) continue;
-  const shown = spawnSync(git, ['show', `:${norm}`], { encoding: 'utf8' });
-  if (shown.status !== 0) {
-    console.error(`${norm}: 读不到暂存内容`);
-    bad += 1;
-    continue;
-  }
-  shown.stdout.split(/\n/).forEach((line, i) => {
-    if (!re.test(line)) return;
-    console.error(`${norm}:${i + 1}: src 不得引用 tests/、test/ 或 __tests__/`);
-    bad += 1;
-  });
-}
-process.exit(bad ? 1 : 0);

package/modules/gates/node-layer/local-pre-commit.line

@@ -1 +0,0 @@
-node .agents/hooks/check-node-layer.mjs

package/modules/gates/py-import/README.md

@@ -1,9 +0,0 @@
-# py-import
-
-暂存的业务 `.py`（路径中不含 `tests/` 或 `test/`）不得出现行首 `import tests`、`from tests`、`import test`、`from test`。
-
-```sh
-npx agentic-flow-kit add-gate py-import
-```
-
-这是边界的一个窄实现。更细的分层用项目自己的 import linter，按 `modules/gates/README.md` 的平铺约定挂上。

package/modules/gates/py-import/check-py-import.mjs

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-// 暂存的业务 .py（不在 tests/ 或 test/ 下）不得 import tests 或 test。
-// 正文只读索引（git show :path），不读工作区。
-import { spawnSync } from 'node:child_process';
-
-const git = process.platform === 'win32' ? 'git.exe' : 'git';
-const listed = spawnSync(git, ['diff', '--cached', '--name-only', '--diff-filter=ACMR'], { encoding: 'utf8' });
-if (listed.status !== 0) {
-  console.error('check-py-import: git diff --cached 失败（需在 git 仓库的暂存区上运行）');
-  process.exit(1);
-}
-const re = /^\s*(?:import|from)\s+(?:tests?|test)\b/;
-let bad = 0;
-for (const rel of listed.stdout.split(/\n/).map((s) => s.trim()).filter(Boolean)) {
-  const norm = rel.split('\\').join('/');
-  if (!norm.endsWith('.py')) continue;
-  if (norm.split('/').some((seg) => seg === 'tests' || seg === 'test')) continue;
-  const shown = spawnSync(git, ['show', `:${norm}`], { encoding: 'utf8' });
-  if (shown.status !== 0) {
-    console.error(`${norm}: 读不到暂存内容`);
-    bad += 1;
-    continue;
-  }
-  shown.stdout.split(/\n/).forEach((line, i) => {
-    if (!re.test(line)) return;
-    console.error(`${norm}:${i + 1}: 业务代码不得 import tests 或 test`);
-    bad += 1;
-  });
-}
-process.exit(bad ? 1 : 0);

package/modules/gates/py-import/local-pre-commit.line

@@ -1 +0,0 @@
-node .agents/hooks/check-py-import.mjs

package/modules/gates/test-protect/README.md

@@ -1,23 +0,0 @@
-# test-protect
-
-暂存 diff 若同时包含「测试文件」与「非测试文件」（即测试与代码同框改动），提交失败。
-
-fix/调试任务中，测试是「bug 已修」的证据；证据与结论同一次改动 = 自证，闭环失去意义。此门禁把
-「fix 不得改测试」从提示语变成机器红线，不依赖 agent 客户端自觉。
-
-```sh
-npx agentic-flow-kit add-gate test-protect
-```
-
-**测试文件识别**（脚本头部 CONFIG 可按项目扩展）：
-
-- 目录面：`tests/`、`__tests__/`、`test/`、`spec/`（任意层级）
-- 文件面：`*.test.*`、`*.spec.*`、`_test_*.py`（python pytest 风格）
-
-**豁免**（不是漏洞，是显式语义）：
-
-- 纯测试提交（只改测试文件，无代码同框）——新增/修正测试本身合法。
-- 显式声明 `FLOW_KIT_ALLOW_TEST_EDIT=1 git commit`——对应 plan 中显式标注「本次需同步演进测试」
-  （测试先行 / 行为断言变更）。门禁只判暂存面事实，语义归显式声明，不读任务元数据。
-
-**不拦截**：merge 提交无暂存 diff；工作区未暂存改动（提交面之外）。

package/modules/gates/test-protect/check-test-protect.mjs

@@ -1,64 +0,0 @@
-#!/usr/bin/env node
-// test-protect — 防 agent 自证清白时弱化测试（2026-10-10 调研 P1 test-protect）。
-// 语义：fix/调试任务中，同一提交不得既改被测代码又改它的测试文件——测试是「bug 已修」的证据，
-//       证据与结论同一次改动 = 自证，闭环失去意义（Anthropic playbook Stage 4：fix 任务禁止改测试文件）。
-// 判定范围：本次提交的暂存 diff（git diff --cached --name-only），只拦「测试文件」与「非测试文件」同框出现。
-// 豁免：
-//   - 显式声明 `FLOW_KIT_ALLOW_TEST_EDIT=1 git commit`（对应 plan 中显式标注「本次需同步改测试」——测试先行、行为断言变更属于合法测试演进）。
-//   - 纯测试提交（只改测试文件，无被测代码同框）——新增/修正测试本身合法。
-//   - 测试文件自身之间的改动（如 fixture、helper 互改）。
-// 设计（对照调研 P1）：独立 add-gate 模块，不进 check-loop 核心检查面（20 项纪律）；pre-commit 挂载点走 local-pre-commit，
-//       不依赖 agent 客户端自觉。本脚本不读任务元数据（plan 状态 / frontmatter）——门禁只判暂存面事实，语义归环境变量显式声明。
-// 实现零依赖、纯 Node ≥18。
-
-import { spawnSync } from 'node:child_process';
-
-// 测试文件识别：常见测试目录/文件命名。装户可按项目在脚本头部 CONFIG 扩展。
-// 目录面：tests/、__tests__/、test/、spec/（仓库根或任意层级）；文件面：*.test.*、*.spec.*、_test.*（python pytest 风格）。
-const TEST_DIR_RE = /(^|\/)(tests?|__tests__|spec|test)\//i;
-const TEST_FILE_RE = /\.(test|spec)\.[^.]+$/i;
-const PYTEST_FILE_RE = /(^|\/)_?test_[^/]+\.py$/i;
-
-function isTestFile(rel) {
-  const n = rel.replace(/\\/g, '/');
-  if (TEST_DIR_RE.test(n)) return true;
-  if (TEST_FILE_RE.test(n)) return true;
-  if (PYTEST_FILE_RE.test(n)) return true;
-  return false;
-}
-
-function git(args, cwd) {
-  const p = spawnSync('git', args, { cwd, encoding: 'utf8' });
-  return { exit: p.status ?? 1, stdout: p.stdout || '', stderr: p.stderr || '' };
-}
-
-function main() {
-  const root = process.env.FLOW_KIT_GIT_ROOT || process.cwd();
-  // 只判暂存 diff（提交面）；工作区未暂存改动不拦（与 generated-readonly / node-layer 同口径：暂存面即提交意图）
-  const r = git(['diff', '--cached', '--name-only', '--diff-filter=ACMR'], root);
-  if (r.exit !== 0) {
-    console.error('❌ test-protect：git diff --cached 失败（' + (r.stderr.trim() || '未知错误') + '）');
-    process.exit(1);
-  }
-  const files = r.stdout.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
-  if (!files.length) return; // 无暂存改动（如 merge 提交）不拦
-
-  const tests = files.filter(isTestFile);
-  const nonTests = files.filter((f) => !isTestFile(f));
-  if (!tests.length || !nonTests.length) return; // 纯测试提交 / 纯代码提交都合法
-
-  if (process.env.FLOW_KIT_ALLOW_TEST_EDIT === '1') {
-    console.log('ℹ️  test-protect：FLOW_KIT_ALLOW_TEST_EDIT=1 显式放行（测试与代码同框改动）');
-    return;
-  }
-
-  const sample = tests.slice(0, 5).join('、') + (tests.length > 5 ? ` 等 ${tests.length} 个` : '');
-  const codeSample = nonTests.slice(0, 3).join('、') + (nonTests.length > 3 ? ` 等 ${nonTests.length} 个` : '');
-  console.error(`❌ test-protect：提交同时改动测试与代码——「测试文件」${sample} 与「非测试文件」${codeSample} 同框。`);
-  console.error('   fix/调试任务中，测试是 bug 已修的证据；证据与结论同一次改动 = 自证，闭环失去意义。');
-  console.error('   若本提交确实需要同步演进测试（测试先行 / 行为断言变更），显式声明后重试：');
-  console.error('     FLOW_KIT_ALLOW_TEST_EDIT=1 git commit');
-  process.exit(1);
-}
-
-main();

package/modules/gates/test-protect/local-pre-commit.line

@@ -1 +0,0 @@
-node .agents/hooks/check-test-protect.mjs

package/modules/hosts/README.md

@@ -1,57 +0,0 @@
-# 宿主适配层
-
-七个宿主的薄适配层。`flow-kit init --hosts <列表>` / `flow-kit add-host <宿主>` 把对应目录铺进装户仓，
-`sync` 随包升级。权威源是 `templates/_agents/{commands,roles}/*.md`，本目录是**纯转发薄层**——
-换宿主不换流程。
-
-## 约定
-
-每个宿主目录两子层：
-
-| 层 | 文件 | 说明 |
-|---|---|---|
-| `agents/` | `<角色>.md` | 角色契约薄适配（全宿主无前缀，文件名 = 权威源文件名） |
-| `commands/` | `<prefix><命令>.md` | 命令层薄适配，文件名统一带宿主前缀（见下），避免裸占宿主顶层命名空间 |
-
-`commandPrefix`（`src/profiles.mjs#HOSTS` 单源）：opencode / trae / claude / cursor / codex 用 `wf-`；
-zcode / omp 无该字段——只有角色层适配，不参与 commands 权威源映射。
-
-## 现有宿主
-
-| 宿主 | 装户目录 | commands 层 | 宿主怎么读 |
-|---|---|---|---|
-| `zcode` | `.zcode/` | 无（仅角色） | `.zcode/agents/*.md` |
-| `opencode` | `.opencode/` | `wf-*` | `.opencode/{agents,commands}/*.md` |
-| `trae` | `.trae/` | `wf-*` | `.trae/{agents,commands}/*.md` |
-| `omp` | `.omp/` | 无（仅角色） | `.omp/agents/*.md` |
-| `claude` | `.claude/` | `wf-*` | `.claude/commands` + `.claude/agents` |
-| `cursor` | `.cursor/` | `wf-*` | `.cursor/commands` |
-| `codex` | `.codex/` | `wf-*` | 仓库根 `AGENTS.md` + `.codex/skills/`；`.codex/commands` 是同形薄转发，供显式引用 |
-
-> codex 另有 `skills/` 子层（宿主级技能辅助），见 `modules/hosts/codex/skills/`。
-
-七个宿主一律入库（2026-10-05 起撤销 localOnly）——换宿主不丢文件、CI 克隆面一致。zcode 的会话级
-液态草稿（`.zcode/drafts/`、`.zcode/plans/`）是本机态、不该入库，init 不自动写这条规则，装户自行加进
-`.gitignore`。
-
-## 对账
-
-权威源改一处，要同步到 N 份薄适配——人工 grep 易漏：
-
-```bash
-flow-kit sync-hosts --diff     # 权威源 vs 薄适配漂移报告（默认，不改盘面）
-flow-kit sync-hosts --apply    # 单向同步：权威源 → 薄适配（不反向，避免污染权威源）
-```
-
-包源仓（含 `templates/_agents` + `modules/hosts`）与装户仓（含 `.agents`）两种布局都可用——
-同一命令两处口径一致。装户侧等价体检在 `flow-kit doctor`（跨宿主薄适配正文段漂移校验）。
-
-## 加一个新宿主
-
-1. 在 `src/profiles.mjs#HOSTS` 注册：`dir`（装户目录名，带点）、`commandPrefix`（有命令层才填）。
-2. 建 `modules/hosts/<宿主>/`：`agents/*.md` 三角色薄适配（从现有宿主拷一份改 frontmatter/调用约定）；
-   有命令层再加 `commands/<prefix>*.md`。
-3. 权威源（`templates/_agents/{commands,roles}/`）不动——薄适配只转发，不复刻判据。
-4. 跑 `flow-kit sync-hosts --diff` 自查新增薄适配与权威源对齐；`npm test`（含 sync-hosts 套件与
-   doctor 跨宿主校验回归）。
-5. README「现有宿主」表与 `cli.mjs` HELP 的宿主清单随动。

package/modules/hosts/claude/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/claude/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/claude/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/claude/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/claude/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/claude/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`