flow-comet 1.6.5 → 1.8.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 (89) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +32 -18
  3. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +2 -2
  4. package/.flow-comet/skills/flow-comet/reference/decision-points.md +5 -5
  5. package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
  6. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +30 -11
  7. package/.flow-comet/skills/flow-comet/reference/fix-loop.md +4 -4
  8. package/.flow-comet/skills/flow-comet/reference/init-detection.md +1 -1
  9. package/.flow-comet/skills/flow-comet/reference/platform-facts.md +2 -2
  10. package/.flow-comet/skills/flow-comet/reference/post-archive-handoff.md +264 -0
  11. package/.flow-comet/skills/flow-comet/reference/recovery.md +1 -1
  12. package/.flow-comet/skills/flow-comet/reference/replan.md +1 -1
  13. package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +1 -0
  14. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +270 -30
  15. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
  16. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +14 -94
  17. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +122 -11
  18. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +79 -40
  19. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +11 -9
  20. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
  21. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +1 -1
  22. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +128 -56
  23. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +357 -3
  24. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +26 -1
  25. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +6 -2
  26. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +29 -21
  27. package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +4 -15
  29. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +47 -5
  30. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +357 -219
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +725 -309
  32. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +182 -54
  33. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
  34. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +224 -83
  35. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +17 -28
  36. package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +61 -33
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +663 -205
  41. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +68 -9
  42. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +11 -4
  43. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +92 -13
  44. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +232 -11
  45. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +140 -74
  46. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +8 -4
  47. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
  48. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +0 -3
  49. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +248 -24
  50. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +63 -3
  51. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +181 -8
  52. package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +340 -0
  53. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +132 -20
  54. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +12 -5
  55. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1564 -54
  56. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1489 -38
  57. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1466 -243
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +743 -24
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +220 -92
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +657 -21
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +41 -27
  62. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +285 -9
  63. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +7 -6
  64. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +21 -15
  65. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +8 -5
  66. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +45 -36
  67. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +2 -2
  68. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2381 -85
  69. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -2
  70. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +143 -16
  71. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +339 -103
  72. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
  73. package/.flow-comet/skills/flow-comet-archive/SKILL.md +33 -11
  74. package/.flow-comet/skills/flow-comet-change/SKILL.md +1 -1
  75. package/.flow-comet/skills/flow-comet-design/SKILL.md +5 -3
  76. package/.flow-comet/skills/flow-comet-dev/SKILL.md +2 -2
  77. package/.flow-comet/skills/flow-comet-execute/SKILL.md +37 -13
  78. package/.flow-comet/skills/flow-comet-integration/SKILL.md +10 -4
  79. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  80. package/.flow-comet/skills/flow-comet-plan/SKILL.md +13 -6
  81. package/.flow-comet/skills/flow-comet-review/SKILL.md +21 -12
  82. package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +1 -1
  83. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +43 -18
  84. package/.flow-comet/skills/flow-comet-task/SKILL.md +4 -2
  85. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
  86. package/.flow-comet/skills/flow-comet-verify/SKILL.md +1 -1
  87. package/README.md +2 -2
  88. package/package.json +1 -1
  89. package/scripts/dsh-bridge.mjs +238 -21
@@ -1 +1 @@
1
- 1.6.5
1
+ 1.8.0
@@ -61,12 +61,12 @@ description: "Use when the user wants the flow-comet managed workflow for flow-k
61
61
 
62
62
  | 分类 | 定义 | 处理 |
63
63
  |------|------|------|
64
- | 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | 用交互确认问(Claude Code 用 AskUserQuestion 优先;Codex 用文本提问+内联确认)或文本回退;相邻选择合并为一个问题,不重问已持久化选择 |
64
+ | 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | dsh 用 ask_user_question、Claude Code 用 AskUserQuestion、Codex 用 ask_user_question——当前版本没有该工具时退回文本提问 + 内联确认;非交互会话:不提问、把该决策点显式报告为未决并停下(不替用户选择);相邻选择合并为一个问题,不重问已持久化选择 |
65
65
  | 自动处理 | 唯一安全下一步 | 直接执行并汇报,不许制造确认 |
66
66
  | 停止条件 | guard 失败 / 缺依赖 / 状态损坏 | 报告阻塞与恢复条件,无合法动作时才升级为用户决策 |
67
67
  | 手动交接 | `NEXT: manual`(若有) | 不是用户决策,直接继续 |
68
68
 
69
- **决策点分布(挂到四分类下 · 逐节点作者化的完整清单见 `reference/decision-points.md`)**:**用户决策**集中在六个相位——open(主题 / 范围澄清)· design(技术栈选型)· execute(破坏性变更 R4.6 / Schema 迁移 R4.5 / 切 direct 模式并记录 `directOverride`)· review(Critical 项处置)· verify(UAT 第 4 次失败,机器计数 `verifyFailures`)· archive(归档 / 合并 main / PR approve);**自动处理**=唯一安全下一步直接执行(flow-kit 反问协议要求确认时按 flow-kit 规则暂停等待);**停止条件**=guard 失败先自动诊断并执行唯一安全修复,缺依赖或状态损坏时报阻塞与恢复条件,只有恢复方式存在多个合法选项时才升级为用户决策。
69
+ **决策点分布(挂到四分类下 · 逐节点作者化的完整清单见 `reference/decision-points.md`)**:**用户决策**集中在六个相位——open(主题 / 范围澄清)· design(技术栈选型)· execute(破坏性变更 R4.6 / Schema 迁移 R4.5 / 切 direct 模式并记录 `directOverride`)· review(Critical 项处置)· verify(UAT 第 4 次失败,机器计数 `verifyFailures`)· archive(归档 / PR approve);归档收尾按项目既有流程(PR 或本地合并;本地合并前仍等用户确认);交接本身不做分支操作;**自动处理**=唯一安全下一步直接执行(flow-kit 反问协议要求确认时按 flow-kit 规则暂停等待);**停止条件**=guard 失败先自动诊断并执行唯一安全修复,缺依赖或状态损坏时报阻塞与恢复条件,只有恢复方式存在多个合法选项时才升级为用户决策。
70
70
 
71
71
  > **当你遇到四分类里的「用户决策」、不确定该不该停下来问时读 `reference/decision-points.md`**(按节点作者化的确认点清单 + 机制性决策点,逐条给出触发条件与处置)。
72
72
 
@@ -81,14 +81,14 @@ description: "Use when the user wants the flow-comet managed workflow for flow-k
81
81
  | "LESSONS.md 不用扫" | R1.8:每个 DEV 任务必须扫描 |
82
82
  | "测试从实现派生就行" | R5.1:测试必须从 AC 派生 |
83
83
  | "guard 失败了,让用户决定" | 先自动诊断并执行唯一安全修复;无合法动作时才报告停止条件 |
84
- | "跳过 entry 直接 exit,反正没检查" | 新 change 未 entry 直接 exit → BLOCKED(进入检查不可跳过);旧 change WARN 渐进 |
85
- | "SUMMARY 不写,任务先标 done" | 新 change done 任务缺 SUMMARY → BLOCKED(产物完整性强制);旧 change WARN 渐进 |
84
+ | "跳过 entry 直接 exit,反正没检查" | 未 entry 直接 exit → BLOCKED(进入检查不可跳过——单一判级,没有放宽侧) |
85
+ | "SUMMARY 不写,任务先标 done" | done 任务缺 SUMMARY → BLOCKED(产物完整性强制——单一判级) |
86
86
  | "subagent-execute 阶段,我直接改源码更快" | 协调者禁令:subagent-execute 阶段主会话禁止写源码(hook 白名单只允许 .specs/,Write/Edit 与 Bash 写命令均物理拦截),必须委托子代理——委托走**身份通道**(三平台同一判据),worktree 只是「① 写权限」的实现之一,不是委托前提 |
87
- | "用户要健康检查 / 同步架构,我给他 init 一个新 change" | 三条侧命令(evolve / health / context-scan)**不进 8 节点流程**——它们不路由、不 entry/exit、不写节点证据;按下方「侧命令」小节的命令面直接执行即可 |
87
+ | "用户要健康检查 / 同步架构,我给他新开一个 change" | 三条侧命令(evolve / health / context-scan)**不进 8 节点流程**——它们不路由、不 entry/exit、不写节点证据;按下方「侧命令」小节的命令面直接执行即可 |
88
88
 
89
89
  ## 侧命令(横向命令 · 不进 8 节点流程)
90
90
 
91
- 随包分发的三条**侧命令**不属于 8 节点流程:不参与节点路由,不被 `entry` / `exit` 门禁校验,也不会在流程里自动触发——一律由用户**显式调用**,涉及写入的动作要**人工逐项确认**。**上游对应物(只读基准,不修改)**:`flow-kit/prompts/{A-evolve,M-health,I-intel-scan}.md`——三条命令均已按本仓语义**显式覆盖**上游表述。**以下上游语义不采用**:① 把三条命令当作流程内的节点或自动触发项(上游各自成篇、不声明与 8 节点的关系)→ 本仓一律**显式调用**:不路由、不 `entry` / `exit`、不写节点证据;② 把三条命令的语义细则抄进入口册(同一口径两处表达)→ 本仓只在入口留**指针**,细则以各自技能册的「覆盖声明」为单一表达。**冲突处以各自技能册的「覆盖声明」与引擎实现为准**。用户表达下列意图时,**不要** `init` 新 change、**不要** `entry` / `exit` 任何节点,直接加载对应技能并按其协议执行:
91
+ 随包分发的三条**侧命令**不属于 8 节点流程:不参与节点路由,不被 `entry` / `exit` 门禁校验,也不会在流程里自动触发——一律由用户**显式调用**,涉及写入的动作要**人工逐项确认**。**上游对应物(只读基准,不修改)**:`flow-kit/prompts/{A-evolve,M-health,I-intel-scan}.md`——三条命令均已按本仓语义**显式覆盖**上游表述。**以下上游语义不采用**:① 把三条命令当作流程内的节点或自动触发项(上游各自成篇、不声明与 8 节点的关系)→ 本仓一律**显式调用**:不路由、不 `entry` / `exit`、不写节点证据;② 把三条命令的语义细则抄进入口册(同一口径两处表达)→ 本仓只在入口留**指针**,细则以各自技能册的「覆盖声明」为单一表达。**冲突处以各自技能册的「覆盖声明」与引擎实现为准**。用户表达下列意图时,**不要** `init` 新建 change、**不要** `entry` / `exit` 任何节点,直接加载对应技能并按其协议执行:
92
92
 
93
93
  | 命令 | 触发词(用户怎么说) | 用途 | 落盘产物 | 技能 |
94
94
  |------|---------------------|------|---------|---------|
@@ -126,6 +126,8 @@ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--
126
126
  | verify | control | 集成验证 + UAT | flowkit.verify.v1 |
127
127
  | archive | control | 归档 + LESSONS | flowkit.archive.v1 |
128
128
 
129
+ > **归档顺序(证据先于不可逆)**:`entry → 声明 → 记录 → 搬目录 → CHANGELOG / STATE → 通知 → exit`——技能加载声明必须先于任何动作(尤其先于搬目录),**记录必须早于搬目录**;搬目录是唯一不可逆动作,且**仍是 `exit` 的前置**(归档目录不在场时出口的产物门直接拦下)。移动之后补声明 / 补记录仍可完成(引擎按状态判身份、按解析到的目录读写标记),但那是恢复路径;步骤权威在 `flow-comet-archive` 册。
130
+
129
131
  > **并行任务路由(节点顺序是动态的 · 多趟语义)**:TASK 含依赖已满足的 `parallel="true" status="pending"` 任务时路由到 subagent-execute——每趟委托全部依赖已满足的并行任务;子代理返回后重新判定:仍有可并行 pending 就再次进入 subagent-execute(委托节点可多次往返),存在串行 pending 时回 execute 消化一趟再循环。委托节点的完成 = 不存在依赖已满足的可并行 pending 且无串行残留;并行/串行交错的混排序列合法——plan 出口的硬性拦截**不止**依赖环;完整拦截集与恢复指引以 plan 节点册的「硬性拦截」段为单一来源(本文不复述,避免同一口径两处表达分叉)。全部为串行任务时走 execute,行为不变。`next` 的输出始终是权威——以 `NODE:` 输出为准,不按静态顺序推断。
130
132
 
131
133
  ### 并行委派契约(四属性)· 三平台通道
@@ -134,8 +136,8 @@ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--
134
136
 
135
137
  | 属性 | 含义(本节为口径单一来源) |
136
138
  |------|---------------------------|
137
- | ① 写权限 | 子代理写入目标的**放行依据**(含 gitignored 面):身份在场 ⇒ 子代理语义放行;**最小保护集**(`.flow-comet/flow-comet-state.json`、`reference/workflow-protocol.json`)在身份在场时**仍拦** |
138
- | ② 提交隔离 | 各写者只提交**自己的字面路径**(`git add -- <路径>` / `git commit -- <同一路径>`;多个写者共享同一工作区时禁裸 `add` / `commit -a` / `stash` / `clean` / `reset`) |
139
+ | ① 写权限 | 子代理写入目标的**放行依据**(含 gitignored 面):身份在场 ⇒ 子代理语义放行;**最小保护集**(`.flow-comet/flow-comet-state.json`、`reference/workflow-protocol.json`)在身份在场时**仍拦**,空闲态仍拦 state 文件 |
140
+ | ② 提交隔离 | 各写者只提交**自己的字面路径**(`git add -- <路径>` / `git commit -m "<消息>" -- <同一路径>`,消息在 `--` 之前;多个写者共享同一工作区时禁裸 `add` / `commit -a` / `stash` / `clean` / `reset`) |
139
141
  | ③ 验证隔离 | **同一时刻只有一个写者**(有 request 无对应 result 的在飞委托 ⇒ 不跑全量判据,待写入者收工后重跑;已作废的委托经 `workflow-handoff.mjs withdraw <task-id> --by <来源>` 撤回,留痕 `withdrawnAt` + `withdrawnBy`,已撤回 = 终态、历史不删) |
140
142
  | ④ 集成纪律 | 协调者按确定性规则**显式、可审计**地集成(`merge --no-ff` 优先、冲突难解时降级 cherry-pick 并记因;机械冲突与语义冲突分别处置) |
141
143
 
@@ -145,7 +147,7 @@ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--
145
147
 
146
148
  | 属性 | Claude Code | Codex | dsh |
147
149
  |------|-------------|-------|-----|
148
- | ① 写权限 | 载荷 `agent_id` / `agent_type`——**证实**(真机实测:子代理载荷含二者、主会话载荷不含;与 Codex 同一判据) | 载荷 `agent_id` + `agent_type`——**证实**(实测:子代理载荷 12 键含二者、主线程 10 键不含);守卫读 `agent_id`,与 CC 同一判据 | 桥接透传 `delegationDepth` **+ 通道标记**(`FLOW_COMET_AGENT_DEPTH_SOURCE`,守卫要求两者同时在场才接受 env 面身份——继承来的深度变量不作数)——**证实**(0.1.7-rc.2 全接缝重认证;本批收窄为「最小保护集除外」) |
150
+ | ① 写权限 | 载荷 `agent_id` / `agent_type`——**证实**(真机实测:子代理载荷含二者、主会话载荷不含;与 Codex 同一判据) | 载荷 `agent_id` + `agent_type`——**证实**(实测:子代理载荷 12 键含二者、主线程 10 键不含);守卫读 `agent_id`,与 CC 同一判据 | 桥接透传 `delegationDepth` **+ 通道标记**(`FLOW_COMET_AGENT_DEPTH_SOURCE`,守卫要求两者同时在场才接受 env 面身份——继承来的深度变量不作数)——**证实**(0.1.7-rc.2 全接缝重认证;本批收窄为「最小保护集除外」;**0.2.2-rc.1 官方工具核心链路真实会话通过;dsh-ops 0.5.0 已知写入工具名由桥接归一化(桥接系统测试覆盖;未做 dsh-ops 真实会话);运行中的流程里,`ops_bash` 的 script_path 形态与多目标工具(replace/batch)只对协调者拒绝;子代理是执行者、放行,但这两类形态**不经过内容检查**(脚本正文/批量目标不可见),最小保护集对它们不生效——宿主权限允许时,执行者脚本仍可能改动状态或协议文件;`ops_copy`/`ops_move`/`ops_remove` 按目标字段映射为 Write(`ops_move` 源端另判);Bash 类工具的绝对 workdir 在项目外时对协调者拒绝;PTC 默认放行,进程内直写为已记录边界;项目内可变工作目录、相对 workdir、命令内 cd、junction/symlink、解释器与 shell 删除形态为已知边界**) |
149
151
  | **谁建树**(三平台唯一差异) | 可选:harness `isolation: "worktree"` 建独立树,或共享工作区直写 | 协调者**显式** `git worktree add` 并在委派 prompt 指定 `workdir`(原生子代理无自动建树;**证实**:子代理可被指向独立目录并落盘),或共享工作区直写;**建树选择的适用面**:协调者显式 `git worktree add <路径>`(手工建树)**是受支持的建树选择**——在委派 prompt 里指定 `workdir`,写入由身份通道放行(原生子代理无自动建树);**以建树绕过边界**不受支持——用独立树规避协调者禁令 / 最小保护集 / `write_files` 互斥与提交时点纪律 / handoff 与 Return Contract 证据,或把 worktree 当作四属性的替代品。 | **不建树**:进程内子代理、同一工作区运行——**无需隔离区 ≠ 无需边界**(`write_files` 互斥 + 提交时点 + 最小保护集仍构成边界) |
150
152
 
151
153
  **已知边界(不得写成机械保证 · 摘要)**:① Codex 载荷 `cwd` = 会话根,**与实际工作目录无关**(实测证实)⇒ 路径判定在 Codex 上必错,故判定序为**身份先于路径**(精确对照见下);② 身份判据是**声明式信任边界**——守卫读到的 `agent_id` 来自宿主载荷,本机制**不声称能证明**其真实来源;③ 实测结论只覆盖限定形态,`agent_type` 取值域、嵌套委派载荷、非 Windows 环境、非 `bypassPermissions` 权限模式**均未覆盖**(未覆盖 ≠ 已验证,不得写成已支持)。
@@ -177,26 +179,38 @@ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--
177
179
  | verify | flow-comet-verify | flow-comet-integration | guarded |
178
180
  | archive | flow-comet-archive | flow-comet-integration | guarded |
179
181
 
180
- **新 change 严格模式**:`init` 创建的 change 标记为"新"(`newChange: true`)——新 change 下全部内容级检查强制 BLOCKED(处置标记/缓存证据/波次散文/越权委托/SUMMARY 完整性/进入证据等);旧 change(历史遗留,无标记)保持渐进 WARN。执行者可通过 `status` 确认当前 change 的新旧。
182
+ **单轨判级**:全部内容级检查(处置标记 / 缓存证据 / 波次散文 / 越权委托 / SUMMARY 完整性 / 进入证据等)只有一个判级——同一形态同一个判级(BLOCKED + 恢复指引),没有按 change 来历放宽的一侧。执行者可用 `status` 确认当前在办的 change。
181
183
 
182
- > **design 行绑定的前端适用性**:`flow-comet-ui-design` 与协议一致为 `guarded`,但只对**前端 change** 适用——**触发与跳过判据的唯一权威是 `flow-comet-ui-design` 册**;结构形态按其口径压缩为:`CHANGE.md` 的「视觉调性」段在场,段内「不适用」标记须成**独立行**、居**行首**,或写在适用性类标签的**字段值位**,标记之后须成**词形边界**(命中即回显**命中片段**自证)。前端须先用 Skill 工具加载该技能 + `skill-load design flow-comet-ui-design --prompt flow-kit/prompts/2a-ui-design.md --templates DESIGN.md` 建标记,并在 record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端不加载、不声明,出口打印可见的 `UI-DESIGN: skipped(非前端)` 后放行;旧 change 缺件仅 WARN。
184
+ > **design 行绑定的前端适用性**:`flow-comet-ui-design` 与协议一致为 `guarded`,但只对**前端 change** 适用——**触发与跳过判据的唯一权威是 `flow-comet-ui-design` 册**;结构形态按其口径压缩为:`CHANGE.md` 的「视觉调性」段在场,段内「不适用」标记须成**独立行**、居**行首**,或写在适用性类标签的**字段值位**,标记之后须成**词形边界**(命中即回显**命中片段**自证)。前端须先用 Skill 工具加载该技能 + `skill-load design flow-comet-ui-design --prompt flow-kit/prompts/2a-ui-design.md --templates DESIGN.md` 建标记,并在 record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端不加载、不声明,出口打印可见的 `UI-DESIGN: skipped(非前端)` 后放行。
183
185
 
184
186
  **节点技能两层加载模型(入口层 · 双步硬规则)**:路由到节点后,以下两步**都不可跳过**:
185
187
 
186
188
  1. **用 Skill 工具加载该节点的 Implementation 技能**(见下方 Skill Bindings 表 Implementation 列,如 execute → flow-comet-execute)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让该 skill 的指令生效的是 Skill 工具把它注入本次会话。
187
- 2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation 同名的条目已随路由加载,无需重复加载),加载完成后**立即**逐条运行声明命令(open/review 等涉及多个协议文件的节点,每个协议文件对应一条声明命令):
189
+ 2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation 同名的条目已随路由加载,无需重复加载),加载完成后**立即**声明「加载了哪个技能、按哪份协议工作」。**一个节点该读的协议常常不止一份**(open 是 `0-change.md` + `1-requirement.md`,review 是 `6-review.md` + `5-test.md`)——**一份命令可以给多个 `--prompt`**,`skill-load` 会把它们**全部**记进同一个标记,不是只留第一个:
188
190
 
189
191
  ```bash
190
- node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <skill> --prompt flow-kit/prompts/<阶段>.md --templates <模板基名,...>
192
+ # 单份协议(plan):本节点只有一个必需技能
193
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load plan flow-comet-task --prompt flow-kit/prompts/3-task.md --templates TASK.md
194
+
195
+ # 多份协议(open):一条命令两个 --prompt,两份都记进标记
196
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-change --prompt flow-kit/prompts/0-change.md --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
197
+
198
+ # 同一节点有两个 guarded 必需技能(open = change + requirement):**每个必需技能各一条**——
199
+ # 一条命令只写一个技能标记,少一条就少一个技能;每条都带该节点的全部 --prompt 与模板全清单
200
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-requirement --prompt flow-kit/prompts/0-change.md --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
191
201
  ```
192
202
 
193
- > **提示词 = 步骤权威、模板 = 段形权威,两者缺一即未完成加载**:`--prompt` 指向的 `flow-kit/prompts/<阶段>.md` 规定这一步**怎么做**(流程步骤、检查项、交接物),`--templates` 指向的 `flow-kit/templates/<DOC>.md` 规定产出**长什么样**(标题、段序、段形)。节点入口先打印 `READ PROMPT:`;**有模板的节点**再打印 `READ TEMPLATE:`(verify / archive 为零模板节点,只打印一行);**两条 READ 行都要读**。design 的**前端** change 还会多打印一行 `READ PROMPT(条件提示词): …2a-ui-design.md…`(按 `frontendCriterion` 判定;非前端不打印)。`--prompt` 必须是该节点的协议文件(以入口打印的 `READ PROMPT:` 行为准);错路径由入口(核对已写下的声明)与出口(核对节点协议集)两侧拦下(BLOCKED),不会静默写成一条与节点无关的声明。
203
+ > **分条等价**:按协议文件分几条命令声明,与合并成一条等价——出口判据按节点汇总,只问「该读的这几份是否都被声明过」。
204
+
205
+ > **一次声明把三个面给全**:该节点该读的**全部**协议文件(多个 `--prompt`)+ 协议要求的**每个** `guarded` 必需技能各一条(一条命令只写一个技能标记)+ 模板**全清单**(`--templates`)。少任一面的命令照抄不过:出口的覆盖判据按节点汇总点名缺哪份协议文件 / 哪个必需技能,模板声明核对再点名漏写的模板。缺声明时报文给出的恢复命令就是这三面齐全的形态——照抄即可,不要自己拆成「只补缺的那一项」。
206
+
207
+ > **提示词 = 步骤权威、模板 = 段形权威,两者缺一即未完成加载**:`--prompt` 指向的 `flow-kit/prompts/<阶段>.md` 规定这一步**怎么做**(流程步骤、检查项、交接物),`--templates` 指向的 `flow-kit/templates/<DOC>.md` 规定产出**长什么样**(标题、段序、段形)。节点入口先打印 `READ PROMPT:`;**有模板的节点**再打印 `READ TEMPLATE:`(verify / archive 为零模板节点,只打印一行);**两条 READ 行都要读**。design 的**前端** change 还会多打印一行 `READ PROMPT(条件提示词): …2a-ui-design.md…`(按 `frontendCriterion` 判定;非前端不打印)。`--prompt` 必须是该节点的协议文件(以入口打印的 `READ PROMPT:` 行为准);**入口只拦错路径**——逐份核对已写下的声明,落在节点协议面外即 BLOCKED 并点名;**缺失由出口拦**——逐份核对节点协议集,缺哪份逐项点名。两处判据分工不同:既不会静默写成一条与节点无关的声明,也不存在「有一份就过」。
194
208
 
195
- > **`--templates` 是内置节点的必填声明**(每个声明标记各写**全清单**,与节点映射一致):open → `CHANGE.md,REQUIREMENT.md` · design → `DESIGN.md`(前端 change 可再加 `UI-DESIGN.md`)· plan → `TASK.md` · execute / subagent-execute → `SUMMARY.md` · review → `REVIEW.md,TEST.md` · verify / archive → **零模板节点,省略该参数**(省略即空集;多写反而不一致)。声明集合由引擎校验:漏写 / 多写 / 错名在新 change 下即 BLOCK,旧 change 仅 WARN。
209
+ > **`--templates` 是内置节点的必填声明**(每个声明标记各写**全清单**,与节点映射一致):open → `CHANGE.md,REQUIREMENT.md` · design → `DESIGN.md`(前端 change 可再加 `UI-DESIGN.md`)· plan → `TASK.md` · execute / subagent-execute → `SUMMARY.md` · review → `REVIEW.md,TEST.md` · verify / archive → **零模板节点,省略该参数**(省略即空集;多写反而不一致)。声明集合由引擎校验:漏写 / 多写 / 错名即 **BLOCK**。
196
210
 
197
211
  > **跑声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。协议的引用示例:execute / subagent-execute 节点加载 flow-comet-dev 时用 `--prompt flow-kit/prompts/4-dev.md`(DEV 阶段协议),交付物按 `flow-kit/templates/SUMMARY.md` 模板填写并补写 `## 自检方法` 段。
198
212
 
199
- 节点退出(exit)与证据记录(record)会核对声明标记。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:新 change 的 required 条目不再自动补写——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);声明标记自动补写仅对旧 change 兜底(按协议 requiredSkillCalls 代记,标记带 `auto: true`),手动声明仍推荐(如实记录加载动作与协议文件)。
213
+ 节点退出(exit)与证据记录(record)会核对声明标记。**exit 的判据是「全部覆盖」而不是「任一命中」**:该节点该读的**每一份**协议文件、以及协议里**每一个** `guarded` 必需技能,都要有声明标记——`handoff-guarded` 是子代理侧义务,由 Return Contract 负责,不在节点标记判据内;缺任一即逐项点名并给出补齐命令,**BLOCKED**(恢复命令形态与旧标记兼容口径见 `reference/entry-detail.md` 的「exit 核对声明标记」小节)。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:required 条目的声明标记**只能由执行者手动 `skill-load` 写入,引擎不代记**——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);缺标记时唯一路径是执行者手动 `skill-load`,报文给出的命令照抄即通。
200
214
 
201
215
  ## Guardrails And Evidence
202
216
 
@@ -230,7 +244,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <ski
230
244
  ### Node Boundary Rules
231
245
 
232
246
  - **节点顺序**:每个节点按 `entry <node>` → 产出工件 → `record <node>` → `exit <node> --apply` 执行(record 必须先于 exit——exit 校验 evidence 前置,缺证据会 BLOCKED)。
233
- - Before leaving a Node, run `node .claude/skills/flow-comet/scripts/workflow-guard.mjs entry <node>` then `exit <node> --apply` to advance state. **新 change 未 entry 直接 exit → BLOCKED**(旧 change WARN 渐进)——entry 的进入检查(协调者禁令/委托前检查/签名记录)不可跳过。
247
+ - Before leaving a Node, run `node .claude/skills/flow-comet/scripts/workflow-guard.mjs entry <node>` then `exit <node> --apply` to advance state. **未 entry 直接 exit → BLOCKED**——entry 的进入检查(协调者禁令/委托前检查/签名记录)不可跳过。
234
248
  - If the guard fails, do not proceed past it — 先自动诊断并执行唯一安全修复(与 Decision Core 停止条件一致);存在多个会改变范围/风险的合法恢复动作时,展示 guard 输出并询问用户。
235
249
  - If the user wants to redo a completed Node, reset its completion state and re-enter rather than creating a parallel path.
236
250
 
@@ -287,7 +301,7 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
287
301
  | `workflow-handoff.mjs` | 子代理交接:request/result/status |
288
302
  | `comet-plan.mjs` | 兼容别名入口(内容为 workflow-state 的别名壳) |
289
303
  | `comet-check.mjs` | workflow contract 检查 |
290
- | `comet-hook-guard.mjs` | 文件写入边界守卫(**身份判据先于路径判据**:载荷 `agent_id` / 桥接透传的 `delegationDepth` 在场 ⇒ 子代理语义放行;最小保护集 `.flow-comet/flow-comet-state.json` 与 `reference/workflow-protocol.json` 在身份在场时**仍拦**;无身份走 phase 白名单——subagent-execute 阶段只允许 .specs/,`.claude/worktrees/**` 前缀保留为兼容路径;`Write`/`Edit` 与 `Bash` 写命令两条判定路径同语义,runRoot 外一致拦截) |
304
+ | `comet-hook-guard.mjs` | 文件写入边界守卫(**身份判据先于路径判据**:载荷 `agent_id` / 桥接透传的 `delegationDepth` 在场 ⇒ 子代理语义放行;最小保护集 `.flow-comet/flow-comet-state.json` 与 `reference/workflow-protocol.json` 在身份在场时**仍拦**,空闲态仍拦 state 文件;无身份走 phase 白名单——subagent-execute 阶段只允许 .specs/,`.claude/worktrees/**` 前缀保留为兼容路径;`Write`/`Edit` 与 `Bash` 写命令两条判定路径同语义,runRoot 外一致拦截) |
291
305
 
292
306
  ### 机器拥有字段
293
307
 
@@ -12,7 +12,7 @@
12
12
  五要素(缺一不可):
13
13
 
14
14
  1. **`git add -- <自己字面路径>`**:逐条字面路径(取自本任务 `write_files`),禁用 `.` / `-A` / `-u` 等宽泛形态。
15
- 2. **`git commit -- <同一路径>`**:提交以 pathspec 限定范围,保证提交只含自己的文件;路径集与上一步**逐字一致**。
15
+ 2. **`git commit -m "<消息>" -- <同一路径>`**:消息(含正文尾注 `-m "Task: <id>"`)写在 `--` **之前**,pathspec 写在 `--` 之后——提交以 pathspec 限定范围,保证提交只含自己的文件;路径集与上一步**逐字一致**。消息若落到 `--` 之后(`git commit -- <路径> -m "<消息>"`),`-m` 会被当成 pathspec、提交直接失败(退出码 1)。
16
16
  3. **锁失败重试**:并发提交会撞 `index.lock` / `cannot lock ref`——**失败即重试**(临时仓真并发实测:20 提交 / 25 次锁失败全部重试成功);不得因锁失败改用宽泛命令。
17
17
  4. **禁裸 `add` / `commit -a` / `stash` / `clean` / `reset`**:无 pathspec 的 `git add`、`git commit -a`、`git stash`、`git clean`、`git reset` 一律禁止——它们作用于整个共享工作区。
18
18
  5. **为什么**:并发写者共享**同一个索引与工作树**——宽泛命令存在**并发索引竞态**:一方 `add -A` 会把另一方的半成品纳入自己的提交(串味 / 多文件提交);`stash` / `clean` / `reset` 更会直接破坏同伴的未提交工作。
@@ -29,4 +29,4 @@
29
29
  3. **审计留痕**:每次集成输出一行审计行 `INTEGRATE: <task-id> <commitHash> → <集成提交>`;降级路径为 `INTEGRATE: <task-id> <commitHash> via cherry-pick -- 降级原因:<原因>`。映射(task-id → commitHash → 集成提交)记入该趟流程记录(`<task-id>-SUMMARY.md` / handoff evidence 文本字段)。**判级**:审计行是**执行纪律**(review 把关),本节点不声称存在机械门禁校验它。
30
30
  4. **冲突处置(两类分别动作)**:
31
31
  - **机械冲突**(不改用户可见行为:同一文件不同区域 / 相邻行 / 纯格式):执行者**可自行解决**——解决后必须跑**合并后验证**(该任务 `verify` + 受影响任务的判据),并在审计行记录冲突与解决方式。
32
- - **语义冲突**(两侧对同一行为 / 契约 / 接口给出不同语义:同一函数语义分叉、同一 AC 的两种实现、公共 API 形状不一致):**必须中止集成并上抛**(记 BLOCKED + 恢复指引),**不得**由执行者自行拍板;由协调者 / 用户裁决(补 `depends_on`、拆任务或开新 change)。
32
+ - **语义冲突**(两侧对同一行为 / 契约 / 接口给出不同语义:同一函数语义分叉、同一 AC 的两种实现、公共 API 形状不一致):**必须中止集成并上抛**(记 BLOCKED + 恢复指引),**不得**由执行者自行拍板;由协调者 / 用户裁决(补 `depends_on`、拆任务或另开 change)。
@@ -6,7 +6,7 @@
6
6
 
7
7
  | 分类 | 定义 | 处理 |
8
8
  |------|------|------|
9
- | 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | 用交互确认问(Claude Code 用 AskUserQuestion 优先;Codex 用文本提问+内联确认)或文本回退;相邻选择合并为一个问题,不重问已持久化选择 |
9
+ | 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | dsh 用 ask_user_question、Claude Code 用 AskUserQuestion、Codex 用 ask_user_question——当前版本没有该工具时退回文本提问 + 内联确认;非交互会话:不提问、把该决策点显式报告为未决并停下(不替用户选择);相邻选择合并为一个问题,不重问已持久化选择 |
10
10
  | 自动处理 | 唯一安全下一步 | 直接执行并汇报,不许制造确认 |
11
11
  | 停止条件 | guard 失败 / 缺依赖 / 状态损坏 | 报告阻塞与恢复条件;存在多个会改变范围或风险的合法恢复动作时才升级为用户决策 |
12
12
  | 手动交接 | `NEXT: manual`(若有) | 不是用户决策,直接继续 |
@@ -26,7 +26,7 @@
26
26
  | review | REVIEW Critical 项 | 审查发现 Critical 严重性项 | 暂停等人工确认处置 |
27
27
  | verify | UAT 失败超限 | 第 4 次失败(机器计数 verifyFailures) | 暂停问用户「继续修 / 停止」(R2.6,≤3 次自动重试) |
28
28
  | archive | 归档操作 | 移动文件到 .specs/archive/(不可逆) | 用户确认后才执行 |
29
- | archive | 合并 change 分支到 main | 归档收尾 | merge 前暂停等用户确认 |
29
+ | archive | 合并 change 分支到默认分支(默认分支先探测,不假设 main) | 归档收尾执行本地合并前 | 本地合并前仍等用户确认;走 PR 的项目由下一行的 PR approve 承接,本表不另设确认点 |
30
30
  | archive | PR approve | enablePrReview 开启时(archive 前置) | 等用户/GitHub approve |
31
31
 
32
32
  ### 自动处理(唯一安全下一步,直接执行并汇报)
@@ -59,6 +59,6 @@
59
59
  | 节点 | 决策点 | 判定 |
60
60
  |------|--------|------|
61
61
  | execute | 空退出豁免 | 全 parallel 无串行可做时,须显式声明 `emptyExitApproved`(否则 BLOCKED);exit 输出 EMPTY-EXIT 审计 |
62
- | execute | 越权委托豁免 | [P] 任务在 execute 完成属越权委托(新 change BLOCKED),须经 subagent-execute 委托或显式说明 |
63
- | 各节点 | entry 强制 | 新 change 未 entry 直接 exit → BLOCKED(旧 change WARN 渐进) |
64
- | 各节点 | 新旧判定 | init 写入 `newChange: true` = 新 change(严格模式);旧 change(无标记)渐进 WARN |
62
+ | execute | 越权委托豁免 | [P] 任务在 execute 完成属越权委托(一律 BLOCKED),须经 subagent-execute 委托或显式说明 |
63
+ | 各节点 | entry 强制 | 未 entry 直接 exit → BLOCKED(进入检查不可跳过;同一形态一个判级) |
64
+ | 各节点 | 旧 state 字段 | `newChange` 已退役(不再写入、不再参与判级)——旧 state 带该字段时被忽略(不报 schema 错误),缺字段补默认;同一形态一个判级 |
@@ -16,7 +16,7 @@ git ls-files --others --exclude-standard
16
16
  ## 归属三分类
17
17
 
18
18
  1. **属于当前 change** → 吸收进当前任务,不重做
19
- 2. **不属于当前 change** → 暂停问用户(并入 / 拆新 change / 不动 / 授权丢弃)
19
+ 2. **不属于当前 change** → 暂停问用户(并入 / 拆为另一个 change / 不动 / 授权丢弃)
20
20
  3. **来源不清** → 暂停报告,不推进阶段
21
21
 
22
22
  ## 构建产物排除
@@ -51,13 +51,13 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
51
51
 
52
52
  | 分类 | 定义 | 处理 |
53
53
  |------|------|------|
54
- | 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | 用交互确认问(Claude Code 用 AskUserQuestion 优先;Codex 用文本提问+内联确认)或文本回退;相邻选择合并为一个问题,不重问已持久化选择 |
54
+ | 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | dsh 用 ask_user_question、Claude Code 用 AskUserQuestion、Codex 用 ask_user_question——当前版本没有该工具时退回文本提问 + 内联确认;非交互会话:不提问、把该决策点显式报告为未决并停下(不替用户选择);相邻选择合并为一个问题,不重问已持久化选择 |
55
55
  | 自动处理 | 唯一安全下一步 | 直接执行并汇报,不许制造确认 |
56
56
  | 停止条件 | guard 失败 / 缺依赖 / 状态损坏 | 报告阻塞与恢复条件,无合法动作时才升级为用户决策 |
57
57
  | 手动交接 | `NEXT: manual`(若有) | 不是用户决策,直接继续 |
58
58
 
59
59
  **决策点清单(挂到四分类下,详细作者化见 `reference/decision-points.md`)**:
60
- - **用户决策**:首次调用且主题/范围有多个合法解释;技术栈选型(5~6 卡,design 节点内暂停);破坏性变更检测(R4.6,execute 节点内暂停展示引用图);Schema 迁移(R4.5,execute 节点内暂停);REVIEW Critical 项(review 节点暂停等人工确认);UAT 失败超限(第 4 次,机器计数 verifyFailures,verify 节点暂停);归档操作(不可逆,archive 节点暂停等最终确认);切换 executionMode 到 direct(execute 节点内暂停,需用户确认,记录 directOverride);合并 change 分支到 main(归档收尾,merge 前暂停等用户确认);PR approve(enablePrReview 开启时,archive 前置,等用户/GitHub approve)
60
+ - **用户决策**:首次调用且主题/范围有多个合法解释;技术栈选型(5~6 卡,design 节点内暂停);破坏性变更检测(R4.6,execute 节点内暂停展示引用图);Schema 迁移(R4.5,execute 节点内暂停);REVIEW Critical 项(review 节点暂停等人工确认);UAT 失败超限(第 4 次,机器计数 verifyFailures,verify 节点暂停);归档操作(不可逆,archive 节点暂停等最终确认);切换 executionMode 到 direct(execute 节点内暂停,需用户确认,记录 directOverride);归档收尾按项目既有流程(PR 或本地合并;本地合并前仍等用户确认);交接本身不做分支操作;PR approve(enablePrReview 开启时,archive 前置,等用户/GitHub approve)
61
61
  - **自动处理**:唯一安全下一步直接执行;flow-kit 反问协议要求确认(CHANGE/REQUIREMENT/DESIGN)按 flow-kit 规则暂停等待
62
62
  - **停止条件**:Node guard 失败时先自动诊断并执行唯一安全修复;缺依赖或状态损坏导致无法继续时报告停止条件与恢复条件;只有恢复方式存在多个会改变范围或风险的合法选项时,才升级为用户决策
63
63
 
@@ -72,8 +72,8 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
72
72
  | "LESSONS.md 不用扫" | R1.8:每个 DEV 任务必须扫描 |
73
73
  | "测试从实现派生就行" | R5.1:测试必须从 AC 派生 |
74
74
  | "guard 失败了,让用户决定" | 先自动诊断并执行唯一安全修复;无合法动作时才报告停止条件 |
75
- | "跳过 entry 直接 exit,反正没检查" | 新 change 未 entry 直接 exit → BLOCKED(进入检查不可跳过);旧 change WARN 渐进 |
76
- | "SUMMARY 不写,任务先标 done" | 新 change done 任务缺 SUMMARY → BLOCKED(产物完整性强制);旧 change WARN 渐进 |
75
+ | "跳过 entry 直接 exit,反正没检查" | 未 entry 直接 exit → BLOCKED(进入检查不可跳过;同一形态一个判级) |
76
+ | "SUMMARY 不写,任务先标 done" | done 任务缺 SUMMARY → BLOCKED(产物完整性强制;同一形态一个判级) |
77
77
  | "subagent-execute 阶段,我直接改源码更快" | 协调者禁令:subagent-execute 阶段主会话禁止写源码(hook 白名单只允许 .specs/,Write/Edit 与 Bash 写命令均物理拦截),必须委托子代理——委托走**身份通道**(三平台同一判据),worktree 只是「① 写权限」的实现之一,不是委托前提 |
78
78
 
79
79
  ## Workflow Nodes
@@ -96,7 +96,7 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
96
96
  | 节点 | Implementation | Required Calls | Enforcement |
97
97
  |------|---------------|----------------|-------------|
98
98
  | open | flow-comet-open | flow-comet-change, flow-comet-requirement | guarded |
99
- | design | flow-comet-design | flow-comet-design, flow-comet-ui-design (guarded,仅前端适用——前端须先 skill-load 建标记 + record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端不加载不声明;旧 change 渐进 WARN) | guarded |
99
+ | design | flow-comet-design | flow-comet-design, flow-comet-ui-design (guarded,仅前端适用——前端须先 skill-load 建标记 + record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端不加载不声明;同一形态一个判级) | guarded |
100
100
  | plan | flow-comet-plan | flow-comet-task | guarded |
101
101
  | execute | flow-comet-execute | flow-comet-dev | guarded |
102
102
  | subagent-execute | flow-comet-subagent-execute | flow-comet-dev (handoff) | handoff-guarded |
@@ -107,19 +107,38 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
107
107
  **节点技能两层加载模型(入口层 · 双步硬规则)**:路由到节点后,以下两步**都不可跳过**:
108
108
 
109
109
  1. **用 Skill 工具加载该节点的 Implementation 技能**(见下方 Skill Bindings 表 Implementation 列,如 execute → flow-comet-execute)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让该 skill 的指令生效的是 Skill 工具把它注入本次会话。
110
- 2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation 同名的条目已随路由加载,无需重复加载),加载完成后**立即**逐条运行声明命令(open/review 等涉及多个协议文件的节点,每个协议文件对应一条声明命令):
110
+ 2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation 同名的条目已随路由加载,无需重复加载),加载完成后**立即**声明「加载了哪个技能、按哪份协议工作」。**一个节点该读的协议常常不止一份**(open 是 `0-change.md` + `1-requirement.md`,review 是 `6-review.md` + `5-test.md`)——**一份命令可以给多个 `--prompt`**,`skill-load` 会把它们**全部**记进同一个标记的 `protocols` 里,不是只留第一个:
111
111
 
112
112
  ```bash
113
- node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <skill> --prompt flow-kit/prompts/<阶段>.md --templates <模板基名,...>
113
+ # 单份协议(plan)
114
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load plan flow-comet-task --prompt flow-kit/prompts/3-task.md --templates TASK.md
115
+
116
+ # 多份协议(open):一条命令两个 --prompt,两份都记进标记
117
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-change --prompt flow-kit/prompts/0-change.md --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
118
+
119
+ # 同一节点的第二个 guarded 必需技能(open = change + requirement):每个必需技能各一条,
120
+ # 每条都带该节点全部 --prompt 与模板全清单——一条命令只写一个技能标记
121
+ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-requirement --prompt flow-kit/prompts/0-change.md --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
114
122
  ```
115
123
 
124
+ > **分条等价**:按协议文件分几条命令声明,与合并成一条等价——出口判据按节点汇总,只问「该读的这几份是否都被声明过」,不要求与技能一一对应。
125
+
116
126
  > **`--templates` 是内置节点的必填声明**(每个标记各写全清单):open → `CHANGE.md,REQUIREMENT.md` · design → `DESIGN.md`(前端可加 `UI-DESIGN.md`)· plan → `TASK.md` · execute / subagent-execute → `SUMMARY.md` · review → `REVIEW.md,TEST.md` · verify / archive 为零模板节点,**省略该参数**。逐节点示例命令见各节点册的「加载声明」小节。
117
127
 
118
- > **加载链的两条指针**:节点入口**先**打印 `READ PROMPT:`(指向 `flow-kit/prompts/<阶段>.md`——这一步怎么做),**再**打印 `READ TEMPLATE:`(指向 `flow-kit/templates/<DOC>.md`——产出长什么样),**有模板的节点两行都要读**;零模板节点(verify / archive)只有 `READ PROMPT:`。design 的**前端** change 还会多打印一行 `READ PROMPT(条件提示词): …2a-ui-design.md…`(按 `frontendCriterion` 判定;非前端不打印)。`--prompt` 必须是该节点的协议文件(以入口打印的 `READ PROMPT:` 行为准);落在节点协议面外的路径会在下一次入口被拦下(BLOCKED)并给出重声明命令——重跑声明即可,不要手改标记。
128
+ > **加载链的两条指针**:节点入口**先**打印 `READ PROMPT:`(指向 `flow-kit/prompts/<阶段>.md`——这一步怎么做),**再**打印 `READ TEMPLATE:`(指向 `flow-kit/templates/<DOC>.md`——产出长什么样),**有模板的节点两行都要读**;零模板节点(verify / archive)只有 `READ PROMPT:`。design 的**前端** change 还会多打印一行 `READ PROMPT(条件提示词): …2a-ui-design.md…`(按 `frontendCriterion` 判定;非前端不打印)。`--prompt` 必须是该节点的协议文件(以入口打印的 `READ PROMPT:` 行为准);落在节点协议面外的路径会在下一次入口被拦下(BLOCKED,逐条点名)并给出重声明命令——**入口只判「写下的每条声明对不对」,不判「该写的都写了没有」**:该节点该读却还没声明的那几份由出口的声明门逐份点名(见下方「exit 核对声明标记」)。重跑声明即可,不要手改标记。
119
129
 
120
130
  > **跑声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。协议的引用示例:execute / subagent-execute 节点加载 flow-comet-dev 时用 `--prompt flow-kit/prompts/4-dev.md`(DEV 阶段协议),交付物按 `flow-kit/templates/SUMMARY.md` 模板填写并补写 `## 自检方法` 段。
121
131
 
122
- 节点退出(exit)与证据记录(record)会核对声明标记。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:新 change 的 required 条目不再自动补写——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);声明标记自动补写仅对旧 change 兜底(按协议 requiredSkillCalls 代记,标记带 `auto: true`),手动声明仍推荐(如实记录加载动作与协议文件)。`flow-comet-ui-design` 与协议同等级(`guarded`)且**仅前端适用**:前端 change 须先加载并 `skill-load` 声明、record 载荷带 `required-skill:design.flow-comet-ui-design`(出口不再自动补写);非前端不加载不声明(出口输出可见的 `UI-DESIGN: skipped(非前端)`);旧 change 渐进,缺件仅 WARN。前端判据是**结构级**的:`CHANGE.md` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**——**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」不算标注,仍判前端。
132
+ 节点退出(exit)与证据记录(record)会核对声明标记。
133
+
134
+ **exit 核对声明标记(覆盖判据)——判据是「全部覆盖」,不是「任一命中」**。两条同时成立才算声明齐备,缺任一条即判缺声明:
135
+
136
+ - **协议文件面**:该节点该读的**每一份**协议文件都要被声明过(open 两份、review 两份,其余节点一份)。多份可以在同一个标记的 `protocols` 里(一条命令给多个 `--prompt`),也可以分散在各技能自己的标记上——判据按节点汇总,只看这些文件是否都被声明过。
137
+ - **技能面**:协议 `requiredSkillCalls` 里**每个** `guarded` 必需技能,都要有一个属于它的标记(适用性门控的绑定除外——`flow-comet-ui-design` 只在**前端** change 上要求,见下方该段判据)。**`handoff-guarded` 不在判据内**——那是子代理侧义务,由 Return Contract 的 `required-skill:` 核对负责(让协调者声明一个它没加载的技能,只会造出另一类假声明)。
138
+
139
+ **缺声明时的恢复命令形态**(BLOCKED / WARN 报文给的就是这个形态):报文按**协议派生**给出该节点**每个** `guarded` 必需技能各一条命令(`node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <skill> …`)——每条把该节点该读的**全部**协议文件都带上(多个 `--prompt`)并带 `--templates <该节点模板全清单>`,三个面一次给全,照抄即通。旧口径的 `skill-load <node> <skill> --prompt <缺的那份协议文件>` 只补缺项、漏模板清单,照抄完同一 exit 会再被覆盖门与模板门各拦一次(已废弃;报文仍逐项点名缺哪份协议文件、哪个必需技能,命令本身则给全)。同一 `<node>-<skill>` 重跑会**覆写**该标记,补齐后重试 `exit <node>`。**判级**:同一形态一律 BLOCKED(强制全部覆盖;不再有按 change 新旧分级的渐进档)。**兼容**:判据改为全部覆盖之前写下的标记只有一个 `protocol` 单值(历史形态甚至是完整路径),照样按 basename 计入覆盖;不可解析的标记**不计入**,并在报文里列名——不静默当通过。
140
+
141
+ 声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:required 条目的声明标记**只能由执行者手动 `skill-load` 写入,引擎不代记**——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);缺标记不会被补记,手动声明是唯一路径(如实记录加载动作与协议文件)。`flow-comet-ui-design` 与协议同等级(`guarded`)且**仅前端适用**:前端 change 须先加载并 `skill-load` 声明、record 载荷带 `required-skill:design.flow-comet-ui-design`(出口不代记该条目);非前端不加载不声明(出口输出可见的 `UI-DESIGN: skipped(非前端)`)——缺件一律拦截(同一形态一个判级)。前端判据是**结构级**的:`CHANGE.md` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**——**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」不算标注,仍判前端。
123
142
 
124
143
  > **侧命令**:`evolve`(架构沉淀同步)/ `health`(健康巡检)/ `context-scan`(上下文重扫)三条横向命令**不进 8 节点流程**——不路由、不 entry/exit、不写节点证据,一律由用户显式调用;触发词、命令面与落盘产物见主 `SKILL.md` 的「侧命令」小节(单一来源,本文不复述其命令表)。
125
144
 
@@ -153,7 +172,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <ski
153
172
  ### Node Boundary Rules
154
173
 
155
174
  - **节点顺序**:每个节点按 `entry <node>` → 产出工件 → `record <node>` → `exit <node> --apply` 执行(record 必须先于 exit——exit 校验 evidence 前置,缺证据会 BLOCKED)。
156
- - Before leaving a Node, run `node .claude/skills/flow-comet/scripts/workflow-guard.mjs entry <node>` then `exit <node> --apply` to advance state. **新 change 未 entry 直接 exit → BLOCKED**(旧 change WARN 渐进)——entry 的进入检查(协调者禁令/委托前检查/签名记录)不可跳过。
175
+ - Before leaving a Node, run `node .claude/skills/flow-comet/scripts/workflow-guard.mjs entry <node>` then `exit <node> --apply` to advance state. **未 entry 直接 exit → BLOCKED**(同一形态一个判级)——entry 的进入检查(协调者禁令/委托前检查/签名记录)不可跳过。
157
176
  - If the guard fails, do not proceed past it — 先自动诊断并执行唯一安全修复(与 Decision Core 停止条件一致);存在多个会改变范围/风险的合法恢复动作时,展示 guard 输出并询问用户。
158
177
  - If the user wants to redo a completed Node, reset its completion state and re-enter rather than creating a parallel path.
159
178
 
@@ -189,7 +208,7 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
189
208
  | `workflow-handoff.mjs` | 子代理交接:request/result/status |
190
209
  | `comet-plan.mjs` | 兼容别名入口(内容为 workflow-state 的别名壳) |
191
210
  | `comet-check.mjs` | workflow contract 检查 |
192
- | `comet-hook-guard.mjs` | 文件写入边界守卫(**身份判据先于路径判据**:载荷 `agent_id` / 桥接透传的 `delegationDepth` 在场 ⇒ 子代理语义放行;最小保护集 `.flow-comet/flow-comet-state.json` 与 `reference/workflow-protocol.json` 在身份在场时**仍拦**;无身份走 phase 白名单——subagent-execute 阶段只允许 .specs/,`.claude/worktrees/**` 前缀保留为兼容路径;`Write`/`Edit` 与 `Bash` 写命令两条判定路径同语义,runRoot 外一致拦截) |
211
+ | `comet-hook-guard.mjs` | 文件写入边界守卫(**身份判据先于路径判据**:载荷 `agent_id` / 桥接透传的 `delegationDepth` 在场 ⇒ 子代理语义放行;最小保护集 `.flow-comet/flow-comet-state.json` 与 `reference/workflow-protocol.json` 在身份在场时**仍拦**,空闲态仍拦 state 文件;无身份走 phase 白名单——subagent-execute 阶段只允许 .specs/,`.claude/worktrees/**` 前缀保留为兼容路径;`Write`/`Edit` 与 `Bash` 写命令两条判定路径同语义,runRoot 外一致拦截) |
193
212
 
194
213
  ### 机器拥有字段
195
214
 
@@ -18,7 +18,7 @@ review / verify 发现缺陷后的修复必须回到 `execute` 节点生命周
18
18
  - **`next` 回程审计行语义**:回程豁免行始终输出中性 `RETURN: 回程源节点 <源节点>`(源节点产物在场且未出口;保留源节点跑出口),不再输出 FIX-BATCH;受控归位行的 `FIX-BATCH: 归位 <execute 家族>` 保留(真实 Fix 回退行),两者不得混同。
19
19
  6. **禁止绕过**:驻留源节点不归位、顺手改完后直接跑源节点 exit 收场会被 BLOCKED(存在未归位/未跑出口的修复回路),必须按上述路径恢复;不得用跳过归位或出口门禁的手段(含手动改写 `.flow-comet/flow-comet-state.json`)替代本路径。
20
20
 
21
- **由受控重入打开的场景(archive 源)**:缺陷在归档后才暴露、且归档移动尚未发生时,可先由用户显式授权把工作归属退回 `execute` / `subagent-execute` / `review` / `verify` 之一,再按本节路径回到 execute 生命周期完成修复。重入命令:`node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]`——每次调用都需要用户显式授权,每 change 上限 3 轮(达上限后凭显式续轮授权 `--continue-round <n>`(n ≥ 已用轮次 + 1)可继续并计入下一轮);重入前自动落 state 备份快照(`.specs/<change-id>/.reentry-backups/`);成功打印 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 行(续轮审计行为 `第 n 轮(显式授权续轮,上限 3)`),与 Fix 回炉的 `FIX-BATCH` 行、正常多趟收尾的 `RETURN` 行三态可区分。归档移动已发生或 change 已 `completed` 时重入 BLOCKED,须走人工处置或新 change,不得静默跳过。重入只改工作归属,不写任何闭合标记,也不跳过目标节点入口 / 出口与源节点出口门禁;重复调用同一目标为空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state)。
21
+ **由受控重入打开的场景(archive 源)**:缺陷在归档后才暴露、且归档移动尚未发生时,可先由用户显式授权把工作归属退回 `execute` / `subagent-execute` / `review` / `verify` 之一,再按本节路径回到 execute 生命周期完成修复。重入命令:`node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]`——每次调用都需要用户显式授权,每 change 上限 3 轮(达上限后凭显式续轮授权 `--continue-round <n>`(n ≥ 已用轮次 + 1)可继续并计入下一轮);重入前自动落 state 备份快照(`.specs/<change-id>/.reentry-backups/`);成功打印 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 行(续轮审计行为 `第 n 轮(显式授权续轮,上限 3)`),与 Fix 回炉的 `FIX-BATCH` 行、正常多趟收尾的 `RETURN` 行三态可区分。归档移动已发生或 change 已 `completed` 时重入 BLOCKED,须走人工处置或另开 change,不得静默跳过。重入只改工作归属,不写任何闭合标记,也不跳过目标节点入口 / 出口与源节点出口门禁;重复调用同一目标为空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state)。
22
22
 
23
23
  ## 受控重入与归档侧边界
24
24
 
@@ -35,7 +35,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --aut
35
35
  - **上限与显式续轮**:每 change 最多 3 轮;第 4 次 BLOCKED 并给出「继续 / 停止」人工裁决指引。人工裁决「继续」须追加 `--continue-round <n>`(正整数,且 n ≥ 已用轮次 + 1)作显式续轮授权:满足则放行并计入下一轮、审计行打印 `第 n 轮(显式授权续轮,上限 3)`;未到上限即传该参数、或轮次不足一律 BLOCKED 且零改写。轮次与审计事件记入 `state.history`(事件类型 `reentry-applied`,含 `reason`;续轮时附 `continuationAuthorized: true`),成功输出 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 两行。
36
36
  - **备份**:转移前自动落 state 快照 `.specs/<change-id>/.reentry-backups/<UTC ISO>-pre-<target>.json`(时间戳中的 `:` 替换为 `-`),并记录 sha256 指纹,供审查核验与手工回滚。
37
37
  - **顺序**:命令成功后再写修复内容——archive 阶段写入白名单只放行 `.specs/<change-id>/KNOWN-ISSUES.md` 等少数路径;重入后写入权限跟随目标节点,此时才追加 Fix 任务 / 修改工件。
38
- - **边界**:归档移动已发生或 change 已 `completed` → BLOCKED,走人工处置或新 change / hotfix;重复调用同一目标 → 空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state),不会静默跳过。
38
+ - **边界**:归档移动已发生或 change 已 `completed` → BLOCKED,走人工处置或另开 change / hotfix;重复调用同一目标 → 空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state),不会静默跳过。
39
39
 
40
40
  ### 归档后发现缺陷(受控重入)
41
41
 
@@ -48,10 +48,10 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --aut
48
48
  ```
49
49
 
50
50
  目标限 `execute` / `subagent-execute` / `review` / `verify` 之一;每次调用都需要用户显式授权,每 change 上限 3 轮(达上限后凭显式续轮授权 `--continue-round <n>`(n ≥ 已用轮次 + 1)可继续并计入下一轮);命令先自动落 state 备份快照(`.specs/<change-id>/.reentry-backups/`),再转移工作归属,并打印 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 行(续轮审计行为 `第 n 轮(显式授权续轮,上限 3)`)。缺授权、目标越界、超上限或归档移动已发生一律 BLOCKED(state 字节零改写),不会静默跳过。
51
- - **已移动 / 已合并** → 人工处置或新 change:归档移动已发生(`.specs/archive/<日期>-<change-id>/`)或 change 已 `completed` / 已合并时,受控重入不适用(不承诺把文件搬回原位);走人工处置,或把修复放进新 change / hotfix,并在遗留清单里登记指针。
51
+ - **已移动 / 已合并** → 人工处置或另开 change:归档移动已发生(`.specs/archive/<日期>-<change-id>/`)或 change 已 `completed` / 已合并时,受控重入不适用(不承诺把文件搬回原位);走人工处置,或把修复放进另一个 change / hotfix,并在遗留清单里登记指针。
52
52
 
53
53
  **写权限顺序(先转移后写 TASK)**:archive 阶段 hook 对 change 目录只放行 `KNOWN-ISSUES.md` 这一个精确文件(另有 `.specs/archive/`、`.specs/CHANGELOG.md`、`.specs/LESSONS.md`、`STATE.md`),TASK.md 的修复任务写入不在放行面内。顺序固定为:先跑 `reenter` 完成转移(写入权限随即跟随目标节点),再在目标节点权限内追加 Fix 任务 / 修改工件——不要试图在 archive 阶段先写 TASK.md。若重入成功后追加任务失败,用 `next` / `status` 核对归属;重复调用同一目标为空操作(不备份、不计数、不改写 state)。
54
54
 
55
55
  ### 受控重入打开的修复场景(archive 源)
56
56
 
57
- 缺陷在归档后才暴露、且归档移动尚未发生时,可先由用户显式授权把工作归属退回本节点或 `execute` / `review` / `verify`,再按常规委托与出口流程完成修复。重入命令:`node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]`——每次调用都需要用户显式授权,每 change 上限 3 轮(达上限后凭显式续轮授权 `--continue-round <n>`(n ≥ 已用轮次 + 1)可继续并计入下一轮);重入前自动落 state 备份快照(`.specs/<change-id>/.reentry-backups/`);成功打印 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 行(续轮审计行为 `第 n 轮(显式授权续轮,上限 3)`),与 Fix 回炉的 `FIX-BATCH` 行、正常多趟收尾的 `RETURN` 行三态可区分。归档移动已发生或 change 已 `completed` 时重入 BLOCKED,须走人工处置或新 change,不得静默跳过。重入只改工作归属,不写任何闭合标记,也不跳过本节点入口 / 出口门禁;重入后并行任务的委托证据、write_files 边界与 Return Contract 校验与常规流程完全一致;重复调用同一目标为空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state)。
57
+ 缺陷在归档后才暴露、且归档移动尚未发生时,可先由用户显式授权把工作归属退回本节点或 `execute` / `review` / `verify`,再按常规委托与出口流程完成修复。重入命令:`node .claude/skills/flow-comet/scripts/workflow-state.mjs reenter <target> --authorized-by <source> --reason <text> [--continue-round <n>]`——每次调用都需要用户显式授权,每 change 上限 3 轮(达上限后凭显式续轮授权 `--continue-round <n>`(n ≥ 已用轮次 + 1)可继续并计入下一轮);重入前自动落 state 备份快照(`.specs/<change-id>/.reentry-backups/`);成功打印 `REENTRY: archive → <target>(授权源 <source>;第 n/3 轮;备份 <file>)` 与 `REASON: <text>` 行(续轮审计行为 `第 n 轮(显式授权续轮,上限 3)`),与 Fix 回炉的 `FIX-BATCH` 行、正常多趟收尾的 `RETURN` 行三态可区分。归档移动已发生或 change 已 `completed` 时重入 BLOCKED,须走人工处置或另开 change,不得静默跳过。重入只改工作归属,不写任何闭合标记,也不跳过本节点入口 / 出口门禁;重入后并行任务的委托证据、write_files 边界与 Return Contract 校验与常规流程完全一致;重复调用同一目标为空操作(输出 `REENTRY: 空操作——…`,不备份、不计数、不改写 state)。
@@ -1,6 +1,6 @@
1
1
  # 自动初始化检测(init 前置步骤)
2
2
 
3
- > 每次 `init` 新 change 前,flow-comet 自动检测项目上下文状态,按需提示初始化;无需记忆任何独立命令。
3
+ > 每次 `init` 新建 change 前,flow-comet 自动检测项目上下文状态,按需提示初始化;无需记忆任何独立命令。
4
4
 
5
5
  ## 触发与流程
6
6
 
@@ -37,9 +37,9 @@
37
37
 
38
38
  | 属性 | Claude Code | Codex | dsh |
39
39
  |------|-------------|-------|-----|
40
- | ① 写权限 | 载荷 `agent_id` / `agent_type`——**证实**(真机实测:子代理载荷含二者、主会话载荷不含;与 Codex 同一判据) | 载荷 `agent_id` + `agent_type`——**证实**(实测:子代理载荷 12 键含二者、主线程 10 键不含);守卫读 `agent_id`,与 CC 同一判据 | 桥接透传 `delegationDepth` **+ 通道标记**(`FLOW_COMET_AGENT_DEPTH_SOURCE`,守卫要求两者同时在场才接受 env 面身份——继承来的深度变量不作数)——**证实**(0.1.7-rc.2 全接缝重认证;本批收窄为「最小保护集除外」) |
40
+ | ① 写权限 | 载荷 `agent_id` / `agent_type`——**证实**(真机实测:子代理载荷含二者、主会话载荷不含;与 Codex 同一判据) | 载荷 `agent_id` + `agent_type`——**证实**(实测:子代理载荷 12 键含二者、主线程 10 键不含);守卫读 `agent_id`,与 CC 同一判据 | 桥接透传 `delegationDepth` **+ 通道标记**(`FLOW_COMET_AGENT_DEPTH_SOURCE`,守卫要求两者同时在场才接受 env 面身份——继承来的深度变量不作数)——**证实**(0.1.7-rc.2 全接缝重认证;本批收窄为「最小保护集除外」;**0.2.2-rc.1 官方工具核心链路真实会话通过;dsh-ops 0.5.0 已知写入工具名由桥接归一化(桥接系统测试覆盖;未做 dsh-ops 真实会话);运行中的流程里,`ops_bash` 的 script_path 形态与多目标工具(replace/batch)只对协调者拒绝;子代理是执行者、放行,但这两类形态**不经过内容检查**(脚本正文/批量目标不可见),最小保护集对它们不生效——宿主权限允许时,执行者脚本仍可能改动状态或协议文件;`ops_copy`/`ops_move`/`ops_remove` 按目标字段映射为 Write(`ops_move` 源端另判);Bash 类工具的绝对 workdir 在项目外时对协调者拒绝;PTC 默认放行,进程内直写为已记录边界;项目内可变工作目录、相对 workdir、命令内 cd、junction/symlink、解释器与 shell 删除形态为已知边界**) |
41
41
  | ② 提交隔离 | pathspec 纪律(多写者共享同一工作区形态) | 同左 | 同左 |
42
- | ③ 验证隔离 | `subagent-execute` 出口锚:有 request 无 result(新 change BLOCKED / 旧 change WARN 渐进) | 同左 | 同左 |
42
+ | ③ 验证隔离 | `subagent-execute` 出口锚:有 request 无 result(一律 BLOCKED,同一形态一个判级) | 同左 | 同左 |
43
43
  | ④ 集成纪律 | `merge --no-ff` 优先;降级 cherry-pick 必记因 | 同左 | 同左 |
44
44
  | **谁建树**(三平台唯一差异) | 可选:harness `isolation: "worktree"` 建独立树,或共享工作区直写 | 协调者**显式** `git worktree add` 并在委派 prompt 指定 `workdir`(原生子代理无自动建树;**证实**:子代理可被指向独立目录并落盘),或共享工作区直写;**建树选择的适用面**:协调者显式 `git worktree add <路径>`(手工建树)**是受支持的建树选择**——在委派 prompt 里指定 `workdir`,写入由身份通道放行(原生子代理无自动建树);**以建树绕过边界**不受支持——用独立树规避协调者禁令 / 最小保护集 / `write_files` 互斥与提交时点纪律 / handoff 与 Return Contract 证据,或把 worktree 当作四属性的替代品。 | **不建树**:进程内子代理、同一工作区运行——**无需隔离区 ≠ 无需边界**(`write_files` 互斥 + 提交时点 + 最小保护集仍构成边界) |
45
45