flow-comet 1.7.0 → 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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +16 -14
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/decision-points.md +5 -5
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +9 -9
- package/.flow-comet/skills/flow-comet/reference/fix-loop.md +4 -4
- package/.flow-comet/skills/flow-comet/reference/init-detection.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/platform-facts.md +2 -2
- package/.flow-comet/skills/flow-comet/reference/post-archive-handoff.md +264 -0
- package/.flow-comet/skills/flow-comet/reference/recovery.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/replan.md +1 -1
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +1 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +270 -30
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +25 -8
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +41 -38
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +11 -9
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +112 -53
- package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +357 -3
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +24 -1
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +9 -10
- package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +8 -8
- package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +4 -15
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +79 -107
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +183 -232
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +91 -14
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +20 -32
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +10 -19
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +27 -17
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +240 -87
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +15 -22
- package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +11 -4
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +192 -24
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +55 -44
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +2 -4
- package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +0 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +191 -17
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +3 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +23 -5
- package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +10 -11
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +40 -3
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +12 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +193 -111
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +314 -57
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +311 -216
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +33 -62
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +188 -91
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +94 -37
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +36 -27
- package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +285 -9
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +2 -6
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +5 -15
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +6 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +40 -36
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +346 -25
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +0 -2
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +41 -54
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +33 -11
- package/.flow-comet/skills/flow-comet-change/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-design/SKILL.md +5 -3
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +11 -11
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +10 -4
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
- package/.flow-comet/skills/flow-comet-review/SKILL.md +8 -8
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +1 -1
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +14 -14
- package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +1 -1
- package/README.md +2 -2
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +238 -21
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
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 个会改变范围/行为/风险/不可逆结果的合法选项 |
|
|
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(归档 /
|
|
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,反正没检查" |
|
|
85
|
-
| "SUMMARY 不写,任务先标 done" |
|
|
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
|
-
| "用户要健康检查 /
|
|
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`
|
|
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,7 +136,7 @@ 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
|
|
139
|
+
| ① 写权限 | 子代理写入目标的**放行依据**(含 gitignored 面):身份在场 ⇒ 子代理语义放行;**最小保护集**(`.flow-comet/flow-comet-state.json`、`reference/workflow-protocol.json`)在身份在场时**仍拦**,空闲态仍拦 state 文件 |
|
|
138
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 并记因;机械冲突与语义冲突分别处置) |
|
|
@@ -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,9 +179,9 @@ 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
|
-
|
|
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(非前端)`
|
|
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
|
|
|
@@ -204,11 +206,11 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-c
|
|
|
204
206
|
|
|
205
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 并点名;**缺失由出口拦**——逐份核对节点协议集,缺哪份逐项点名。两处判据分工不同:既不会静默写成一条与节点无关的声明,也不存在「有一份就过」。
|
|
206
208
|
|
|
207
|
-
> **`--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 → **零模板节点,省略该参数**(省略即空集;多写反而不一致)。声明集合由引擎校验:漏写 / 多写 /
|
|
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**。
|
|
208
210
|
|
|
209
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` 模板填写并补写 `## 自检方法` 段。
|
|
210
212
|
|
|
211
|
-
节点退出(exit)与证据记录(record)会核对声明标记。**exit 的判据是「全部覆盖」而不是「任一命中」**:该节点该读的**每一份**协议文件、以及协议里**每一个** `guarded` 必需技能,都要有声明标记——`handoff-guarded` 是子代理侧义务,由 Return Contract
|
|
213
|
+
节点退出(exit)与证据记录(record)会核对声明标记。**exit 的判据是「全部覆盖」而不是「任一命中」**:该节点该读的**每一份**协议文件、以及协议里**每一个** `guarded` 必需技能,都要有声明标记——`handoff-guarded` 是子代理侧义务,由 Return Contract 负责,不在节点标记判据内;缺任一即逐项点名并给出补齐命令,**BLOCKED**(恢复命令形态与旧标记兼容口径见 `reference/entry-detail.md` 的「exit 核对声明标记」小节)。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:required 条目的声明标记**只能由执行者手动 `skill-load` 写入,引擎不代记**——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);缺标记时唯一路径是执行者手动 `skill-load`,报文给出的命令照抄即通。
|
|
212
214
|
|
|
213
215
|
## Guardrails And Evidence
|
|
214
216
|
|
|
@@ -242,7 +244,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-c
|
|
|
242
244
|
### Node Boundary Rules
|
|
243
245
|
|
|
244
246
|
- **节点顺序**:每个节点按 `entry <node>` → 产出工件 → `record <node>` → `exit <node> --apply` 执行(record 必须先于 exit——exit 校验 evidence 前置,缺证据会 BLOCKED)。
|
|
245
|
-
- Before leaving a Node, run `node .claude/skills/flow-comet/scripts/workflow-guard.mjs entry <node>` then `exit <node> --apply` to advance state.
|
|
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 的进入检查(协调者禁令/委托前检查/签名记录)不可跳过。
|
|
246
248
|
- If the guard fails, do not proceed past it — 先自动诊断并执行唯一安全修复(与 Decision Core 停止条件一致);存在多个会改变范围/风险的合法恢复动作时,展示 guard 输出并询问用户。
|
|
247
249
|
- If the user wants to redo a completed Node, reset its completion state and re-enter rather than creating a parallel path.
|
|
248
250
|
|
|
@@ -299,7 +301,7 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
|
|
|
299
301
|
| `workflow-handoff.mjs` | 子代理交接:request/result/status |
|
|
300
302
|
| `comet-plan.mjs` | 兼容别名入口(内容为 workflow-state 的别名壳) |
|
|
301
303
|
| `comet-check.mjs` | workflow contract 检查 |
|
|
302
|
-
| `comet-hook-guard.mjs` | 文件写入边界守卫(**身份判据先于路径判据**:载荷 `agent_id` / 桥接透传的 `delegationDepth` 在场 ⇒ 子代理语义放行;最小保护集 `.flow-comet/flow-comet-state.json` 与 `reference/workflow-protocol.json`
|
|
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 外一致拦截) |
|
|
303
305
|
|
|
304
306
|
### 机器拥有字段
|
|
305
307
|
|
|
@@ -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
|
|
32
|
+
- **语义冲突**(两侧对同一行为 / 契约 / 接口给出不同语义:同一函数语义分叉、同一 AC 的两种实现、公共 API 形状不一致):**必须中止集成并上抛**(记 BLOCKED + 恢复指引),**不得**由执行者自行拍板;由协调者 / 用户裁决(补 `depends_on`、拆任务或另开 change)。
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
| 分类 | 定义 | 处理 |
|
|
8
8
|
|------|------|------|
|
|
9
|
-
| 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 |
|
|
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
|
|
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 完成属越权委托(
|
|
63
|
-
| 各节点 | entry 强制 |
|
|
64
|
-
| 各节点 |
|
|
62
|
+
| execute | 越权委托豁免 | [P] 任务在 execute 完成属越权委托(一律 BLOCKED),须经 subagent-execute 委托或显式说明 |
|
|
63
|
+
| 各节点 | entry 强制 | 未 entry 直接 exit → BLOCKED(进入检查不可跳过;同一形态一个判级) |
|
|
64
|
+
| 各节点 | 旧 state 字段 | `newChange` 已退役(不再写入、不再参与判级)——旧 state 带该字段时被忽略(不报 schema 错误),缺字段补默认;同一形态一个判级 |
|
|
@@ -51,13 +51,13 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
|
|
|
51
51
|
|
|
52
52
|
| 分类 | 定义 | 处理 |
|
|
53
53
|
|------|------|------|
|
|
54
|
-
| 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 |
|
|
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
|
|
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,反正没检查" |
|
|
76
|
-
| "SUMMARY 不写,任务先标 done" |
|
|
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
|
|
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 |
|
|
@@ -136,9 +136,9 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-c
|
|
|
136
136
|
- **协议文件面**:该节点该读的**每一份**协议文件都要被声明过(open 两份、review 两份,其余节点一份)。多份可以在同一个标记的 `protocols` 里(一条命令给多个 `--prompt`),也可以分散在各技能自己的标记上——判据按节点汇总,只看这些文件是否都被声明过。
|
|
137
137
|
- **技能面**:协议 `requiredSkillCalls` 里**每个** `guarded` 必需技能,都要有一个属于它的标记(适用性门控的绑定除外——`flow-comet-ui-design` 只在**前端** change 上要求,见下方该段判据)。**`handoff-guarded` 不在判据内**——那是子代理侧义务,由 Return Contract 的 `required-skill:` 核对负责(让协调者声明一个它没加载的技能,只会造出另一类假声明)。
|
|
138
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
|
|
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
140
|
|
|
141
|
-
声明如实记录执行者动作——加载了哪个 skill
|
|
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` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**——**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」不算标注,仍判前端。
|
|
142
142
|
|
|
143
143
|
> **侧命令**:`evolve`(架构沉淀同步)/ `health`(健康巡检)/ `context-scan`(上下文重扫)三条横向命令**不进 8 节点流程**——不路由、不 entry/exit、不写节点证据,一律由用户显式调用;触发词、命令面与落盘产物见主 `SKILL.md` 的「侧命令」小节(单一来源,本文不复述其命令表)。
|
|
144
144
|
|
|
@@ -172,7 +172,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-c
|
|
|
172
172
|
### Node Boundary Rules
|
|
173
173
|
|
|
174
174
|
- **节点顺序**:每个节点按 `entry <node>` → 产出工件 → `record <node>` → `exit <node> --apply` 执行(record 必须先于 exit——exit 校验 evidence 前置,缺证据会 BLOCKED)。
|
|
175
|
-
- Before leaving a Node, run `node .claude/skills/flow-comet/scripts/workflow-guard.mjs entry <node>` then `exit <node> --apply` to advance state.
|
|
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 的进入检查(协调者禁令/委托前检查/签名记录)不可跳过。
|
|
176
176
|
- If the guard fails, do not proceed past it — 先自动诊断并执行唯一安全修复(与 Decision Core 停止条件一致);存在多个会改变范围/风险的合法恢复动作时,展示 guard 输出并询问用户。
|
|
177
177
|
- If the user wants to redo a completed Node, reset its completion state and re-enter rather than creating a parallel path.
|
|
178
178
|
|
|
@@ -208,7 +208,7 @@ All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT
|
|
|
208
208
|
| `workflow-handoff.mjs` | 子代理交接:request/result/status |
|
|
209
209
|
| `comet-plan.mjs` | 兼容别名入口(内容为 workflow-state 的别名壳) |
|
|
210
210
|
| `comet-check.mjs` | workflow contract 检查 |
|
|
211
|
-
| `comet-hook-guard.mjs` | 文件写入边界守卫(**身份判据先于路径判据**:载荷 `agent_id` / 桥接透传的 `delegationDepth` 在场 ⇒ 子代理语义放行;最小保护集 `.flow-comet/flow-comet-state.json` 与 `reference/workflow-protocol.json`
|
|
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 外一致拦截) |
|
|
212
212
|
|
|
213
213
|
### 机器拥有字段
|
|
214
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
|
|
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
|
|
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
|
-
- **已移动 / 已合并** →
|
|
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
|
|
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)。
|
|
@@ -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
|
|
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
|
|