flow-comet 1.6.5 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +17 -5
  3. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +1 -1
  4. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +23 -4
  5. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
  6. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +14 -94
  7. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +97 -3
  8. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +38 -2
  9. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
  10. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +16 -3
  11. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +2 -0
  12. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +4 -0
  13. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +20 -11
  14. package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
  15. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +47 -5
  16. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +297 -131
  17. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +616 -151
  18. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +96 -45
  19. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
  20. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +204 -51
  21. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +7 -9
  22. package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
  23. package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
  24. package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
  25. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +38 -20
  26. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +439 -134
  27. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +66 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +92 -13
  29. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +55 -2
  30. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +94 -39
  31. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +6 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
  33. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +57 -7
  34. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +60 -3
  35. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +158 -3
  36. package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +341 -0
  37. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +92 -17
  38. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1439 -11
  39. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1202 -8
  40. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1204 -76
  41. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +753 -5
  42. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +32 -1
  43. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +582 -3
  44. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +5 -0
  45. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +5 -0
  46. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +16 -0
  47. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +2 -0
  48. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +5 -0
  49. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2041 -66
  50. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -0
  51. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +143 -16
  52. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +312 -63
  53. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
  54. package/.flow-comet/skills/flow-comet-execute/SKILL.md +30 -6
  55. package/.flow-comet/skills/flow-comet-plan/SKILL.md +10 -3
  56. package/.flow-comet/skills/flow-comet-review/SKILL.md +20 -11
  57. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +33 -8
  58. package/.flow-comet/skills/flow-comet-task/SKILL.md +2 -1
  59. package/README.md +1 -1
  60. package/package.json +1 -1
  61. package/scripts/dsh-bridge.mjs +2 -2
@@ -13,6 +13,12 @@ import { validateStateFields } from '../state-schema.mjs';
13
13
  import { inspectWorkflowPathSegments } from '../protocol-utils.mjs';
14
14
  import { fileExists, inspectReentryChangeDir, readJson, readState, runRootDir, specsDir, stateFile, writeState } from './state-io.mjs';
15
15
  import { TASK7_REQUIRED } from './task-graph.mjs';
16
+ // TASK.md 段形权威(P2b):replan 复用 plan 出口的同一份骨架门——骨架(模板 + 登记表)与报错片段
17
+ // (formatIssueParts)都从这两个模块取用,重校段不自持第二份段名清单 / 第二套措辞。
18
+ import { evaluateArtifact, formatIssueParts } from './guard-template-fidelity.mjs';
19
+ // 波次投影(波次 = 依赖层级的投影):与 plan 出口同一实现、同一报文——replan 的重校段消费它,
20
+ // 不另写一份判定(两处各写一份,改散文即可绕过其中一处)。
21
+ import { parallelGapOutcome, parallelGapReview, waveProjectionReview, waveReviewOutcome } from './wave-projection.mjs';
16
22
 
17
23
  // reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]
18
24
  // 受控重入(archive 源回边):archive 已 entry 且归档移动尚未发生时,用户显式授权把工作归属
@@ -265,6 +271,39 @@ export async function runReenter(protocol, argv) {
265
271
  return;
266
272
  }
267
273
 
274
+ // TASK 段形前置(P2b):计划重校是「已签发计划的修订」,TASK.md 的段形由模板权威裁定——plan 出口
275
+ // 已用同一份骨架门(evaluateArtifact + formatIssueParts)拦过缺段,重校段不豁免:执行期把承载段
276
+ // (`## 波次划分` 等模板必需段)删掉再改任务集,不得换到「未校验」放行口(否则「删一个段」就是
277
+ // 关掉波次判据的写法)。模板缺席 ⇒ 段集合无从派生,本判据整段跳过(plan 出口在同一输入下也只打印
278
+ // 「未校验(模板缺失)」;它对标题 / 首部字段的另判属另一层判据面,不在本判据的判据面内——重校段
279
+ // 要堵的是「删段再改任务集」)。同一形态下波次判据自己那行「未校验(无波次段)」照常打印,两条边界
280
+ // 各说各的事实。
281
+ // 报文与分级取用 plan 出口的同一份实现(骨架 = 模板 + 登记表;片段 = formatIssueParts),失败行
282
+ // 因此与 plan 出口**逐字一致**(escalate=false,两阶段口径不变);重校段的现场适配只落在恢复行:
283
+ // ① 缺的段名在这里点名(重校段没有提示账本可「再犯升级」,等第二次才说段名等于永远不说);
284
+ // ② 重试目标是本命令(人在 replan 现场,改完要重跑的是它)。分级沿用既有语义:新 change BLOCKED、
285
+ // 旧 change WARN 渐进。
286
+ async function replanTaskStructureGate(state, taskContent) {
287
+ const taskArtifact = await evaluateArtifact('TASK', taskContent, {});
288
+ if (!taskArtifact.derived) return; // 模板缺席 ⇒ 段形无从派生(与 plan 出口同一支「未校验(模板缺失)」)
289
+ // escalate: false = 失败行只报类别计数——与 plan 出口**逐字一致**(两阶段口径是公开行为:
290
+ // 首次只给模板路径与类别计数)。重校段没有提示账本可「再犯升级」,段名因此放在恢复行点名,
291
+ // 不靠第二次失败才出现,也不与那条两阶段口径矛盾。
292
+ const parts = formatIssueParts(taskArtifact.issues, { escalate: false });
293
+ if (parts.length === 0) return;
294
+ const templateFile = taskArtifact.skeleton.file ?? '(登记表未登记模板路径)';
295
+ const failureLine = 'TASK.md 模板结构校验失败: ' + parts.join('; ') + '(模板: ' + templateFile + ')';
296
+ if (state.newChange === true) {
297
+ const missingSections = taskArtifact.issues.missing ?? [];
298
+ console.error('BLOCKED: ' + failureLine);
299
+ console.error('恢复: 对照 ' + templateFile + ' 修正标题 / 首部字段 / 段序,并按模板补齐缺失的 H2 与结构型 H3 标题'
300
+ + (missingSections.length > 0 ? '(缺失的段: ' + missingSections.join('、') + ')' : '')
301
+ + '——承载段被删掉也算缺段,删段不是跳过判据的写法;改完重试 replan(replan 不做校验豁免,状态零改写)');
302
+ process.exit(1);
303
+ }
304
+ console.error('TEMPLATE-STRUCTURE WARN: ' + failureLine + '(旧 change 渐进,不阻断;新 change 将强制)');
305
+ }
306
+
268
307
  // replan <reason> --authorized-by <source> [--continue-round <n>]
269
308
  // 受控计划重校重签(ADR-013):计划在执行中被证明有缺陷时,唯一合规的重签入口——只在
270
309
  // execute / subagent-execute 相位可用、停原位(不跳节点、不改 completedNodes),先把任务集
@@ -421,6 +460,27 @@ export async function runReplan(protocol, argv) {
421
460
  + ';恢复: 调整任务 depends_on——移除成环引用或改为真实存在的任务 id 后重试');
422
461
  process.exit(1);
423
462
  }
463
+ // TASK 段形前置(P2b):判据与措辞见 replanTaskStructureGate(本函数只负责顺序——结构先于内容)。
464
+ await replanTaskStructureGate(state, taskContent);
465
+ // 波次投影(波次 = 依赖层级的投影):与 plan 出口**同源**调用同一判定与同一报文构造(ADR-013:
466
+ // replan 绝不豁免——此处不判,改一改波次散文就能绕过 plan 出口的同一判据)。新 change 不一致
467
+ // (含未被 Wave 行声明的任务,明细取值「未声明」)→ BLOCK(逐条点名 + 恢复指引;本段全部先于
468
+ // 备份与写盘,故状态零改写),旧 change WARN 渐进。「判不了」按成因二分——载体缺席(无段 / 段名
469
+ // 无从派生)打印「未校验」并跳过;内容不可判(段在场却无可对应任务)与 plan 出口同分级。
470
+ // 分级与措辞都由 waveReviewOutcome 一处产出(本段只派生 blocking):两处不可能各说一套,也不会
471
+ // 因为「分级规则只改了一处」而在另一处静默落后。
472
+ const waveReview = waveProjectionReview({ taskContent, blocks: taskList });
473
+ const waveOutcome = waveReviewOutcome(waveReview, { blocking: state.newChange === true });
474
+ for (const line of waveOutcome.lines) console.error(line);
475
+ if (waveOutcome.block) process.exit(1);
476
+ // 同波可并行却漏标 [P]:plan 出口的第二条波次面判据,重校段同样不豁免(ADR-013)——否则执行期
477
+ // 重签就能把「本可并行却没标」的计划换一份发出去。波次分组复用上面同一次解析(waveReview.waves)。
478
+ const gapOutcome = parallelGapOutcome(
479
+ parallelGapReview({ taskContent, blocks: taskList, waves: waveReview.waves }),
480
+ { blocking: state.newChange === true },
481
+ );
482
+ for (const line of gapOutcome.lines) console.error(line);
483
+ if (gapOutcome.block) process.exit(1);
424
484
  // 任务字段完整性(与 plan 出口同一判据):字段集从 `task-graph.mjs` 的单一权威常量取用——本模块
425
485
  // 是执行期唯一允许修订任务集的通道,若在此另写一份字面集合,plan 出口会拒的任务集将被 replan
426
486
  // 静默放行。新模板形态(含 <name>)且新 change → BLOCK;旧式一字段形态 / 旧 change 保持渐进
@@ -573,6 +633,12 @@ export async function runReplan(protocol, argv) {
573
633
  : '第 ' + round + '/' + REPLAN_ROUND_LIMIT + ' 轮';
574
634
  console.log('REPLAN: ' + decision.node + ' 重新校验通过(授权源 ' + source + ';' + roundLabel
575
635
  + ';备份 ' + backupRecord + ')');
636
+ // 成功行的事实说明(只加一行可观察事实,REPLAN 行前缀与语义不变):重签的是 state.taskHash,
637
+ // 只写重校审计;TASK.md 保持执行者修订后的原文,plan 节点证据不会重记(防误以为 replan 会
638
+ // 重写计划工件或重跑计划阶段)。值前缀从实际签名派生,不在这里手写版本字面量。
639
+ const signaturePrefix = String(taskSetSignatureValue).split(':')[0] + ':';
640
+ console.log('TASKHASH: 已重签 state.taskHash(值前缀 ' + signaturePrefix
641
+ + ')——TASK.md 内容未改写、plan 节点证据未重记(重签只覆盖任务集签名与重校审计)');
576
642
  console.log('REASON: ' + reason);
577
643
  return;
578
644
  }
@@ -4,24 +4,100 @@
4
4
  // 读写(不写 state、不改路由、不绕门禁,与 bridge-check 同为纯读通道)。节点 id 非法 →
5
5
  // fail-closed 并列出协议内全部合法节点。
6
6
  import path from 'path';
7
- import { nodeTemplateDeclaration, templatePointerLines } from '../protocol-utils.mjs';
7
+ import { fileURLToPath } from 'url';
8
+ import {
9
+ nodeTemplateDeclaration,
10
+ resolveProtocol,
11
+ skillLoadDeclarationArgs,
12
+ templatePointerLines,
13
+ } from '../protocol-utils.mjs';
14
+ import { toPersistedProtocolPath } from '../state-schema.mjs';
8
15
  import { runRootDir } from './state-io.mjs';
9
16
 
17
+ // 协调者禁令的**同一句**(单一来源):entry(门禁族)与 next / record(状态命令族)都引用本常量——
18
+ // 同一纪律多个输出面逐字一致;两处各写一份必然在措辞演进时分叉。落点选在本模块是因为它**不属于
19
+ // 任何一族**:门禁族与状态命令族都只是取用方,常量因此不会把两族绑成一条反向依赖(一个措辞不该
20
+ // 让下游模块依赖整个上游门禁面)。现行架构口径(ADR-014 / 并行委派四属性契约):委托按平台的身份
21
+ // 通道判定,独立 worktree 只是「① 写权限」的一种实现,共享工作区同样受支持。
22
+ export const COORDINATOR_NOTICE = '你是协调者,不是执行者。禁止在主会话直接修改源码;按平台的身份通道委托子代理(同一身份判据,不要求隔离区);独立 worktree 只是四属性契约里「写权限」的一种实现,共享工作区同样受支持;子代理回传后仅更新 TASK.md / SUMMARY / handoff evidence。';
23
+
10
24
  // 命令路径形态(平台化):权威源保持设计形态 .claude/skills/(与册子命令形态一致,安装时由
11
25
  // prepare-env 的 pathReplacements 平台化);安装副本按脚本自定位输出运行根相对形态——.claude /
12
26
  // .agents / .dsh 乃至将来新增的平台根同一推导覆盖,无需在此登记平台清单;落在运行根之外
13
27
  // (用户级安装)时输出脚本自身的绝对路径。不得硬编码单一形态:pathReplacements 只处理 .md
14
28
  // (prepare-env 的 applyPathReplacements 按扩展名过滤),脚本内的字面量在安装副本上不会被
15
- // 替换——硬编码 .claude 会让 Codex / dsh 单平台安装的 explain 输出不存在的命令路径。
16
- // scriptsDir 由入口以自定位绝对路径传入(入口所在目录即脚本目录)。
17
- function platformScriptsDir(scriptsDir) {
29
+ // 替换——硬编码 .claude 会让 Codex / dsh 单平台安装的消息输出不存在的命令路径。
30
+ // scriptsDir 由调用方以自定位绝对路径传入(调用方所在脚本目录);runRoot 缺省取状态上下文的运行根
31
+ // (state CLI 已初始化)——其它入口(守卫 / 委托脚本)没有该上下文,须显式传入自己的运行根。
32
+ // 本函数是这条推导的唯一实现:运行期消息与 explain 的 COMMAND 行都从这里取(L-067:同一推导
33
+ // 两处表达必然分叉)。
34
+ export function platformScriptsDir(scriptsDir, runRoot = runRootDir()) {
18
35
  const posixDir = scriptsDir.replace(/\\/g, '/');
19
36
  if (posixDir.includes('/.flow-comet/skills/')) return '.claude/skills/flow-comet/scripts';
20
- const relative = path.relative(runRootDir(), scriptsDir).split(path.sep).join('/');
37
+ const relative = path.relative(runRoot, scriptsDir).split(path.sep).join('/');
21
38
  if (relative === '' || relative.startsWith('..') || path.isAbsolute(relative)) return posixDir;
22
39
  return relative;
23
40
  }
24
41
 
42
+ // 可复制命令形态(同一处实现:运行期消息与 explain 的 COMMAND 行共用):脚本根(平台化)+ 脚本名
43
+ // + 参数,整条脚本路径加双引号——安装根含空格时未加引号的路径会被 shell 按空格切分(只剩首段被当作
44
+ // 脚本),加引号后三种平台语义下都是单一参数(引号对无空格路径无害)。调用方只提供事实(脚本目录、
45
+ // 运行根、脚本名、参数),不得自行拼一份。
46
+ export function scriptCommand({ scriptsDir, runRoot, script, args = [] }) {
47
+ return 'node "' + platformScriptsDir(scriptsDir, runRoot) + '/' + script + '"'
48
+ + (args.length > 0 ? ' ' + args.join(' ') : '');
49
+ }
50
+
51
+ // ---------- 声明命令(skill-load):状态命令族与守卫族共用的唯一装配 ----------
52
+ //
53
+ // 一条可照抄的声明命令由三段事实拼成,三段各有单一来源,本段只做组合:
54
+ // · 参数面(`skill-load <node> <skill> --prompt … --templates …`):由协议数据派生,见
55
+ // protocol-utils 的 skillLoadDeclarationArgs(该节点全部协议文件 + 模板全清单);
56
+ // · 脚本路径(平台化 + 整条加引号):见上面的 scriptCommand(与 record / entry 的恢复指引同源)——
57
+ // 只写裸脚本名的命令在 shell 里是 `command not found`,等于没给命令;
58
+ // · 协议上下文(`--protocol <持久化路径>`):本次运行解析到的协议**不是内置默认**时才带——内置
59
+ // 默认时照抄不带它也解析到同一份(加了只是噪音);自定义协议不带则照抄会解析到另一份协议
60
+ // (状态命令族只认 CLI → 环境变量 → 内置默认,没有 state 绑定这一来源),恢复路径断在第一步。
61
+ // 这三段此前被拼成两种文本(状态侧裸脚本名 / 守卫侧 scriptCommand 形态),同一件事两种文本时只有
62
+ // 一种能执行,故命令文本只在这里产出。
63
+ export function protocolContextArgs({ protocolPath, packageRoot, runRoot }) {
64
+ if (!protocolPath || !packageRoot) return [];
65
+ const builtin = path.resolve(packageRoot, 'reference', 'workflow-protocol.json');
66
+ if (path.resolve(protocolPath) === builtin) return [];
67
+ return ['--protocol', '"' + toPersistedProtocolPath(runRoot, protocolPath) + '"'];
68
+ }
69
+
70
+ // 一条声明命令。context = { scriptsDir, runRoot, packageRoot, protocolPath }——运行面的事实,
71
+ // 由各族的运行上下文提供(状态命令族见 commandContext;守卫族按同一形状取自己的运行上下文)。
72
+ export function declarationCommand({ node, skill, frontend = false, context }) {
73
+ return scriptCommand({
74
+ scriptsDir: context.scriptsDir,
75
+ runRoot: context.runRoot,
76
+ script: 'workflow-state.mjs',
77
+ args: [
78
+ ...skillLoadDeclarationArgs({ node, skill, frontend }),
79
+ ...protocolContextArgs(context),
80
+ ],
81
+ });
82
+ }
83
+
84
+ // 每个目标技能各一条命令(一次声明只写一个技能标记:同 node-skill 重跑是覆写,不是新增)。
85
+ // skills 必填:**谁决定目标集**由调用方表态——守卫族的异步面(判前端)与状态族的同步面
86
+ // (protocol-utils 的 declarationSkillTargets)取的不是同一套结论,一个缺省值会把两者悄悄换掉。
87
+ export function declarationCommands({ node, skills, frontend = false, context }) {
88
+ return skills.map((skill) => ({ skill, command: declarationCommand({ node, skill, frontend, context }) }));
89
+ }
90
+
91
+ // 状态命令族的运行上下文:脚本目录由本模块位置推导(它在 scripts/lib 下),包根是脚本目录的上一级,
92
+ // 运行根取状态上下文(入口在分派前初始化),协议路径用入口同一个解析器按同一批参数解析
93
+ // (CLI > 环境变量 > 内置默认)——命令自带的协议上下文因此就是本次运行的那一份,而不是另取一次。
94
+ // 守卫族有自己的运行上下文(FLOW_COMET_RUN_ROOT + 状态绑定的协议),按同一形状自行提供,不走本函数。
95
+ export function commandContext({ argv = [], runRoot = runRootDir() } = {}) {
96
+ const scriptsDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
97
+ const packageRoot = path.resolve(scriptsDir, '..');
98
+ return { scriptsDir, runRoot, packageRoot, protocolPath: resolveProtocol(packageRoot, runRoot, argv.slice(3)) };
99
+ }
100
+
25
101
  // ① 产出物模板现问(加载链的第三环):与 entry 的 READ TEMPLATE 行同源同实现(protocol-utils
26
102
  // 的 templatePointerLines),只换标签——两处措辞一处维护。零模板节点不打印。
27
103
  // 条件模板行在本通道无条件列出(本通道不读状态、不判前端),并显式标注「仅前端 change」:是否
@@ -87,15 +163,18 @@ function printNodeSkillCalls(node) {
87
163
  }
88
164
  }
89
165
 
90
- // ④ 三条命令(entry / exit / record,按节点 id 与平台化路径形态生成)。脚本路径整体加双引号:
91
- // 安装根含空格时未加引号的路径会被 shell 按空格切分(只剩路径首段被当作脚本),打印出来的命令
92
- // 便跑不了——加引号后三种平台语义下都是**单一参数**(引号本身对无空格路径无害)。
166
+ // ④ 三条命令(entry / exit / record,按节点 id 与平台化路径形态生成)。命令文本一律由
167
+ // scriptCommand 产出(唯一实现,与运行期恢复 / 预检消息同形):脚本路径整条加双引号。
93
168
  function printNodeCommands(node, scriptsDir) {
94
- const platformDir = platformScriptsDir(scriptsDir);
95
- console.log('COMMAND entry: node "' + platformDir + '/workflow-guard.mjs" entry ' + node.id);
96
- console.log('COMMAND exit: node "' + platformDir + '/workflow-guard.mjs" exit ' + node.id + ' --apply');
97
- console.log('COMMAND record: node "' + platformDir + '/workflow-state.mjs" record ' + node.id
98
- + " '{\"summary\":\"<完成摘要>\"}'");
169
+ console.log('COMMAND entry: ' + scriptCommand({
170
+ scriptsDir, script: 'workflow-guard.mjs', args: ['entry', node.id],
171
+ }));
172
+ console.log('COMMAND exit: ' + scriptCommand({
173
+ scriptsDir, script: 'workflow-guard.mjs', args: ['exit', node.id, '--apply'],
174
+ }));
175
+ console.log('COMMAND record: ' + scriptCommand({
176
+ scriptsDir, script: 'workflow-state.mjs', args: ['record', node.id, `'{"summary":"<完成摘要>"}'`],
177
+ }));
99
178
  }
100
179
 
101
180
  // explain <node>:缺参 / 纯空白 / 拿选项当节点名(如 --help)→ 用法错误(fail-closed,不猜)
@@ -1,12 +1,16 @@
1
1
  // 状态读写与 .specs 路径上下文(单一归属):状态文件解析 / 原子写落盘 / 活动 change 解析 /
2
2
  // change 目录边界,以及各命令族共用的路径锚(runRoot · specsRoot · statePath)。
3
- // 路径锚由入口在分派前初始化一次(runRoot = 进程 cwd)——模块内不自行取 cwd:入口与模块
4
- // 各持一份「运行根」就是同一事实的第二处表达。目录名与状态文件名常量来自 state-schema.mjs。
3
+ // 路径锚由入口在分派前初始化一次;运行根由唯一解析模块(run-root.mjs)给定——FLOW_COMET_RUN_ROOT
4
+ // 优先、否则进程 cwd。模块内不自行取 cwd:入口与模块各持一份「运行根」就是同一事实的第二处表达。
5
+ // 目录名与状态文件名常量来自 state-schema.mjs。
5
6
  import { promises as fs } from 'fs';
6
7
  import path from 'path';
7
8
  import { validateStateFields, writeJsonAtomic, RUNTIME_DIR, RUNTIME_STATE_FILE_NAME } from '../state-schema.mjs';
8
9
  import { inspectWorkflowPathSegments } from '../protocol-utils.mjs';
9
10
  import { isSingleSegmentChangeName } from '../route-node.mjs';
11
+ // 归档目录名的日期前缀判据(<YYYY-MM-DD>-<change-id>)由 time-utils 单源表达:本模块只取「日期
12
+ // 前缀」这一事实再精确比对整名,不在路径规则里内联第二份日期正则。
13
+ import { archiveDateFromName } from '../time-utils.mjs';
10
14
 
11
15
  let runtimeContext = null;
12
16
 
@@ -145,3 +149,52 @@ export async function inspectReentryChangeDir(changeName) {
145
149
  if (!(await hasExactSpecsEntry(changeName))) return { ok: false, reason: 'change-name-invalid' };
146
150
  return { ok: true, changeDir };
147
151
  }
152
+
153
+ // 归档目录名是否本 change 的归档目录:`<YYYY-MM-DD>-<change-id>` 精确形态,不做后缀匹配。
154
+ // 别的 change 的归档目录也可能以 `-<本 change>` 结尾(如 other-<本 change>),后缀匹配会把**别的
155
+ // change 的目录**认作本 change 的:声明标记门据此拿别人的声明替本 change 作证、归档提名据此数别人的
156
+ // SUMMARY 份数、守卫据此把本 change 判成「已归档」而跳过真实跑验证命令。日期形态取 time-utils 的单源
157
+ // 判定,本处只把整名与日期前缀拼回去做精确比对。
158
+ //
159
+ // 三个消费面(声明标记目录解析、守卫的「是否已归档」、归档提名的 SUMMARY 份数)都走这一条判据:
160
+ // 归档目录名是「哪个 change 的」这一事实只有一种说法,各写一份必然在「后缀算不算数」上分叉。
161
+ export function isArchivedChangeDirName(entry, changeName) {
162
+ if (typeof entry !== 'string' || typeof changeName !== 'string' || changeName === '') return false;
163
+ const archiveDate = archiveDateFromName(entry);
164
+ return archiveDate !== null && entry === archiveDate + '-' + changeName;
165
+ }
166
+
167
+ // 声明标记目录解析(活动路径 .specs/<change-id>/.skill-loads/ 优先;归档路径兜底——archive 节点
168
+ // 「先移目录后 record/exit」顺序下 change 目录已在 .specs/archive/<日期>-<change-id>/,标记只随目录
169
+ // 移动:只查活动路径会把「标记存在」误判成「机制未激活」)。归档目录按整名精确比对——协议声明的
170
+ // archive/*-<change-id> 是产物 glob,目录名约定才是 <日期>-<change-id>(判据见
171
+ // isArchivedChangeDirName)。两者皆无 → null,调用方按旧 change 兼容跳过。
172
+ //
173
+ // includeArchive 是这条规则唯一的形态开关,缺省 true(兜底归档)。入口侧(workflow-guard 的
174
+ // checkPromptDeclarations)传 false:入口核对的是**这一轮**写下的声明,归档里的声明属于归档前的
175
+ // 执行者——拿它替当前节点作证会把「这一轮没声明」判成「声明过」,错路径的声明因此漏过。这个差异
176
+ // 是有意的,所以给它一个名字,而不是让调用方另拼一份路径。
177
+ //
178
+ // 落点在本模块(.specs 路径上下文):它是一条 change 目录的定位规则,不是某一族的判定——状态命令族与
179
+ // 守卫族消费的是同一条规则,各写一份必然在「活动目录是否回溯归档」「多归档目录取哪个」上分叉。
180
+ // 运行根是显式参数:两族各注入自己的根(状态族 runRootDir()、守卫族 runRoot),规则因此不绑定任何
181
+ // 一族的运行上下文(守卫进程没有 initStateContext 建立的上下文)。依赖方向也由此确定:守卫侧取用本
182
+ // 模块是允许的 guard → state-* 单向边;反向(状态族 import 守卫族)会让状态 CLI 为一条路径规则加载
183
+ // 整个守卫图。
184
+ export async function findSkillLoadsDir(root, changeName, { includeArchive = true } = {}) {
185
+ const activeDir = path.join(root, '.specs', changeName, '.skill-loads');
186
+ if (await fileExists(activeDir)) {
187
+ return { dir: activeDir, display: '.specs/' + changeName + '/.skill-loads/' };
188
+ }
189
+ if (!includeArchive) return null;
190
+ const archiveRoot = path.join(root, '.specs', 'archive');
191
+ const entries = await fs.readdir(archiveRoot).catch(() => []);
192
+ for (const entry of entries) {
193
+ if (!isArchivedChangeDirName(entry, changeName)) continue;
194
+ const candidate = path.join(archiveRoot, entry, '.skill-loads');
195
+ if (await fileExists(candidate)) {
196
+ return { dir: candidate, display: '.specs/archive/' + entry + '/.skill-loads/' };
197
+ }
198
+ }
199
+ return null;
200
+ }
@@ -1,5 +1,5 @@
1
1
  // skill-load 声明标记族(单一归属):--prompt 参数提取与归属校验、协议 scope 绑定查询、
2
- // 标记目录解析、节点声明存在性,以及 completedChecks 的真实性校验。
2
+ // 标记目录解析(路径规则取自 state-io)、节点声明存在性,以及 completedChecks 的真实性校验。
3
3
  // 诚实边界:标记是「声明」而非物理证明——运行时没有 Skill 调用观察点,脚本无法确认执行者
4
4
  // 真实加载过该 skill;标记仅证明「执行者主动声明已加载」,由流程纪律兜底。handoff 条目的证据
5
5
  // 同样不是物理证明——它是子代理回传的 Return Contract 委托声明(子代理自称已加载并执行),
@@ -11,30 +11,74 @@ import {
11
11
  nodeTemplateDeclaration,
12
12
  normalizeTemplateName,
13
13
  templateDeclarationProblems,
14
- templateDeclareCommand,
15
14
  templateKeyOf,
16
15
  } from '../protocol-utils.mjs';
17
- import { fileExists, readJson, specsDir } from './state-io.mjs';
16
+ // 声明命令的唯一装配(脚本路径 + 全部 --prompt + 模板全清单 + 协议上下文)落在中立的命令文本模块:
17
+ // 守卫族取同一份(它有自己的运行上下文),本族按状态命令族的运行上下文取用——两族各拼一份时
18
+ // 只有一种文本能执行。
19
+ import { declarationCommand } from './state-explain.mjs';
20
+ // 声明标记目录的路径规则(活动路径优先、归档路径兜底)由本族的路径上下文模块持有:同一条规则被
21
+ // 状态命令族与守卫族消费,本模块只把状态命令族的运行上下文作为根注入(守卫侧按自己的运行根取用
22
+ // 同一份实现)——两族各写一份扫描,会在「活动目录在不在场」「多归档目录取哪个」上给出不同答案。
23
+ import {
24
+ fileExists,
25
+ findSkillLoadsDir as findSkillLoadsDirAtRoot,
26
+ readJson,
27
+ runRootDir,
28
+ specsDir,
29
+ } from './state-io.mjs';
18
30
 
19
- // --prompt 原始参数提取(skill-load 专用参数):--protocol 由 resolveProtocol 全局解析
31
+ // --prompt 原始参数收集(skill-load 专用参数):--protocol 由 resolveProtocol 全局解析
20
32
  // (CLI > env > 默认)为工作流协议 JSON——skill-load 曾用 --protocol 传 prompt 路径,主仓真实链路
21
33
  // 必现撞车(markdown 被当协议 JSON 解析 → 启动报错「workflow protocol file is not valid JSON」)。
22
- // 改名 --prompt 后与全局协议解析彻底解耦;此处仅取用户显式传入的原始值,供 skill-load
34
+ // 改名 --prompt 后与全局协议解析彻底解耦;此处取用户显式传入的**全部**原始值,供 skill-load
23
35
  // 的 flow-kit/prompts/ 归属校验与标记记录。
24
- export function findPromptArg(cliArgs) {
25
- for (let index = 0; index < cliArgs.length; index++) {
36
+ //
37
+ // 支持 `--prompt a --prompt b` 与 `--prompt=a`,可重复出现(累加保序、去重)。一个节点该读的
38
+ // 协议常常不止一份(open 两份、review 两份),而「读了几份协议」正是出口覆盖判据要核对的事实——
39
+ // 只取第一个会让第二个声明被静默丢弃,声明面永远凑不齐(覆盖判据据此报「未声明」,而执行者
40
+ // 明明写下了那条命令)。后随参数是另一个选项(以 -- 开头)时不当成路径;空值忽略。
41
+ export function findPromptArgs(cliArgs) {
42
+ const values = [];
43
+ const collect = (raw) => {
44
+ if (typeof raw !== 'string' || raw === '') return;
45
+ if (!values.includes(raw)) values.push(raw);
46
+ };
47
+ for (let index = 0; index < (cliArgs ?? []).length; index++) {
26
48
  const arg = cliArgs[index];
27
49
  if (arg === '--prompt') {
28
- const value = cliArgs[index + 1];
29
- if (typeof value !== 'string' || value === '') return null;
30
- return value;
50
+ const next = cliArgs[index + 1];
51
+ const hasValue = typeof next === 'string' && !next.startsWith('--');
52
+ collect(hasValue ? next : '');
53
+ if (hasValue) index += 1;
54
+ continue;
31
55
  }
32
56
  if (typeof arg === 'string' && arg.startsWith('--prompt=')) {
33
- const value = arg.slice('--prompt='.length);
34
- return value === '' ? null : value;
57
+ collect(arg.slice('--prompt='.length));
35
58
  }
36
59
  }
37
- return null;
60
+ return values;
61
+ }
62
+
63
+ // 声明标记里「已声明的协议文件」提取(唯一实现:出口覆盖判据与任何读标记的消费方共用):
64
+ // · protocols 数组(skill-load 多条 --prompt 的写入形态)∪ protocol 单值(收紧前的写入形态,
65
+ // 以及 record 自动补写的标记);
66
+ // · 每个值都按 basename 归一——旧标记可能是完整绝对路径(历史缺陷期写入的形态),新标记是
67
+ // basename;两种形态必须比对同一口径(节点协议映射表只存 basename)。
68
+ // 返回去重保序的 basename 数组;null / 空串 / 非字符串一律忽略(fail-closed:覆盖判据只认
69
+ // 真正声明了的值,损坏值不会冒充任何一份协议文件)。
70
+ export function markerProtocolBasenames(marker) {
71
+ const raw = [];
72
+ if (Array.isArray(marker?.protocols)) raw.push(...marker.protocols);
73
+ raw.push(marker?.protocol);
74
+ const basenames = [];
75
+ for (const value of raw) {
76
+ if (typeof value !== 'string' || value === '') continue;
77
+ const base = String(value).replaceAll('\\', '/').split('/').pop();
78
+ if (!base) continue;
79
+ if (!basenames.includes(base)) basenames.push(base);
80
+ }
81
+ return basenames;
38
82
  }
39
83
 
40
84
  // flow-kit/prompts/ 归属校验(相对或绝对路径,前缀校验)——flow-kit 为 vendored 上游,
@@ -62,25 +106,15 @@ export function findRequiredSkillBinding(protocol, nodeId, skillName) {
62
106
  return (node.requiredSkillCalls ?? []).find((binding) => binding.skill === skillName) ?? null;
63
107
  }
64
108
 
65
- // 标记目录解析——活动路径 .specs/<change-id>/.skill-loads/ 优先;归档路径兜底
66
- // (archive 节点「先移目录后 record/exit」顺序下 change 目录已在 .specs/archive/<前缀>-<change-id>/,
67
- // 标记只随目录移动——只查活动路径会误报缺失)。归档扫描匹配后缀 -<change-id>(前缀可含日期等,
68
- // 与协议 flowkit.archive.v1 的 archive/*-<change-id> artifact 路径同构)。两者皆无 → null。
69
- export async function findSkillLoadsDir(changeName) {
70
- const activeDir = path.join(specsDir(), changeName, '.skill-loads');
71
- if (await fileExists(activeDir)) {
72
- return { dir: activeDir, display: '.specs/' + changeName + '/.skill-loads/' };
73
- }
74
- const archiveRoot = path.join(specsDir(), 'archive');
75
- const entries = await fs.readdir(archiveRoot).catch(() => []);
76
- for (const entry of entries) {
77
- if (!entry.endsWith('-' + changeName)) continue;
78
- const candidate = path.join(archiveRoot, entry, '.skill-loads');
79
- if (await fileExists(candidate)) {
80
- return { dir: candidate, display: '.specs/archive/' + entry + '/.skill-loads/' };
81
- }
82
- }
83
- return null;
109
+ // 标记目录解析(活动路径 .specs/<change-id>/.skill-loads/ 优先,归档路径兜底——archive 节点
110
+ // 「先移目录后 record/exit」顺序下 change 目录已在 .specs/archive/<日期>-<change-id>/,标记只随
111
+ // 目录移动):路径规则与守卫族同一份实现,实现在本族的路径上下文模块(state-io),本处只注入状态
112
+ // 命令族的运行根。规则落状态族而不是守卫族是依赖方向决定的:状态命令族不得 import 守卫族(否则
113
+ // 一条路径规则就让状态 CLI 加载整个守卫图),守卫侧按允许的 guard → state-* 方向取用同一份实现。
114
+ // 两族各持一份扫描时,同一个标记会因「活动目录在场是否回溯归档」「多归档目录取哪个」各自得出答案。
115
+ // 两者皆无 → null。
116
+ export function findSkillLoadsDir(changeName) {
117
+ return findSkillLoadsDirAtRoot(runRootDir(), changeName);
84
118
  }
85
119
 
86
120
  // 节点技能加载声明标记存在性(技能加载前置门·方案 A):校验 .skill-loads/ 下
@@ -113,8 +147,9 @@ export async function hasNodeSkillDeclaration(nodeId, changeName) {
113
147
  //(无 .skill-loads/ 或本节点无标记)——后者由「缺少技能加载声明标记」门负责,不重复报
114
148
  //(与 exit 侧协议声明校验的「未激活不追溯」同一口径)。
115
149
  // 零模板的内置节点(verify / archive)省略 --templates 即视为空集,通过。
116
- export async function verifyTemplateDeclaration({ protocol, nodeId, changeName, newChange }) {
117
- const declaration = nodeTemplateDeclaration((protocol?.nodes ?? []).find((node) => node.id === nodeId));
150
+ export async function verifyTemplateDeclaration({ protocol, nodeId, changeName, newChange, commandContext: context }) {
151
+ const declarationNode = (protocol?.nodes ?? []).find((node) => node.id === nodeId);
152
+ const declaration = nodeTemplateDeclaration(declarationNode);
118
153
  if (declaration.source !== 'builtin' || !changeName) return { ok: true };
119
154
  const loadsDir = await findSkillLoadsDir(changeName);
120
155
  if (loadsDir === null) return { ok: true };
@@ -123,6 +158,9 @@ export async function verifyTemplateDeclaration({ protocol, nodeId, changeName,
123
158
  .filter((name) => name.startsWith(prefix) && name.endsWith('.json'));
124
159
  if (markers.length === 0) return { ok: true };
125
160
  const declared = [];
161
+ // 执行者写过声明的技能(按技能去重保序——一个 node-skill 只有一个标记文件):重新声明命令按
162
+ // **同一批技能**派发——拿节点级目标集重发会顺手覆写别人没提的那几条,只给一个占位符又等于没给命令。
163
+ const declaredSkills = [];
126
164
  let explicitMarkers = 0;
127
165
  for (const markerName of markers) {
128
166
  let marker;
@@ -135,6 +173,10 @@ export async function verifyTemplateDeclaration({ protocol, nodeId, changeName,
135
173
  // (exit 侧已有「建议手动 skill-load」提示),不拿它算缺失
136
174
  if (marker?.auto === true) continue;
137
175
  explicitMarkers += 1;
176
+ // 技能名取**标记文件名**(<node>-<skill>.json 是这份标记的身份,扫描与覆盖判据也按它认):
177
+ // marker.skill 可能被手改成别的值,文件名才是这条命令要覆写的那一份。
178
+ const markerSkill = markerName.slice(prefix.length, markerName.length - '.json'.length);
179
+ if (markerSkill !== '' && !declaredSkills.includes(markerSkill)) declaredSkills.push(markerSkill);
138
180
  if (!Array.isArray(marker?.templates)) continue; // 旧标记无该字段 = 未声明
139
181
  for (const name of marker.templates) {
140
182
  if (typeof name !== 'string' || name.trim() === '') continue;
@@ -150,9 +192,15 @@ export async function verifyTemplateDeclaration({ protocol, nodeId, changeName,
150
192
  const detail = [];
151
193
  if (problems.missing.length > 0) detail.push('漏写: ' + problems.missing.join('、'));
152
194
  if (problems.extra.length > 0) detail.push('多写/错名: ' + problems.extra.join('、'));
153
- const declareCommand = templateDeclareCommand(declaration, { nodeId });
195
+ // 重新声明命令与恢复段同一装配(脚本路径 + 该节点全部协议文件 + 模板全清单 + 协议上下文):
196
+ // 只补 --templates 的旧形态会把 protocol 写成 null,下一次 exit 反被判「缺协议声明标记」;
197
+ // 裸脚本名的旧形态照抄是 command not found(恢复步骤自己走不通)。
198
+ const declareCommands = declaredSkills
199
+ .map((skill) => declarationCommand({ node: declarationNode, skill, context }));
154
200
  const reason = '节点 ' + nodeId + ' 的模板声明与节点映射不一致(' + detail.join(';')
155
- + ';映射要求: ' + describeTemplateList(declaration.required) + ')——重跑 ' + declareCommand + ' 重新声明';
201
+ + ';映射要求: ' + describeTemplateList(declaration.required) + ')——重跑下面的命令重新声明'
202
+ + '(同一 node-skill 重跑会覆写该标记):\n'
203
+ + declareCommands.map((command) => ' ' + command).join('\n');
156
204
  if (newChange === true) return { ok: false, reason };
157
205
  return { ok: true, warn: reason };
158
206
  }
@@ -166,7 +214,7 @@ export async function verifyTemplateDeclaration({ protocol, nodeId, changeName,
166
214
  // 如 subagent-execute 节点的 flow-comet-dev)豁免标记,以共用证据库 evidence['subagent-execute']
167
215
  // 的 handoffResult(有委托记录即满足)为证据;main scope / 协议外条目仍要求标记(fail-closed)。
168
216
  // 返回 { ok: true } 或 { ok: false, reason }(fail-closed:无 active change / 标记损坏同样 BLOCK)。
169
- export async function verifySkillLoadMarkers(completedChecks, changeName, recordTime, protocol, state) {
217
+ export async function verifySkillLoadMarkers(completedChecks, changeName, recordTime, protocol, state, context) {
170
218
  if (!Array.isArray(completedChecks)) return { ok: true };
171
219
  const required = [];
172
220
  for (const check of completedChecks) {
@@ -206,7 +254,7 @@ export async function verifySkillLoadMarkers(completedChecks, changeName, record
206
254
  continue;
207
255
  }
208
256
  // 标记路径解析——活动路径优先,归档路径兜底(archive 节点「先移目录后 record」
209
- // 顺序下标记只在 .specs/archive/*-<change-id>/.skill-loads/);两处都找不到 → BLOCK + 指引
257
+ // 顺序下标记只在 .specs/archive/<日期>-<change-id>/.skill-loads/);两处都找不到 → BLOCK + 指引
210
258
  // (不静默放行)。展示路径补 .specs/ 前缀便于用户定位。
211
259
  const markerName = item.node + '-' + item.skill + '.json';
212
260
  const activeDisplay = '.specs/' + path.posix.join(changeName, '.skill-loads', markerName);
@@ -224,10 +272,17 @@ export async function verifySkillLoadMarkers(completedChecks, changeName, record
224
272
  }
225
273
  }
226
274
  if (!markerPath) {
275
+ // 声明命令由协议派生(该条目所指节点的全部协议文件 + 模板全清单),脚本路径与协议上下文由
276
+ // 唯一装配补齐:只给 "skill-load <node> <skill>" 或裸脚本名的旧形态,照抄后会被模板声明门 /
277
+ // 出口覆盖门逐个拦下,或在 shell 里 command not found——报文给出的东西必须一次补齐。
278
+ // 协议外节点(旧证据里出现过、当前协议已删)取不到节点声明:仍按条目里的节点名给命令,
279
+ // 不拼引擎映射(没有映射就没有 --prompt / --templates 可拼——不编造)。
280
+ const declaredNode = (protocol?.nodes ?? []).find((node) => node.id === item.node) ?? { id: item.node };
227
281
  return {
228
282
  ok: false,
229
283
  reason: 'completedChecks 条目 ' + item.raw + ' 缺少对应声明标记 ' + activeDisplay +
230
- '(归档路径也未找到)——先加载该 skill 并运行 workflow-state.mjs skill-load ' + item.node + ' ' + item.skill,
284
+ '(归档路径也未找到)——先加载该 skill 并照抄下面的命令声明已加载:\n '
285
+ + declarationCommand({ node: declaredNode, skill: item.skill, context }),
231
286
  };
232
287
  }
233
288
  let marker;
@@ -246,6 +246,9 @@ export function completeFixTaskAndRecord(dir, env) {
246
246
  writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', fixBatchTaskText('done'));
247
247
  writeFile(dir, '.specs/' + CHANGE_ID + '/T-FIX-01-SUMMARY.md', execSummaryFixture('T-FIX-01'));
248
248
  assertExit(runState(['skill-load', 'execute', 'flow-comet-execute', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir, env), 0);
249
+ // 协议 execute.requiredSkillCalls = flow-comet-dev(guarded):出口覆盖判据要求该技能也有标记——
250
+ // 只声明实现技能 flow-comet-execute 时覆盖缺口会被拦下(节点实现技能与必需技能是两个声明面)。
251
+ assertExit(runState(['skill-load', 'execute', 'flow-comet-dev', '--prompt', 'flow-kit/prompts/4-dev.md', '--templates', 'SUMMARY.md'], dir, env), 0);
249
252
  const rec = runState(['record', 'execute', '{"summary":"fix batch executed","parallelTakeoverApproved":true}'], dir, env);
250
253
  assertExit(rec, 0);
251
254
  assertOut(rec, 'EVIDENCE: execute');
@@ -635,6 +638,9 @@ export function multiWaveTaskContent(statusMap) {
635
638
  export function driveThroughDesign(dir) {
636
639
  assertExit(runState(['init', CHANGE_ID], dir), 0);
637
640
  assertExit(runState(['skill-load', 'open', 'flow-comet-change', '--prompt', 'flow-kit/prompts/0-change.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
641
+ // open 该读两份协议、协议声明两个必需技能(flow-comet-change / flow-comet-requirement):出口的
642
+ // 覆盖判据要求全部声明——只声明一份时连 design 都推进不到(声明门先拦),前奏形同虚设。
643
+ assertExit(runState(['skill-load', 'open', 'flow-comet-requirement', '--prompt', 'flow-kit/prompts/1-requirement.md', '--templates', 'CHANGE.md,REQUIREMENT.md'], dir), 0);
638
644
  writeIntakeArtifacts(dir);
639
645
  assertExit(runState(['record', 'open', '{"summary":"intake complete"}'], dir), 0);
640
646
  assertExit(runGuard(['entry', 'open'], dir), 0);