agentic-flow-kit 1.8.2 → 2.0.0

package/templates/_agents/scripts/workflows-check.test.mjs

@@ -1,278 +0,0 @@
-#!/usr/bin/env node
-// workflows-check.test.mjs — 编排脚本 lint 测试（2026-09-25 workflows-linter）
-// 方法：fixture 临时目录（.agents/workflows/*.md + roles/ + steps/ 词表）调 lintWorkflows() 拿结构化结果，
-//       不依赖真实仓库文件；末两个场景对真实仓库自扫做 baseline 断言。
-// 判据：error 10 类各至少一场景命中；advisory 3 类各一场景；_ 前缀排除；真实仓库 0 error。
-// 用法：node templates/_agents/scripts/workflows-check.test.mjs（npm test 随跑）
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { lintWorkflows } from './workflows-check.mjs';
-
-let pass = 0;
-let fail = 0;
-const check = (desc, cond, detail = '') => {
-  if (cond) { pass++; console.log(`PASS  ${desc}`); }
-  else { fail++; console.log(`FAIL  ${desc}${detail ? '\n      ' + detail : ''}`); }
-};
-
-const HEAD = '| id | after | role | step | task / params | files（授权） | accept（验收判据） | gate | retries |';
-const SEP = '|----|-------|------|------|---------------|--------------|-------------------|------|---------|';
-
-// mkfix：建临时根 + 词表（roles: implementer/reviewer；steps: deploy）+ 指定编排脚本集合
-const mkfix = (scripts) => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'wf-lint-test-'));
-  fs.mkdirSync(path.join(root, '.agents', 'workflows', 'steps'), { recursive: true });
-  fs.mkdirSync(path.join(root, '.agents', 'roles'), { recursive: true });
-  for (const r of ['implementer', 'independent-reviewer']) {
-    fs.writeFileSync(path.join(root, '.agents', 'roles', `${r}.md`), `# ${r}\n`);
-  }
-  fs.writeFileSync(path.join(root, '.agents', 'workflows', 'steps', 'deploy.md'), '# deploy\n');
-  for (const [name, body] of Object.entries(scripts)) {
-    fs.writeFileSync(path.join(root, '.agents', 'workflows', name), body);
-  }
-  return root;
-};
-const fm = (extra = '') => `---\nname: t\ndescription: t\n${extra}---\n\n# w\n\n`;
-
-// ---- S1 全绿：双 role 并行 + 汇聚 gate → 0 error 0 warning ----
-{
-  const root = mkfix({
-    'ok.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | implementer | — | 做 A | src/a/** | 测试过 | | 1 |\n' +
-      '| b | — | implementer | — | 做 B | src/b/** | 构建过 | | 0 |\n' +
-      '| g | a,b | — | — | — | — | — | npm test | |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S1 全绿（并行 role + 汇聚 gate）→ 0 error 0 warning',
-    r.errorCount === 0 && r.warningCount === 0 && r.files.length === 1,
-    JSON.stringify(r.files[0]));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S2 after 悬空引用 → E5 ----
-{
-  const root = mkfix({
-    'dangling.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | ghost | — | — | — | — | — | npm test | |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S2 after 引用不存在 → E5',
-    r.errorCount === 1 && r.files[0].errors[0].startsWith('E5') && r.files[0].errors[0].includes('ghost'),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S3 after 成环 → E6 ----
-{
-  const root = mkfix({
-    'cycle.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | b | — | — | — | — | — | npm test | |\n' +
-      '| b | a | — | — | — | — | — | npm test | |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S3 after 依赖成环 → E6',
-    r.errorCount === 1 && r.files[0].errors[0].startsWith('E6'),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S4 未知 role → E7（词表只有 implementer / independent-reviewer）----
-{
-  const root = mkfix({
-    'role.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | hacker | — | 做 A | src/** | 过 | | |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S4 role 不在 .agents/roles/ → E7',
-    r.errorCount === 1 && r.files[0].errors[0].startsWith('E7') && r.files[0].errors[0].includes('hacker'),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S5 未知 step → E8（steps/ 只有 deploy）----
-{
-  const root = mkfix({
-    'step.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | — | rollback | env=prod | | exit 0 | | 0 |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S5 step 不在 steps/ → E8',
-    r.errorCount === 1 && r.files[0].errors[0].startsWith('E8') && r.files[0].errors[0].includes('rollback'),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S6 三形态全空 / 双填 → E9 ×2 ----
-{
-  const root = mkfix({
-    'forms.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| nothing | — | — | — | 只有任务没有形态 | src/** | 过 | | |\n' +
-      '| both | — | implementer | deploy | 形态双填 | src/** | 过 | npm test | |\n',
-  });
-  const r = lintWorkflows({ root });
-  const e9 = r.files[0].errors.filter((e) => e.startsWith('E9'));
-  check('S6 三形态全空与双填 → E9 ×2',
-    r.errorCount === 2 && e9.length === 2 && e9[0].includes('nothing') && e9[1].includes('both'),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S7 retries 非法 / concurrency 非法 → E10 + E2 ----
-{
-  const root = mkfix({
-    'nums.md': fm('concurrency: x\n') + HEAD + '\n' + SEP + '\n' +
-      '| a | — | — | — | — | — | — | npm test | 重试 |\n',
-  });
-  const r = lintWorkflows({ root });
-  const codes = r.files[0].errors.map((e) => (e.match(/^E\d+/) || [''])[0]);
-  check('S7 retries 非数字 → E10 且 concurrency 非法 → E2',
-    r.errorCount === 2 && codes.includes('E10') && codes.includes('E2'),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S8 gate 花括号展开 → W1（0 error，advisory）----
-{
-  const root = mkfix({
-    'brace.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| g | — | — | — | — | — | — | node scripts/fill-{intent,plan}.test.mjs | |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S8 gate 含 {a,b} 花括号展开 → W1 且不计 error',
-    r.errorCount === 0 && r.warningCount === 1 && r.files[0].warnings[0].startsWith('W1'),
-    JSON.stringify({ e: r.files[0].errors, w: r.files[0].warnings }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S9 授权文件交叉：无先序告警 / 有 after 先序不告警 ----
-{
-  const root = mkfix({
-    'parallel-cross.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | implementer | — | 做 A | src/shared/** | 过 | | |\n' +
-      '| b | — | implementer | — | 做 B | src/shared/** | 过 | | |\n',
-    'ordered-ok.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | implementer | — | 做 A | src/shared/** | 过 | | |\n' +
-      '| b | a | implementer | — | 做 B | src/shared/** | 过 | | |\n',
-  });
-  const r = lintWorkflows({ root });
-  const cross = r.files.find((f) => f.file === 'parallel-cross.md');
-  const ordered = r.files.find((f) => f.file === 'ordered-ok.md');
-  check('S9 授权文件相同且无先序 → W2；有 after 先序 → 不告警',
-    r.errorCount === 0 && cross.warnings.length === 1 && cross.warnings[0].startsWith('W2') && ordered.warnings.length === 0,
-    JSON.stringify({ cross: cross.warnings, ordered: ordered.warnings }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S10 _ 前缀机制文档不进扫描面（内含坏表也不报）----
-{
-  const root = mkfix({
-    '_TEMPLATE.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| bad | ghost | hacker | — | — | — | — | — | 重试 |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S10 _TEMPLATE.md 排除（机制文档含示例表，不按可执行件校验）',
-    r.files.length === 0 && r.errorCount === 0 && r.warningCount === 0,
-    JSON.stringify(r.files.map((f) => f.file)));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S11 缺 frontmatter → E1；缺 stages 表 → E3 ----
-{
-  const root = mkfix({
-    'nofm.md': '# 没有 frontmatter\n\n只有正文\n',
-    'notable.md': fm() + '# 有 frontmatter 没有 stages 表\n',
-  });
-  const r = lintWorkflows({ root });
-  const nofm = r.files.find((f) => f.file === 'nofm.md');
-  const notable = r.files.find((f) => f.file === 'notable.md');
-  check('S11 缺 frontmatter → E1 且缺表 → E3',
-    nofm.errors.some((e) => e.startsWith('E1')) && notable.errors.some((e) => e.startsWith('E3')),
-    JSON.stringify({ nofm: nofm.errors, notable: notable.errors }));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S12 id 重复 → E4；id 空 → E4 ----
-{
-  const root = mkfix({
-    'dup.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | — | — | — | — | — | npm test | |\n' +
-      '| a | — | — | — | — | — | — | npm test | |\n' +
-      '| — | — | — | — | 缺 id 行 | — | — | — | |\n',
-  });
-  const r = lintWorkflows({ root });
-  const e4 = r.files[0].errors.filter((e) => e.startsWith('E4'));
-  check('S12 id 重复与缺 id → E4 ×2',
-    e4.length === 2 && e4.some((e) => e.includes('重复')) && e4.some((e) => e.includes('缺 id')),
-    JSON.stringify(r.files[0].errors));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S13 step 引用 + gate + 空值规范（— / 空 retries / 空 gate）混排全绿 ----
-{
-  const root = mkfix({
-    'mixed.md': fm('concurrency: 3\n') + HEAD + '\n' + SEP + '\n' +
-      '| build | — | implementer | — | 构建 | src/** | 测试过 | | |\n' +
-      '| verify | build | — | deploy | env=staging | | exit 0 | | 2 |\n' +
-      '| final | verify | — | — | — | — | — | npm test | |\n',
-  });
-  const r = lintWorkflows({ root });
-  check('S13 step 行 / gate 行 / em-dash 空值 / concurrency=3 / retries=2 混排全绿',
-    r.errorCount === 0 && r.warningCount === 0,
-    JSON.stringify(r.files[0]));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-// ---- S14 真实仓库自扫 baseline：0 error（_TEMPLATE 排除后三份可执行件全过）----
-{
-  // **本场景是包源仓库的 baseline 断言，装户环境应 SKIP**（2026-09-28 修正）：
-  // 它上溯三级定位「真实仓库」，从 `templates/_agents/scripts/` 出发正确落在包源根；
-  // 但从装户的 `.agents/scripts/` 出发会落到 `<install>/..`，扫不到可执行编排件 →
-  // `files.length >= 3` 必假。首版没区分这两种上下文，导致**装户径下该套件恒红**——
-  // 实测：CI 新增「shipped 套件」步骤后，`.agents/scripts/workflows-check.test.mjs`
-  // 报 `FAIL S14（扫描面：）`（空扫描面），而包源侧同字节跑出 15/0。
-  // 判据：扫不到任何可执行件 = 本环境不适用 → SKIP（沿 doctor.test.mjs 同口径）。
-  const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
-  const r = lintWorkflows({ root: ROOT });
-  const names = r.files.map((f) => f.file).join('、');
-  if (r.files.length === 0) {
-    check('S14 真实仓库自扫 SKIP（本环境无 .agents/workflows/ 可执行件——装户径，沿 doctor.test 同口径）', true);
-  } else {
-    check('S14 真实仓库 .agents/workflows/ 自扫 0 error（扫描面：' + names + '）',
-      r.errorCount === 0 && r.files.length >= 3,
-      JSON.stringify(r.files.filter((f) => f.errors.length).map((f) => ({ f: f.file, e: f.errors }))));
-  }
-}
-
-// ---- S14 human 确认门（第四形态）：单形态全绿 / 双填 E9 / ×retries W4 / 缺列兼容 ----
-{
-  const HEAD10 = '| id | after | role | step | task / params | files（授权） | accept（验收判据） | gate | human | retries |';
-  const SEP10 = '|----|-------|------|------|---------------|--------------|-------------------|------|-------|---------|';
-  const root = mkfix({
-    'human-ok.md': fm() + HEAD10 + '\n' + SEP10 + '\n' +
-      '| a | — | implementer | — | 做 A | src/a/** | 测试过 | | | 0 |\n' +
-      '| ask | a | — | — | 用户确认可继续 | — | 一句「可以」 | | 用户确认 | |\n' +
-      '| b | ask | — | — | — | — | — | npm test | | |\n',
-    'human-bad.md': fm() + HEAD10 + '\n' + SEP10 + '\n' +
-      '| both | — | — | — | 双填 | — | — | npm test | 用户确认 | |\n' +
-      '| retry | — | — | — | 确认 | — | 一句可以 | | 用户确认 | 2 |\n',
-    'no-human-col.md': fm() + HEAD + '\n' + SEP + '\n' +
-      '| a | — | — | — | — | — | — | npm test | |\n',
-  });
-  const r = lintWorkflows({ root });
-  const ok = r.files.find((f) => f.file === 'human-ok.md');
-  const bad = r.files.find((f) => f.file === 'human-bad.md');
-  const legacy = r.files.find((f) => f.file === 'no-human-col.md');
-  check('S14 human 单形态 10 列全绿；human+gate 双填 E9；human×retries W4；9 列无 human 表全过',
-    r.errorCount === 1
-      && ok.errors.length === 0 && ok.warnings.length === 0
-      && bad.errors.length === 1 && bad.errors[0].startsWith('E9') && bad.errors[0].includes('gate + human')
-      && bad.warnings.length === 1 && bad.warnings[0].startsWith('W4')
-      && legacy.errors.length === 0 && legacy.warnings.length === 0,
-    JSON.stringify(r.files.map((f) => ({ f: f.file, e: f.errors, w: f.warnings }))));
-  fs.rmSync(root, { recursive: true, force: true });
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/templates/_agents/scripts-test-exempt.txt

@@ -1,16 +0,0 @@
-# 引擎脚本测试覆盖豁免登记（单源：本文件——check-loop 检查 20 共读，经 sync 下发装副本）
-# 格式：<脚本名> | <豁免理由> | <覆盖证据（套件名；无自动化覆盖如实写「无」）>
-# 语义：登记 ≠ 免责——须写明理由与覆盖证据；无覆盖的登记是「工具/启动器豁免」，后续批次评估补测。
-# 新增引擎脚本默认必须带同名 .test.mjs（README 规范条目）；确属库件/工具才登记本文件。
-# 2026-10-09 A2 评估：verify-wiki-consistency 已移出（补测 3 场景）；wiki-search 已移出（转发壳，判定单源 kb-search.test 覆盖）。
-check-metric-claims.mjs | 经 check-loop.mjs 消费 | 由 check-loop.test.mjs 间接覆盖其调用路径
-# 2026-10-16 减重手段② 随附：rule-budget.mjs 登记撤除（补同名直测黑盒套件 T1-T8——字节语义不回归 +
-# #count 条目数指令全形态；src/rule-budget.test.mjs 仍是包源预算自检门，职责不同并行保留）。
-ensure-board.mjs | 看板启动器 | 永久工具豁免（需真实端口/进程环境，自动化覆盖无性价比——2026-10-09 engine-quality-round2 A2 评估定性）
-policy.mjs | 库件 | 被 check-loop.test.mjs 直接 import 覆盖
-# 2026-10-12 needs-clarification：stage-gates.mjs 已建同名直测（stage-gates.test.mjs 15 断言），
-#   覆盖待澄清门纯函数族（CLARIFY_RE 形态矩阵 / HTML 注释不计 / clarifyGateFor 三态 / 行号点名）——
-#   这两条判据**没有 check-loop 侧对应检查**，间接覆盖盖不到，故必须直测。登记随之撤除。
-# 2026-10-08 engine-quality-batch：pipeline-run 三层拆分的库件层——纯函数/存储层由 pipeline-run.test.mjs 全量覆盖（断言零改动全过），单建同名测试属形式主义（plan 偏离留痕 ①）
-pipeline-run-docs.mjs | 库件（文档纯函数层，2026-10-08 engine-quality-batch 拆分） | 由 pipeline-run.test.mjs 全量覆盖（断言零改动 29 组全过）
-pipeline-run-run.mjs | 库件（run 存储层，同上拆分） | 由 pipeline-run.test.mjs 全量覆盖（含 PIPELINE_RUN_* 注入契约场景）

package/templates/_agents/skills/papercut-fix/SKILL.md

@@ -1,60 +0,0 @@
----
-name: papercut-fix
-description: 修 workflow/papercuts.md 里指定的未升级 papercut 条目（把存量债降到 0 的回路执行器）。按控制器给的行号定位症状、照「拟修」列改权威文件、回写台账并跑验证门。
----
-
-# papercut-fix — 单条 papercut 升级执行器
-
-## 目标
-将 `workflow/papercuts.md` 中指定的一条 papercut 条目状态更新为「已消债」。
-
-## 触发条件
-- 用户指令：`跑一轮 papercut 回路` / `清 papercut 存量` / `修第 N 条 papercut`。
-
-## 约束与红线
-- **单一目标**：每轮执行仅处理一条目标，禁止顺手修复相邻条目或夹带其他改动。
-- **范围限制**：改动仅限文档面（`.agents/commands/`, `.agents/roles/`, `.agents/skills/`, `.githooks/`, `.agents/scripts/`, `workflow/`）。
-- **绝对禁区**：禁止修改 `backend/`, `frontend/`, `tests/`, `wiki/`，禁止连接数据库——与控制器 scope gate（`OUT_OF_SCOPE` 正则）同一清单，命中即停。超出范围时必须停止并报告用户。
-- **验证优先**：禁止凭台账描述臆测现状。必须先读权威文件验证症状是否成立。
-- **编辑规范**：修改 `workflow/` 文档必须使用 Edit 工具。禁止使用 `node -e` 或脚本批量替换（CRLF 环境下会静默失败）。
-- **消债判定**：分支 A（修复）与分支 B（暂缓/失效）**均**满足 `debt -1` 不变量。
-
-## 工作流
-
-### 1. 定位与预检
-- 从控制器输出提取：`行号` (Lxx), `位置` (路径), `症状`, `拟修`。
-- 使用 Read 工具读取该行及其上下文。
-
-### 2. 现状验证
-- 读取「位置」列指定的权威文件。
-- **判定结论**：
-    - **缺陷仍在** $\rightarrow$ 进入分支 A。
-    - **已失效** (已被其他改动修复/文件已删除) $\rightarrow$ 进入分支 B。
-    - **方向相反/描述有误** $\rightarrow$ 重新定性后再执行。
-
-### 3. 执行修复
-- **分支 A (缺陷仍在)**：
-    1. 对权威文件执行最小化修复。
-    2. 在 `workflow/papercuts.md`（或承载该条目的 `workflow/papercuts.d/` 分片）该行末尾追加：`✅ 已升级修复(YYYY-MM-DD): <改动描述> <commit>`。
-    3. 若原「拟修」描述已不适用，在追加记录中写明实际修法。
-- **分支 B (已失效)**：
-    1. 在 `workflow/papercuts.md`（或承载该条目的分片）该行末尾追加：`⏸ 暂缓(YYYY-MM-DD): <失效理由>`。理由必须明确。
-    2. **核实纪律**：
-        - 检查用户级技能目录（`~/.claude/skills/`、`~/.trae/skills/` 等宿主适配目录）确认文件是否仅是迁移而非删除。
-        - 区分「环境约束」与「代码缺陷」。
-        - 针对「跨环境」症状，使用 `git worktree` 构建真实检出态实验证伪。
-        - 针对「已落地」症状，使用 `git log -S` 追溯引入提交日期。
-- **分支 C (越界)**：停止执行，报告理由并请求授权。
-
-### 4. 验证与收尾
-- **备份**：修改台账（主台账或分片）前强制 `cp <台账文件> tmp/papercuts.wip-backup.md`。
-- **运行检查**：
-    - `node .agents/scripts/papercut-debt-sensor.mjs` $\rightarrow$ `debt` 必须恰好减少 1。
-    - `node .agents/scripts/papercut-debt-controller.mjs` $\rightarrow$ 确认目标推进。
-    - 检查台账（主台账 ∪ 分片）的总行数（`total` 不得减少——`debt` 符合预期 ≠ 文件没被压行）、列数分布及是否存在超长行（压行信号）。
-- **体积检查**：若修改了 `.agents/commands/`，跑 `node .agents/scripts/rule-budget.mjs --staged` 对比 `.agents/rule-budgets.txt` 上限（一进一出；禁用工作区 `wc -c` 核对——CRLF 膨胀会误报）。
-
-## 回报要求
-- 参照 `references/response-template.md` 输出。
-- 包含：行号、位置、分支结论(A/B/C)、改动文件、验证结果(debt 前后值)、待决策事项。
-- **禁令**：禁止自动 commit 或 push。

package/templates/_agents/skills/papercut-fix/references/response-template.md

@@ -1,81 +0,0 @@
-# papercut-fix 回应模板
-
-单轮回路执行器的最终输出格式。给用户看，决定他是否放行这次改动。
-
----
-
-## 模板
-
-```markdown
-papercut 回路 · 第 N 轮
-
-**目标**：L{line} `{location}`（{date}，第 {hits} 次命中）
-**结论**：{A 缺陷仍在 / B 已失效 / B2 账未销（拟修已由别的改动落地）/ B3 台账方向记反（检出态实验证伪）/ C 越界待授权}
-
-### 改动
-
-| 文件 | 改了什么 |
-|---|---|
-| `{权威文件路径}` | {一句话} |
-| `workflow/papercuts.md` | 回写行标记：{`✅ 已升级修复（日期）` / `⏸ 暂缓（日期）：理由`} |
-
-### 验证
-
-- `papercut-debt-sensor.mjs`：debt {before} → {after}（预期 -1）
-- {其他检查，如体积预算核对：通过 / 不适用}
-
-### 台账依据
-
-{若实际修法与「拟修」列描述不一致，在此说明「拟修」列写的什么、实际怎么做的、为什么。
- B2 结论必须写出落地提交：`由 <sha>（<日期>，<标题>）落地`。}
-
-### 需你决定
-
-{列出需要用户拍板的事项；没有则写「无」。典型场景：
- - 结论为 C（越界）——是否单独授权改源码/连库
- - 「拟修」列描述已过期——是否更新该列文本
- - 控制器列出的「待人工定性」条目——是否本轮顺带定性
- - 改动触及常驻面体积预算——是否接受，或改为下沉/删除被取代条目}
-```
-
----
-
-## 格式要求
-
-1. **先给结论，再给细节**。用户扫第一行就要知道"修了哪条、结论是什么"。
-2. **「需你决定」不许空着**。即使本轮无事，也显式写「无」——让"没有待决事项"和"忘了写"可区分。
-3. **验证值给具体数字**，不要只说"验证通过"。debt 的前后值是设定点误差，必须可核。
-4. **不粉饰失败**。验证门红了就写红，附命令与原始报错摘要。回路的价值在于给出可信的账，不是好看的账。
-5. **不写"建议接下来…"式的空话**。要写就写具体动作 + 具体条目编号。
-
----
-
-## 示例（结论 A，示意——占位符形态，非真实条目）
-
-```markdown
-papercut 回路 · 第 3 轮
-
-**目标**：L34 `.agents/commands/test.md`（静态门清单 §2 缺一条豁免说明）（<日期>）
-**结论**：A 缺陷仍在
-
-### 改动
-
-| 文件 | 改了什么 |
-|---|---|
-| `.agents/commands/test.md` | §2 补一条：跳过条件的判据以 <权威判据> 为准，不以 <表象> 为准；§常见误判 补对应条目 |
-| `workflow/papercuts.md` | 回写 L34 标记：`✅ 已升级修复（YYYY-MM-DD）` |
-
-### 验证
-
-- `papercut-debt-sensor.mjs`：debt 16 → 15（预期 -1）
-- 体积预算：`node .agents/scripts/rule-budget.mjs --staged` 通过（未触 `.agents/commands/` 上限）
-
-### 台账依据
-
-「拟修」列写的是「补一条 <表象> 的判定说明」。实际执行时发现症状描述的是 <相邻机制>，而 §2 真正缺的是**判据本身**（<相邻机制> 只在特定前提后需要，判据该按 <权威判据>）。两者相邻但不同，已按判据写，相邻条目并入同节。
-
-### 需你决定
-
-- 「拟修」列文本与实际修法有偏差（见上），是否更新该列描述以免下次复发时对不上？
-- 控制器列出的「待人工定性」3 条（位置列路径已不存在）——其中 1 条指向的脚本性能问题已随某次重构解决，本轮修完后建议一并定性。要不要现在处理？
-```

package/templates/_agents/skills/review-method/SKILL.md

@@ -1,55 +0,0 @@
----
-name: review-method
-description: 代码复核走查方法（Standards×Spec 双轴 + 坏味道清单 + 合入标尺）。供 independent-reviewer 或主智能体复核 diff 时使用；是 .agents/commands/review.md 执行流程的方法层单源，不依赖宿主全局技能。
----
-
-# review-method — 复核走查方法
-
-## 定位与分工
-复核三层各自单源，本文件只管「怎么走查」：
-
-| 层 | 单源 |
-|---|---|
-| 拦什么（不变量） | `.agents/commands/review.md` P0/P1 表 |
-| 以什么身份查（证据纪律） | `.agents/roles/independent-reviewer.md` Constraints |
-| 怎么走查（本文件） | 双轴框架 + 坏味道清单 + 合入标尺 |
-
-宿主有全局 `code-review` / `review-verification-protocol` 技能时可叠加；无则本文件兜底。
-
-## 双轴框架（分轴报告，禁合并排序）
-| 轴 | 问的问题 | 依据 |
-|---|---|---|
-| **Standards** | 是否符合本仓成文标准 | 根/目录级 `AGENTS.md` + review.md P0/P1 表 |
-| **Spec** | 是否忠实实现入口文档承诺 | intent/plan「验收标准」+ spec §测试用例 |
-
-两轴独立成立：合规范但做错事（Standards 过、Spec 挂）与做对事但破规范（Spec 过、Standards 挂）都存在——分开报告防一轴掩盖另一轴。Spec 轴报三类发现：承诺缺失/部分落地、超范围（scope creep）、实现走样。
-
-## 坏味道走查清单（Standards 轴补充）
-P0/P1 表之外的判断项。约束：仓库成文标准优先（成文认可即压制本清单）；始终是判断项非硬违规；门禁/tooling 已拦的跳过。每条 = 是什么 $\rightarrow$ 怎么修：
-
-| 坏味道 | 是什么 $\rightarrow$ 怎么修 |
-|---|---|
-| Mysterious Name 神秘命名 | 名字不揭示用途 $\rightarrow$ 重命名；起不出诚实名字 = 设计混浊 |
-| Duplicated Code 重复代码 | 同形逻辑在多处出现 $\rightarrow$ 提取共享实现，两处调用 |
-| Feature Envy 依恋情结 | 方法够别家数据多过自己 $\rightarrow$ 把方法移到所依恋的数据上 |
-| Data Clumps 数据泥团 | 几个字段/参数总是结伴出行 $\rightarrow$ 捆成一个类型传递 |
-| Primitive Obsession 基本类型偏执 | 原始值顶替领域概念 $\rightarrow$ 为概念建专属小类型 |
-| Repeated Switches 重复开关 | 对同一类型的 switch/级联 if 反复出现 $\rightarrow$ 多态或共享映射 |
-| Shotgun Surgery 霰弹式修改 | 一个逻辑变更迫使多文件分散编辑 $\rightarrow$ 聚拢到同一模块 |
-| Divergent Change 发散式变化 | 一个模块因多个不相关原因被改 $\rightarrow$ 按单一变化理由拆分 |
-| Speculative Generality 投机泛化 | 为 spec 没有的需求加抽象/参数/钩子 $\rightarrow$ 删掉内联，等真实需求出现 |
-| Message Chains 消息链 | 长 `a.b().c().d()` 导航 $\rightarrow$ 在首对象上藏一个方法 |
-| Middle Man 中间人 | 类/函数几乎只做转发 $\rightarrow$ 删掉，直调真目标 |
-| Refused Bequest 拒绝继承 | 子类忽略/覆盖大部分继承物 $\rightarrow$ 弃继承改组合 |
-
-性能三项（P1 分页条款之外）：N+1 查询、无界取数/循环、热路径大对象。
-
-## 结构化修复动作
-报结构问题时给命名动作，禁只说「这里复杂」让作者猜：消条件链建类型/分发器、折叠重复分支、编排与业务分离、特性逻辑移回所属层、复用权威 helper 禁近亲复制、显式类型边界消下游分支、删无澄清价值的透传包装、抽 helper 或拆大文件。
-
-## 合入标尺（防 P2 纠缠）
-确定改善整体代码健康即建议合入，不因「不是我会这么写」而拦——完美不存在，持续改进是目标。样式偏好与假设性风险禁报（证据纪律见角色契约 Constraints）。
-
-## 出处
-- 双轴框架与坏味道清单：提炼自宿主全局 `code-review` 技能（Fowler《Refactoring》ch.3 基线）。
-- 结构化修复动作与合入标尺：借自 [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)（MIT）。

package/templates/_agents/skills/verify-ui/SKILL.md

@@ -1,61 +0,0 @@
----
-name: verify-ui
-description: 启动本地服务并用浏览器实测 UI 改动（只读验证、不留脏数据）；项目无测试基建时靠实测兜底。当用户要求"实测 / UI 验证 / 浏览器验证"时使用。
----
-
-# verify-ui — UI 实测引导
-
-无测试基建时，UI 改动必须浏览器实测。步骤：
-
-## 1. 起服务
-
-启动命令**不写死在本文件**（本文件是 managed 件，随包升级覆盖——项目特定值写这里会丢）：以 `.agents/notes/runtime-env.md`「本地端口与进程」节的记录为准；该节无记录时，先起服务并把命令补记进该文件再继续。
-
-进程清单记进 `.agents/notes/runtime-env.md`，实测结束必须关闭。
-
-## 2. 浏览器验证
-
-- 优先 `browser` 工具；不可用时用 `.agents/scripts/e2e/harness.mjs`（如项目已装；封装 `launch`/`seedSession`/`goto`/`hardGoto`/`clickText`/`pressKey`/`ensureClean`/`screenshot` + 网络/控制台/toast 采集器）；自写脚本优先复用其常量与函数。
-- 浏览器首选**较新的 Chromium 内核 headless**（如 Edge `--headless=new`）——旧版 Chrome 会把 antd 图标字体渲染成方框、表格 `waitFor` 超时（见下「浏览器选择」）。
-- 登录态：先调 API 登录拿 token，注入前端约定的 localStorage 键，**并整页重载**让前端状态库重读 token（仅改 hash 的导航不重建文档，会被路由守卫弹回登录页）。
-- 路由为 hash 模式时：`goto` 用 hash；深链接（query 变化）用 `hardGoto`（about:blank 中转强制新文档）。
-
-## 3. 实测步骤
-
-1. 打开目标页面，按改动点逐项操作：正常路径一条 + 失败路径一条（校验/空态/权限）。
-2. 证据落盘：截图或关键控制台/网络报文，路径写在任务文档「验收标准」勾验项后。
-3. **不留脏数据**：验证产生的临时数据当场删除或还原；清理**只按本次创建的 ID 精确删除**（ID 取自网络捕获的 POST 响应），**禁止按文案/字段模糊匹配**——模糊匹配会误删用户手建数据；清理脚本一律先备份再删；不确定可回滚的操作先停下问用户。
-
-## 4. 收尾
-
-- 关闭本次起动的全部进程（按 §1 清单逐个停）。
-- 结论按「页面 / 步骤 / 期望 vs 实际 / 证据」回报；发现缺陷只记录定性，不修代码（修复走 build/maintain 流程）。
-
-## 关键坑
-
-- API 用 **HTTP** 避开自签证书问题（HTTPS 自签证书会让浏览器/脚本报错或需额外信任配置）。
-- MCP 报「browser is already running」是残留实例占 MCP 专用 profile 锁（`~/.cache/chrome-devtools-mcp/`），清掉对应 chrome 进程重试即可，勿误判为 MCP 不可用。
-- 布局类修复用 `getBoundingClientRect` 程序化检测，比截图肉眼更可靠。
-- 后台任务生命周期不可依赖（实测可长可短）：长命服务一律独立进程起（如 PowerShell `Start-Process`）。
-- 用 shell 工具起长命服务时**勿在命令末尾接管道**（`| tail` 等）——子进程继承 stdout 句柄会让命令永不返回，直到被工具超时杀掉（并可能连带杀掉服务）。
-
-### 浏览器选择
-
-- 旧版 Chrome（实测 83）内核太旧 → antd 图标字体全渲染成方框、表格 `waitFor` 超时。**优先较新的 Chromium 内核**（如 Edge `--headless=new`）；harness 的 `CHROME` 常量按本机实际安装路径改。
-
-### antd 交互（JS `.click()` 不够）
-
-- 按钮文本内含空格（`确 定` / `保 存` / `取 消`）→ 匹配须去空白，勿用 `innerText === '确定'`。
-- Select / Picker / Dropdown 的 `.click()` 打不开弹层 → 须 `Input.dispatchMouseEvent`（mousedown+mouseup 序列）；普通按钮用 `clickText` 够用，弹层控件须补 `realClick`。
-- `new KeyboardEvent('Escape')` 关不掉弹层 → 须 `Input.dispatchKeyEvent`（rawKeyDown+keyUp）。
-- **关弹层慎用 Esc**：antd Drawer 同样响应 Esc，会连带关闭抽屉并 reset 表单（表现为「保存后列表无新行」，易误判为保存链路故障）——改点遮罩/关闭按钮。
-- 表格行常无 `tr[data-row-key]` 属性 → 用 `.ant-table-tbody > tr.ant-table-row` + textContent 过滤业务键（如单号）定位行。
-- 宽表 `:scroll="{x:N}"` 截图前把 `.ant-table-content` scrollLeft 置底，露出右侧列。
-- 虚拟滚动下拉（a-select）DOM 只渲染约 10 个节点 → **勿按 DOM 节点数断言选项条数**，按接口响应条数断言。
-
-### CDP 采集（SPA hash 导航不重建文档）
-
-- Log/Console 采集不随导航重置 → 每次导航前重置采集器，防上一页错误泄漏成后续页面的「控制台错误」。
-- toast 观察器须**导航前**安装；导航后装会漏首屏 toast。
-- 首屏无 token 被路由守卫落登录页：写 localStorage 后仅 hash 变化的 `Page.navigate` 不整页重载、前端状态库仍持空 token → 须 `about:blank` 中转强制新文档，或写后 `Page.reload`。
-- 同路由 hash query 变化不重挂载（`#/x?k=A` → `#/x?k=B`）→ 深链接用例走 `about:blank` 中转。