flow-comet 1.6.3 → 1.6.5
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 +21 -3
- package/.flow-comet/skills/flow-comet/reference/artifact-template-overlay.md +154 -0
- package/.flow-comet/skills/flow-comet/reference/artifact-templates.json +387 -0
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +8 -2
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +11 -13
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +180 -6
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +69 -18878
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +29 -5
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1053 -0
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
- package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
- package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
- package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +817 -0
- package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
- package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
- package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +618 -0
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +154 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +406 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +756 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +1235 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +384 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +714 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +204 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +179 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +714 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +123 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +249 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1505 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1248 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2493 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +214 -2
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +72 -1123
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +976 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1398 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1367 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1492 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2125 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +59 -7559
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +223 -2476
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +27 -2190
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-change/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-design/SKILL.md +15 -8
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +1 -0
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +13 -10
- package/.flow-comet/skills/flow-comet-health/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +14 -4
- package/.flow-comet/skills/flow-comet-open/SKILL.md +11 -9
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +11 -7
- package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-review/SKILL.md +15 -9
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +11 -8
- package/.flow-comet/skills/flow-comet-task/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-test/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +12 -8
- package/README.md +52 -69
- package/package.json +3 -2
- package/scripts/dsh-bridge.mjs +2 -2
- package/scripts/lib/installer-cleanup.mjs +152 -0
- package/scripts/lib/installer-flowkit.mjs +159 -0
- package/scripts/lib/installer-hooks.mjs +363 -0
- package/scripts/lib/installer-loader.mjs +220 -0
- package/scripts/lib/installer-migrate.mjs +236 -0
- package/scripts/lib/installer-platforms.mjs +314 -0
- package/scripts/prepare-env.mjs +21 -1313
|
@@ -15,7 +15,9 @@ This node finalizes a completed change by extracting reusable lessons from the d
|
|
|
15
15
|
|
|
16
16
|
## Guidance
|
|
17
17
|
|
|
18
|
-
>
|
|
18
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
19
|
+
|
|
20
|
+
本节点零模板:只有 `READ PROMPT:`(`7-integration`),没有 `READ TEMPLATE:`。
|
|
19
21
|
|
|
20
22
|
### Prerequisites
|
|
21
23
|
|
|
@@ -151,6 +153,8 @@ Load `flow-comet-integration` during this Node and record completed check `requi
|
|
|
151
153
|
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load archive flow-comet-integration --prompt flow-kit/prompts/7-integration.md
|
|
152
154
|
```
|
|
153
155
|
|
|
156
|
+
> **零模板节点省略 `--templates`**:archive 的产出物模板映射为空(KNOWN-ISSUES.md 无上游模板),命令**不带** `--templates`——省略即视为空集,与节点映射一致并通过;多写模板名反而会与映射不一致而被拦。
|
|
157
|
+
|
|
154
158
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做。
|
|
155
159
|
|
|
156
160
|
## Augmentations
|
|
@@ -181,7 +185,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs record archive '{"summ
|
|
|
181
185
|
| Guardrail ID | Label | Validation Type |
|
|
182
186
|
|--------------|-------|-----------------|
|
|
183
187
|
| `archive-evidence` | Archive directory exists, source removed | state-transition |
|
|
184
|
-
| `changelog-updated` | CHANGELOG.md
|
|
188
|
+
| `changelog-updated` | CHANGELOG.md 有新条目,且表格条目按日期倒序 | 结构级(guard 强制:`CHANGELOG.md` 表格日期倒序——新 change 非倒序即 BLOCKED、旧 change WARN;未含本 change 标识只 WARN 提示补登记);条目内容与格式由 review 把关 |
|
|
185
189
|
| `lessons-preserved` | LESSONS.md still in .specs/ (not archived) | 执行纪律(review 把关),guard 不校验 |
|
|
186
190
|
| `user-confirmed` | User confirmed archive before execution | 执行纪律(review 把关),guard 不校验 |
|
|
187
191
|
|
|
@@ -7,7 +7,11 @@ description: "flow-kit CHANGE 阶段协议:反问澄清、change-id 自动生
|
|
|
7
7
|
|
|
8
8
|
本 Skill 为 flow-comet 的 open 节点提供 flow-kit 的 CHANGE 反问协议。
|
|
9
9
|
|
|
10
|
-
>
|
|
10
|
+
> **模板权威**:本技能产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
11
|
+
|
|
12
|
+
## 上游段表不采用(覆盖声明)
|
|
13
|
+
|
|
14
|
+
`flow-kit/prompts/0-change.md` 的自检清单把 CHANGE.md 写成 5 段(Why / What / 影响面 / 范围排除 / 验收线)——**这 5 段清单不采用**作段表:它漏了 `视觉调性` 与 `风险与未知`。段名与段序以 `flow-kit/templates/CHANGE.md` 的 7 个 H2 为准(`视觉调性` 是标题必须在场的条件段,`架构层影响声明` 是本仓登记的可选增量段)。
|
|
11
15
|
|
|
12
16
|
## 加载
|
|
13
17
|
|
|
@@ -32,7 +36,7 @@ description: "flow-kit CHANGE 阶段协议:反问澄清、change-id 自动生
|
|
|
32
36
|
|
|
33
37
|
- **判据与强制等级(唯一权威)**:判据全文与 `guarded` 绑定、`required-skill:design.flow-comet-ui-design` 声明要求、非前端 `UI-DESIGN: skipped(非前端)` 的出口口径都在 `flow-comet-ui-design` 册的「触发与跳过」段——本节不复述,只描述怎么填段。
|
|
34
38
|
- **前端项目**:按步骤 0.6 的预选结果填段(选定 / 理由 / 参考产品 / 明确排除),不要以结构形态标注「不适用」。
|
|
35
|
-
- **非前端项目**:保留该段并以**结构形态**标注「不适用」(可附一句理由,例如「CLI
|
|
39
|
+
- **非前端项目**:保留该段并以**结构形态**标注「不适用」(可附一句理由,例如「CLI 工具,无用户可见界面」)。**段缺席不再默认判非前端**——新 change 的「视觉调性」是标题必须在场的条件段,**缺席即拦**(open 出口的骨架校验与 design 出口的适用性门控都会拦);缺席只对旧 change 兼容(沿用旧口径判非前端,出口打印 `UI-DESIGN: skipped(旧 change 兼容)`)。
|
|
36
40
|
- **改判走本阶段**:change 进行中要改前端 / 非前端判定,回到这里改这一个段,不在 design / execute / verify 里就地绕开判据——改段即改变了 design 出口的判据输入。
|
|
37
41
|
|
|
38
42
|
## 状态推进
|
|
@@ -15,9 +15,19 @@ Responsibility: 技术栈选型 + ADR + 数据流。生成 DESIGN.md。
|
|
|
15
15
|
|
|
16
16
|
### 必填段清单(结构+存在级)
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
|
18
|
+
段形唯一权威 = `flow-kit/templates/DESIGN.md` + 登记表 `../flow-comet/reference/artifact-templates.json`(模板缺席时出口输出「未校验(模板缺失)」)。
|
|
19
|
+
|
|
20
|
+
| 文件 | 无条件段(缺席 = BLOCKED) | 条件段与增量段(在场才校验 / 结构子段随父段) |
|
|
21
|
+
|------|---------------------------|-------------------------------------------|
|
|
22
|
+
| DESIGN.md | `## 0. 技术栈选定` / `## 1. 决策清单` / `## 2. 数据流 / 架构图` / `## 5. 风险` / `## 6. 不在范围` | 条件段:`## 0.5 既有架构对齐`(标题必须在场;父段适用时其结构子段 0.5.1~0.5.3 必须同时在,整段写「不适用」才豁免)/ `## 3. 关键状态机` / `## 4. ADR 索引` / `## 9. 架构沉淀建议`(适用时子段 9.1~9.5 必须在场) |
|
|
23
|
+
|
|
24
|
+
前端 change 另生成 `UI-DESIGN.md`(标题形态 `# UI Design: <项目名>` + frontmatter 键齐备);非前端须在 CHANGE.md 的 `## 视觉调性` 段以结构形态标注「不适用」。声明本次读到的模板:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load design flow-comet-design --prompt flow-kit/prompts/2-design.md --templates DESIGN.md
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
加载顺序:先 `READ PROMPT:`(步骤权威),有模板的节点再 `READ TEMPLATE:`(段形权威);design 前端另有一行条件提示词 `2a-ui-design`。
|
|
21
31
|
|
|
22
32
|
guard 校验见 workflow-guard.mjs NODE_TRANSITION_GATES / templateSectionPatterns;「填得好不好」由 review 把关。
|
|
23
33
|
|
|
@@ -17,15 +17,22 @@ Responsibility: 技术栈选型 + ADR + 数据流。生成 DESIGN.md(轻量流
|
|
|
17
17
|
|
|
18
18
|
### 必填段清单(结构+存在级)
|
|
19
19
|
|
|
20
|
-
|
|
|
21
|
-
|
|
22
|
-
| DESIGN.md | `## 0
|
|
20
|
+
| 文件(模板 = `flow-kit/templates/<DOC>.md`) | 左栏 · 无条件段(模板 H2,缺席 / 空正文 = BLOCKED) | 右栏 · 条件段(**标题必须在场**,正文可写 `N/A`)/ 增量段(按登记位置) |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| `DESIGN.md` | `## 0. 技术栈选定` / `## 1. 决策清单` / `## 2. 数据流 / 架构图` / `## 5. 风险` / `## 6. 不在范围`;首部 `Change ID` 必填 | **条件段**:`## 0.5 既有架构对齐` / `## 3. 关键状态机(如有)` / `## 4. ADR 索引` / `## 9. 架构沉淀建议`——标题必须在场,不适用写 `N/A`;`## 0.5` 的结构子段 `### 0.5.1` ~ `### 0.5.3`、`## 9` 的 `### 9.1` ~ `### 9.5` 在父段适用时必在场;**增量段**:无 |
|
|
23
|
+
| `UI-DESIGN.md`(仅前端 change) | frontmatter 八个顶层键(name / description / colors / typography / spacing / rounded / motion / shadow)与 `## 1.` ~ `## 10.` 十个 H2 段 | **可选段**:`## 0. 视觉语汇对齐`(仅 brownfield 填,greenfield 可整段删除——模板允许删除的唯一段,删则其 `### 0.1` ~ `### 0.3` 一并豁免);**增量段**:无 |
|
|
24
|
+
|
|
25
|
+
模板缺席(`flow-kit/templates/` 不在场)时骨架无从派生:该工件**不校验**并输出「未校验(模板缺失)」,不拿内置骨架顶替。
|
|
26
|
+
|
|
27
|
+
**上游段表不采用(覆盖声明)**:`flow-kit/prompts/2-design.md` 的职责小节把 §3 写成 ADR、§4 写成风险,而模板的顺序是 `## 3. 关键状态机` / `## 4. ADR 索引` / `## 5. 风险`——**这两处编号互换不采用**:段名、段序与结构子段一律以 `flow-kit/templates/DESIGN.md` 为准。
|
|
23
28
|
|
|
24
29
|
> **决策清单段名须与模板精确一致**:guard 按 flow-kit 模板段名派生校验——模板段为 `## 1. 决策清单`(编号可选),**不要写成"技术决策清单"等变体**(2-design.md 指引的"技术决策"是内容要求,不是段名;实测:写变体段名会被拦截)。
|
|
25
30
|
|
|
26
|
-
guard 校验见 workflow-guard.mjs
|
|
31
|
+
guard 校验见 workflow-guard.mjs 的出口门禁与模板骨架派生(条件段 / 结构子段 / 增量段的位置与必填性来自 `../flow-comet/reference/artifact-templates.json` 登记);「填得好不好」由 review 把关。
|
|
32
|
+
|
|
33
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
27
34
|
|
|
28
|
-
|
|
35
|
+
加载顺序:先读 `READ PROMPT:`(`2-design`;前端另加 `2a-ui-design`),再读 `READ TEMPLATE:`(`DESIGN`;前端另加 `UI-DESIGN`,可选)。
|
|
29
36
|
|
|
30
37
|
# Design
|
|
31
38
|
|
|
@@ -114,10 +121,10 @@ The design node reads CHANGE.md and REQUIREMENT.md, then produces DESIGN.md thro
|
|
|
114
121
|
1. 本节点的同名条目已随路由加载——同名 required 条目(`flow-comet-design`)无需重复加载,仅需运行下方声明命令(只读取 SKILL.md 文件不叫加载,**不得跳过**真正的 Skill 工具注入步骤)。`flow-comet-ui-design` 为 **guarded 但仅前端适用**的条目——前端项目用 Skill 工具加载其已装副本后**必须**运行对应 `skill-load` 声明建标记,并在 record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端项目不加载不声明(出口打印可见的 `UI-DESIGN: skipped(非前端)` 后放行);旧 change 保持渐进,缺件仅 WARN。
|
|
115
122
|
|
|
116
123
|
> **前端判据(结构级 · 唯一权威 → `flow-comet-ui-design` 册的「触发与跳过」段)**:判据全文与 `guarded` 绑定的判级口径都在该册——本节不复述,判定与出口行为一律以该册为准。
|
|
117
|
-
2.
|
|
124
|
+
2. 加载完成后**立即**运行声明命令(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明)。`--templates` 声明本节点该读的产出物模板:`design` 的必填模板是 `DESIGN.md`;**前端 change 另加 `UI-DESIGN.md` 时写成 `--templates DESIGN.md,UI-DESIGN.md`**(`UI-DESIGN` 属可选声明,非前端不加):
|
|
118
125
|
|
|
119
126
|
```bash
|
|
120
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load design flow-comet-design --prompt flow-kit/prompts/2-design.md
|
|
127
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load design flow-comet-design --prompt flow-kit/prompts/2-design.md --templates DESIGN.md
|
|
121
128
|
```
|
|
122
129
|
|
|
123
130
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。
|
|
@@ -146,7 +153,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs record design '{"summa
|
|
|
146
153
|
|--------------|-------|-----------------|
|
|
147
154
|
| `design-artifacts` | DESIGN.md (or DESIGN-lite.md) exists with section 0 | artifact-exists |
|
|
148
155
|
| `architecture-aligned` | Section 0.5 populated for brownfield | 执行纪律(review 把关),guard 不校验 |
|
|
149
|
-
| `ui-design-artifacts` | UI-DESIGN.md exists for frontend projects |
|
|
156
|
+
| `ui-design-artifacts` | UI-DESIGN.md exists for frontend projects | 结构级(guard 强制:前端 change 缺 `.specs/<change-id>/UI-DESIGN.md` → 新 change BLOCKED、旧 change WARN;判定依据 = `CHANGE.md` 的「视觉调性」段,判据见 `flow-comet-ui-design` 册) |
|
|
150
157
|
|
|
151
158
|
## Exit Check
|
|
152
159
|
|
|
@@ -7,7 +7,7 @@ description: "flow-kit DEV 阶段协议:TDD + 6 维自查 + diff 边界 verify
|
|
|
7
7
|
|
|
8
8
|
本 Skill 为 flow-comet 的 execute/subagent-execute 节点提供 flow-kit 的完整开发规则集。
|
|
9
9
|
|
|
10
|
-
>
|
|
10
|
+
> **模板权威**:本技能产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
11
11
|
|
|
12
12
|
## 加载
|
|
13
13
|
|
|
@@ -32,6 +32,7 @@ node .claude/skills/flow-comet/scripts/evolve.mjs scan --root .
|
|
|
32
32
|
- **只读**每个 `.specs/archive/<日期>-<change-id>/DESIGN.md` 的架构沉淀段(第 9 节)——**不读该文档的其它段**,防 change 级冻结决策被错误升级为项目级
|
|
33
33
|
- 输出候选清单:`<归档目录名>#<序号>` + 条目 + 目标文档;并列出本次已扫的 change(含无沉淀段、无 `DESIGN.md` 的目录),扫描范围对用户完全可见
|
|
34
34
|
- 候选落点按沉淀子段归类:可复用抽象 / 禁动清单 → `CONTEXT.md`「既有抽象索引」;项目级技术决策 → `CONTEXT.md`「已锁决策」;依赖 → `CONTEXT.md`「技术栈」;跨模块契约 → `ARCHITECTURE.md`「跨模块契约」(该文档不在场时需先建立,否则应用会被拒绝且零改动)
|
|
35
|
+
- **「结构问题」段(只读上报,与沉淀候选互不依赖)**:同一条命令末尾输出 `EVOLVE: 结构问题(.specs/ARCHITECTURE.md):…`——`.specs/ARCHITECTURE.md` 在场时按上游模板的 8 个 H2 与「ADR 列表」段的 `### ADR-<数字>` 条目字段形态比对;文件缺席输出「跳过」、骨架不可派生输出「未校验」、可比对时输出 0 项或逐条问题。该段**不进退出码、不写 state**,也不改变候选清单
|
|
35
36
|
|
|
36
37
|
### 2. 逐项 review(用户参与,不可跳过)
|
|
37
38
|
|
|
@@ -17,15 +17,17 @@ In subagent mode (default) this node is a coordinator: it does not write impleme
|
|
|
17
17
|
|
|
18
18
|
### 必填段清单(结构+存在级)
|
|
19
19
|
|
|
20
|
-
|
|
|
21
|
-
|
|
22
|
-
| SUMMARY.md | `## verify
|
|
20
|
+
| 文件(模板 = `flow-kit/templates/<DOC>.md`) | 左栏 · 无条件段(模板 H2,缺席 / 空正文 = BLOCKED) | 右栏 · 条件段(**标题必须在场**,正文可写 `N/A`)/ 增量段(按登记位置) |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| `SUMMARY.md` | `## 做了什么(一段话)` / `## 改动文件` / `## verify 输出(必填)` / `## 6 维自查`(须含实质内容)/ `## 越界检查(必填)` / `## 是否触发新工作` / `## 完成判定`;首部四字段 `Change ID` / `Task ID` / `完成时间` / `AI 角色` 必填 | **条件段**:`## 数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)` / `## 破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)` / `## 决策与偏离(如有)`——标题必须在场,不适用写 `N/A`;**增量段**:`## 自检方法`(整段必填,紧随 `## 越界检查` 或文末)、`## LESSONS 扫描`(整段必填,紧随 `## 自检方法`) |
|
|
23
23
|
|
|
24
|
-
> **注意**:flow-kit 的 SUMMARY 模板**不含 `## 自检方法`
|
|
24
|
+
> **注意**:flow-kit 的 SUMMARY 模板**不含 `## 自检方法` 与 `## LESSONS 扫描` 两段**——它们是 flow-comet 登记的增量段(前者校验自检方法声明,后者校验开工前扫描可核对)。使用 `flow-kit/templates/SUMMARY.md` 填写后,**必须按上方右栏补写这两段**:`## 自检方法` 声明 brooks-review / cache-brooks / builtin-quickcheck 三值之一及降级证据,`## LESSONS 扫描` 声明命中条目与逐条回应;否则新 change 的 exit 会被 BLOCKED。
|
|
25
25
|
|
|
26
|
-
guard 校验见 workflow-guard.mjs
|
|
26
|
+
guard 校验见 workflow-guard.mjs 的 execute 出口门禁(必填段 + 6 维自查实质内容 + 自检方法声明三值 + LESSONS 扫描段与命中核对)与模板骨架派生(段标题 / 段序 / 首部字段 / 增量段位置);「填得好不好」由 review 把关。
|
|
27
27
|
|
|
28
|
-
>
|
|
28
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
29
|
+
|
|
30
|
+
加载顺序:先读 `READ PROMPT:`(`4-dev`),再读 `READ TEMPLATE:`(`SUMMARY`)。
|
|
29
31
|
|
|
30
32
|
### 执行模型(按 executionMode,用户显式选择)
|
|
31
33
|
|
|
@@ -114,8 +116,9 @@ execute 节点**只处理 `parallel="false"`(或未标注 parallel)的 pendi
|
|
|
114
116
|
2. **委托子代理**:按平台通道委托 fresh-context 子代理(三平台同一身份判据,差异只在谁建树;`isolation: "worktree"` 是属性①的可选实现,非强制——见「并行安全四属性契约」)。handoff prompt 强制协议:子代理用 **Skill 工具**加载 flow-comet-dev 并按 `flow-kit/prompts/4-dev.md` 协议执行(TDD RED/GREEN/REFACTOR、LESSONS 扫描、既有抽象 grep、verify、6 维自查、越界检查、原子 commit `<type>(<scope>): <subject>`(scope 推荐可选:子系统短词;禁 change-id/日期作 scope;任务号放提交正文尾注 Task: <task-id>,change-id 不入标题)),按 `flow-kit/templates/SUMMARY.md` 模板写 `.specs/<change-id>/<task-id>-SUMMARY.md`(标题/首部/段序保真,另补 flow-comet 增量 `## 自检方法` 段),回传 Return Contract(含 commitHash + greenEvidence + completedChecks + selfReview)。**SUMMARY 自引用 hash 注**:提交内容无法包含自身 hash——若子代理 amend 提交,SUMMARY 内记录的 commitHash 为 amend 前值属预期(文件集一致即可,以实际提交对象为准)。
|
|
115
117
|
**提交从属规则**:任务专属的 `<task-id>-SUMMARY.md`(位于 `.specs/<change-id>/`,是 flow-comet 强制产物)允许随任务提交属流程默认豁免——目标仓库的既有规定优先,若目标仓库忽略清单等既有规定拒绝其入库,被拒即为正确行为,严禁 force-add 强加越库提交;委托校验对任务摘要的豁免属于校验宽容度,不是入库指令。
|
|
116
118
|
**提交面 pathspec 纪律(五要素,见 Guidance 同名小节)**:handoff prompt 必须要求子代理用 `git add -- <自己字面路径>` + `git commit -- <同一路径>` 提交、锁失败重试、禁裸 `add` / `commit -a` / `stash` / `clean` / `reset`(适用条件:**多个写者共享同一工作区**;各自独立工作区内的局部 `reset` / `clean` 不在禁令内)。**集成纪律(四要素,见 Guidance 同名小节)**:协调者集成时优先 `git merge --no-ff`、降级 `cherry-pick` 记因、顺序按 `depends_on` 拓扑序 + 同层 task id 升序、冲突按机械 / 语义两类分别处置。
|
|
119
|
+
**写前读模板(handoff prompt 固定句式)**:prompt 必须写明「开工前先读 <本任务产出物的模板路径>,按其标题 / 首部 / 段序填写,并按本仓登记补写增量段」——模板路径逐任务给出(本节点默认 `flow-kit/templates/SUMMARY.md`);只写「按模板填写」视为委托前检查未完成,不得发出委托。
|
|
117
120
|
3. **记录 handoff result**:子代理回传后,运行 `node .claude/skills/flow-comet/scripts/workflow-handoff.mjs result <task-id> '<JSON>'` 记录(Return Contract 含 commitHash + greenEvidence + completedChecks + selfReview)。
|
|
118
|
-
4. **验收 SUMMARY,TASK.md 标 done**:确认 SUMMARY 按 `flow-kit/templates/SUMMARY.md` 填写且**模板保真**(标题 `# SUMMARY:` / 首部 4 字段 / 段序一致)、含 `## 自检方法`
|
|
121
|
+
4. **验收 SUMMARY,TASK.md 标 done**:确认 SUMMARY 按 `flow-kit/templates/SUMMARY.md` 填写且**模板保真**(标题 `# SUMMARY:` / 首部 4 字段 / 段序一致)、含 `## 自检方法` 与 `## LESSONS 扫描` 两个增量段(前者声明 brooks-review / cache-brooks / builtin-quickcheck 三值之一)、verify 输出真实、6 维自查与越界检查有实质内容;通过后在 TASK.md 将任务标 `status="done"` 并加时间戳。
|
|
119
122
|
5. **下一个 pending 任务**:重复步骤 1-4。
|
|
120
123
|
|
|
121
124
|
> 原 Steps 的 TDD / LESSONS / verify / 6 维自查 / 越界检查 / commit 协议**移入 handoff prompt 作为子代理的强制协议**,协调者不亲自执行。
|
|
@@ -185,10 +188,10 @@ Load `flow-comet-dev` during this Node and record completed check `required-skil
|
|
|
185
188
|
**加载声明(阶段层 · 双步硬规则)**:本节点技能已由入口路由经 Skill 工具加载(你正在阅读的就是它);本节点 Required Skill Calls 的加载与声明同样不可跳过:
|
|
186
189
|
|
|
187
190
|
1. **用 Skill 工具加载** `flow-comet-dev`(本节点 Required Skill Call)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让 flow-comet-dev 指令生效的是 Skill 工具把它注入本次会话。委托子代理时,子代理同样必须用 Skill 工具加载 flow-comet-dev(按 `flow-kit/prompts/4-dev.md` 协议执行)。
|
|
188
|
-
2.
|
|
191
|
+
2. 加载完成后**立即**运行声明命令(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明)。`--templates` 声明本节点该读的产出物模板(execute → `SUMMARY.md`):
|
|
189
192
|
|
|
190
193
|
```bash
|
|
191
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load execute flow-comet-dev --prompt flow-kit/prompts/4-dev.md
|
|
194
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load execute flow-comet-dev --prompt flow-kit/prompts/4-dev.md --templates SUMMARY.md
|
|
192
195
|
```
|
|
193
196
|
|
|
194
197
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。
|
|
@@ -220,7 +223,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs record execute '{"summ
|
|
|
220
223
|
|--------------|-------|-----------------|
|
|
221
224
|
| `build-evidence` | At least one SUMMARY.md produced | artifact-exists |
|
|
222
225
|
| `all-tasks-done` | All tasks in TASK.md have status="done"(pending 串行任务 → BLOCKED);done 任务须有对应 SUMMARY(新 change 强制 BLOCKED,旧 change WARN 渐进) | content-check |
|
|
223
|
-
| `verify-output-real` | Every SUMMARY.md has verify output (not fabricated) |
|
|
226
|
+
| `verify-output-real` | Every SUMMARY.md has verify output (not fabricated) | 结构级(guard 强制:`## verify 输出` 段在场且正文非空,骨架校验同批拦截);输出是否真实由 review 把关(伪造不可机检) |
|
|
224
227
|
| `no-design-changes` | REQUIREMENT.md and DESIGN.md not modified | 执行纪律(review 把关),guard 不校验 |
|
|
225
228
|
| `self-check-method` | Every SUMMARY.md declares `## 自检方法`(brooks-review / cache-brooks / builtin-quickcheck) | W1-B 段级校验 |
|
|
226
229
|
|
|
@@ -25,7 +25,7 @@ description: "Use only when explicitly invoked as /flow-comet-health; periodic c
|
|
|
25
25
|
|
|
26
26
|
| 层 | 内容 | 产出者 |
|
|
27
27
|
|---|---|---|
|
|
28
|
-
| 确定性层 | 项目上下文一致性 · 经验条目编号连续性 · 技术债表项数 · 冗余工具在场判定 · 版本历史统计 | `health.mjs
|
|
28
|
+
| 确定性层 | 项目上下文一致性 · 经验条目编号连续性 · 技术债表项数 · 冗余工具在场判定 · 版本历史统计 · **架构文档结构**(`.specs/ARCHITECTURE.md` 在场时按上游模板的 8 个 H2 与「ADR 列表」段的 `### ADR-<数字>` 条目形态报告结构问题;文件缺席输出「跳过」、骨架不可派生输出「未校验」——只读报告,不阻断、不写状态) | `health.mjs`(逐项带计数、判据与复现命令) |
|
|
29
29
|
| 增补层 | 代码体检工具的 4 维结果(代码质量 / 架构 / 技术债 / 测试质量) | agent:工具在场时执行体检技能,结果**并入同一份报告**并标注来源 |
|
|
30
30
|
| 降级声明 | 可选工具不在场的原因 + 判据说明 | `health.mjs`(每份报告都有) |
|
|
31
31
|
|
|
@@ -7,7 +7,7 @@ description: "flow-kit INTEGRATION 阶段协议:集成验证 + UAT + 失败诊
|
|
|
7
7
|
|
|
8
8
|
本 Skill 为 flow-comet 的 verify 和 archive 节点提供 flow-kit 的集成验证和归档流程。
|
|
9
9
|
|
|
10
|
-
>
|
|
10
|
+
> **模板权威**:本技能产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
11
11
|
|
|
12
12
|
## 加载
|
|
13
13
|
|
|
@@ -15,10 +15,20 @@ Responsibility: CHANGE 反问 + REQUIREMENT 需求分析。生成 CHANGE.md 和
|
|
|
15
15
|
|
|
16
16
|
### 必填段清单(exit guard 校验,结构+存在级)
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
|
21
|
-
|
|
18
|
+
段形唯一权威 = `flow-kit/templates/<DOC>.md` + 登记表 `../flow-comet/reference/artifact-templates.json`(模板缺席时出口输出「未校验(模板缺失)」,不回退任何内置段名副本)。
|
|
19
|
+
|
|
20
|
+
| 文件 | 无条件段(缺席 = BLOCKED) | 条件段与增量段(在场才校验 / 位置按登记表) |
|
|
21
|
+
|------|---------------------------|-------------------------------------------|
|
|
22
|
+
| CHANGE.md | `## Why(为什么做)` / `## What(做什么)` / `## 影响面` / `## 范围排除(这次不做)` / `## 验收线(粗粒度,不是 AC)` / `## 风险与未知` | 条件段 `## 视觉调性`:标题必须在场(前端项目填调性;非前端显式写「不适用」——缺席即 BLOCKED);增量段 `## 架构层影响声明`(可选) |
|
|
23
|
+
| REQUIREMENT.md | `## 用户故事` / `## 验收准则(AC)` / `## 范围切分` / `## 非功能性需求` / `## 依赖与假设` | 无 |
|
|
24
|
+
|
|
25
|
+
段名宽容:省括号 / 换括号 / 大小写差异均按归一后的段名匹配,核心词不同即视为缺段。声明本次读到的模板(缺声明在 record 时被拦):
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-change --prompt flow-kit/prompts/0-change.md --templates CHANGE.md,REQUIREMENT.md
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
加载顺序:先 `READ PROMPT:`(步骤权威),有模板的节点再 `READ TEMPLATE:`(段形权威);design 前端另有一行条件提示词 `2a-ui-design`。
|
|
22
32
|
|
|
23
33
|
guard 校验见 workflow-guard.mjs NODE_TRANSITION_GATES / templateSectionPatterns;「填得好不好」由 review 把关。
|
|
24
34
|
|
|
@@ -17,14 +17,16 @@ Responsibility: CHANGE 反问 + REQUIREMENT 需求分析。生成 CHANGE.md 和
|
|
|
17
17
|
|
|
18
18
|
### 必填段清单(结构+存在级)
|
|
19
19
|
|
|
20
|
-
|
|
|
21
|
-
|
|
22
|
-
| CHANGE.md | `## Why(为什么做)`
|
|
23
|
-
| REQUIREMENT.md | `## 用户故事` / `## 验收准则(AC)`
|
|
20
|
+
| 文件(模板 = `flow-kit/templates/<DOC>.md`) | 左栏 · 无条件段(模板 H2,缺席 / 空正文 = BLOCKED) | 右栏 · 条件段(**标题必须在场**,正文可写 `N/A`)/ 增量段(按登记位置) |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| `CHANGE.md` | `## Why(为什么做)` / `## What(做什么)` / `## 影响面` / `## 范围排除(这次不做)` / `## 验收线(粗粒度,不是 AC)` / `## 风险与未知`;首部 `Change ID` 必填 | **条件段**:`## 视觉调性(前端项目必填,由 0-change 步骤 0.6 预选填入)`——标题必须在场,非前端以结构形态标注「不适用」;**增量段**:`## 架构层影响声明`(可选,位置 = 文末 / `## 风险与未知` 之后) |
|
|
23
|
+
| `REQUIREMENT.md` | `## 用户故事` / `## 验收准则(AC)` / `## 范围切分` / `## 非功能性需求` / `## 依赖与假设`;`## 范围切分` 的结构子段 `### v1(本次必做)` / `### v2(下一轮考虑,不本次)` / `### out(永远不做)` 在父段适用时必在场;首部 `Change ID` 必填 | 无模板条件段、无增量段——`## 范围切分` 整段写 `N/A` 时其结构子段随之豁免 |
|
|
24
24
|
|
|
25
|
-
guard 校验见 workflow-guard.mjs
|
|
25
|
+
模板缺席(`flow-kit/templates/` 不在场)时骨架无从派生:该工件**不校验**并输出「未校验(模板缺失)」,不拿内置骨架顶替。guard 校验见 workflow-guard.mjs 的出口门禁与模板骨架派生(条件段 / 结构子段 / 增量段的位置与必填性来自 `../flow-comet/reference/artifact-templates.json` 登记);「填得好不好」由 review 把关。
|
|
26
26
|
|
|
27
|
-
>
|
|
27
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
28
|
+
|
|
29
|
+
加载顺序:先读 `READ PROMPT:`(`0-change`、`1-requirement`),再读 `READ TEMPLATE:`(`CHANGE`、`REQUIREMENT`)。
|
|
28
30
|
|
|
29
31
|
# Open
|
|
30
32
|
|
|
@@ -111,11 +113,11 @@ The open node loads `flow-comet-change` for the CHANGE phase (structured questio
|
|
|
111
113
|
**加载声明(阶段层 · 双步硬规则)**:本节点技能已由入口路由经 Skill 工具加载(你正在阅读的就是它);本节点 Required Skill Calls 的加载与声明同样不可跳过:
|
|
112
114
|
|
|
113
115
|
1. **用 Skill 工具加载** `flow-comet-change` 与 `flow-comet-requirement`(本节点 Required Skill Calls)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让这两个 skill 的指令生效的是 Skill 工具把它们注入本次会话。
|
|
114
|
-
2.
|
|
116
|
+
2. 加载完成后**立即**运行声明命令,每个协议文件对应一条(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明)。`--templates` 声明本节点该读的产出物模板,**每条命令都写全清单**(两个标记各一份,节点级取并集):
|
|
115
117
|
|
|
116
118
|
```bash
|
|
117
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-change --prompt flow-kit/prompts/0-change.md
|
|
118
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-requirement --prompt flow-kit/prompts/1-requirement.md
|
|
119
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-change --prompt flow-kit/prompts/0-change.md --templates CHANGE.md,REQUIREMENT.md
|
|
120
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-requirement --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
|
|
119
121
|
```
|
|
120
122
|
|
|
121
123
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。
|
|
@@ -15,9 +15,19 @@ Responsibility: 拆原子任务(XML 格式)+ 波次划分。生成 TASK.md
|
|
|
15
15
|
|
|
16
16
|
### 必填段清单(结构+存在级)
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
|
18
|
+
段形唯一权威 = `flow-kit/templates/TASK.md` + 登记表 `../flow-comet/reference/artifact-templates.json`(模板缺席时出口输出「未校验(模板缺失)」)。
|
|
19
|
+
|
|
20
|
+
| 文件 | 无条件段(缺席 = BLOCKED) | 条件段与增量段(在场才校验 / 位置按登记表) |
|
|
21
|
+
|------|---------------------------|-------------------------------------------|
|
|
22
|
+
| TASK.md | `## 波次划分` / `## 任务清单` / `## 状态字段说明` / `## 阻塞日志` / `## Fix 任务(来自 REVIEW / INTEGRATION)`(以上段形按模板)+ 至少一个 `<task>` 块 + 每个任务含 `<verify>` 字段 + 新格式任务的 7 字段在场(集合见本册 `SKILL.md`「必填段清单」表行;单一权威 = 技能脚本的 `lib/task-graph.mjs` 导出的 `TASK7_REQUIRED` 常量,本文不复述集合) | 无(任务规模 / 粒度 / 字段内容质量属模板要求,guard 不拦,由 review 把关);`id` 是 `<task>` 元素的属性(不是字段:`<task id="T01" parallel="true" status="pending">`) |
|
|
23
|
+
|
|
24
|
+
声明本次读到的模板:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load plan flow-comet-plan --prompt flow-kit/prompts/3-task.md --templates TASK.md
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
加载顺序:先 `READ PROMPT:`(步骤权威),有模板的节点再 `READ TEMPLATE:`(段形权威);design 前端另有一行条件提示词 `2a-ui-design`。
|
|
21
31
|
|
|
22
32
|
guard 校验见 workflow-guard.mjs NODE_TRANSITION_GATES / W1-B;「填得好不好」由 review 把关。
|
|
23
33
|
|
|
@@ -17,13 +17,17 @@ Responsibility: 拆原子任务(XML 格式)+ 波次划分。生成 TASK.md
|
|
|
17
17
|
|
|
18
18
|
### 必填段清单(结构+存在级)
|
|
19
19
|
|
|
20
|
-
|
|
|
21
|
-
|
|
22
|
-
| TASK.md | 至少一个 `<task>` 块 + 每个任务含 `<verify>` 字段 + 新格式任务的 7 字段在场(`name` / `read_files` / `write_files` / `action` / `verify` / `done` / `depends_on
|
|
20
|
+
| 文件(模板 = `flow-kit/templates/<DOC>.md`) | 左栏 · 无条件段(模板 H2,缺席 / 空正文 = BLOCKED) | 右栏 · 条件段(**标题必须在场**,正文可写 `N/A`)/ 增量段(按登记位置) |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| TASK.md | 至少一个 `<task>` 块 + 每个任务含 `<verify>` 字段 + 新格式任务的 7 字段在场(`name` / `read_files` / `write_files` / `action` / `verify` / `done` / `depends_on`);模板 5 个 H2 段 `## 波次划分` / `## 任务清单` / `## 状态字段说明` / `## 阻塞日志` / `## Fix 任务(来自 REVIEW / INTEGRATION)` | 无模板条件段、无增量段(5 个 H2 全部无条件)——任务块的 7 字段与任务图(依赖环 / 缺失依赖 / 并行写写冲突)属元素级判据,见下方「硬性拦截」段 |
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
首部字段 `Change ID` / `关联` 已在场时值不得为空(键集不强制)。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
guard 校验见 workflow-guard.mjs NODE_TRANSITION_GATES / W1-B:任务块结构、每任务 `<verify>`、**新格式任务的 7 字段在场**、以及 TASK.md 的模板骨架(段标题 / 段序 / 首部字段值非空)都由 guard 拦(新 change 缺任一 = 出口 BLOCKED;旧格式模板 / 旧 change 渐进 WARN);「填得好不好」——字段内容质量与任务粒度——由 review 把关。
|
|
27
|
+
|
|
28
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
29
|
+
|
|
30
|
+
加载顺序:先读 `READ PROMPT:`(`3-task`),再读 `READ TEMPLATE:`(`TASK`)。
|
|
27
31
|
|
|
28
32
|
波次散文一致性:`## 波次划分` 中标记为并行([P])的任务必须与 XML 任务 `parallel="true"` 一致——新 change 不一致 BLOCKED(旧 change WARN 渐进)。
|
|
29
33
|
|
|
@@ -131,10 +135,10 @@ The plan node loads `flow-comet-task` to perform task decomposition. It reads DE
|
|
|
131
135
|
**加载声明(阶段层 · 双步硬规则)**:本节点技能已由入口路由经 Skill 工具加载(你正在阅读的就是它);本节点 Required Skill Calls 的加载与声明同样不可跳过:
|
|
132
136
|
|
|
133
137
|
1. **用 Skill 工具加载** `flow-comet-task`(本节点 Required Skill Call)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让 flow-comet-task 指令生效的是 Skill 工具把它注入本次会话。
|
|
134
|
-
2.
|
|
138
|
+
2. 加载完成后**立即**运行声明命令(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明)。`--templates` 声明本节点该读的产出物模板(plan → `TASK.md`):
|
|
135
139
|
|
|
136
140
|
```bash
|
|
137
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load plan flow-comet-task --prompt flow-kit/prompts/3-task.md
|
|
141
|
+
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
|
|
138
142
|
```
|
|
139
143
|
|
|
140
144
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。
|
|
@@ -7,7 +7,7 @@ description: "flow-kit REQUIREMENT 阶段协议:AC(Given/When/Then)+ v1·v
|
|
|
7
7
|
|
|
8
8
|
本 Skill 为 flow-comet 的 open 节点提供 flow-kit 的 REQUIREMENT 需求分析。
|
|
9
9
|
|
|
10
|
-
>
|
|
10
|
+
> **模板权威**:本技能产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
11
11
|
|
|
12
12
|
## 加载
|
|
13
13
|
|
|
@@ -17,13 +17,19 @@ This node performs a structured multi-round review of the implemented change, ch
|
|
|
17
17
|
|
|
18
18
|
### 必填段清单(结构+存在级)
|
|
19
19
|
|
|
20
|
-
|
|
|
21
|
-
|
|
22
|
-
| REVIEW.md |
|
|
20
|
+
| 文件(模板 = `flow-kit/templates/<DOC>.md`) | 左栏 · 无条件段(模板 H2,缺席 / 空正文 = BLOCKED) | 右栏 · 条件段(**标题必须在场**,正文可写 `N/A`)/ 增量段(按登记位置) |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| `REVIEW.md` | `## 第一轮 · Spec 合规审查` / `## 第二轮 · 代码质量审查(6 维衰退风险)` / `## 总结`;结构子段 `### 2.0 TEST.md 5 轮金字塔完整性` / `### 2.1` / `### 2.2` / `### 2.3` 在父段在场时必在场;文件 ≥ 100 字节;首部字段 `Change ID` / `审查时间` / `审查者` / `总体结论` 已在场时值不得为空(键集不强制) | **条件段**:`## 第三轮 · UI 视觉审查(仅前端)` / `## 第四轮 · 补充审查(按触发条件)`——标题必须在场,不适用写 `N/A`(其结构子段 `### 4.1` / `### 4.2` 在父段适用时必在场);**增量段**:发现条目的**处置标记**(`[已修]` / `[升级]` / `[转待办]`,必填,写在 `### 2.2 6 维诊断 · 详细发现` 段内) |
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
发现写在模板外的 `## 发现` 而 `### 2.2` 无条目 → 新 change BLOCKED(条目记录在非模板位置等于静默丢弃);**Major `[转待办]` 须有用户裁决记录**(同段、文末或单独段落「用户裁决:接受延期」+ 指向该条目 + `[升级]` 承接——单独段落与条目以空行分隔、位置不限),缺失新 change BLOCKED / 旧 change WARN 渐进。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
本出口**声明加载** `TEST.md` 并做 **5 轮完整性过程检查**(细目见 `flow-comet-test` 册);`TEST.md` 的**结构骨架校验在 verify 出口**(`flowkit.verify.v1`),不在本出口——`## 验证命令` 增量段的执行与校验同样在 verify 出口。
|
|
27
|
+
|
|
28
|
+
guard 校验见 workflow-guard.mjs 的 review 出口门禁(发现区处置标记 / 发现位置 / Major 延期裁决 / 模板骨架)与模板骨架派生(段标题 / 段序 / 首部字段 / 增量段位置);「填得好不好」由 review 自身把关。
|
|
29
|
+
|
|
30
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
31
|
+
|
|
32
|
+
加载顺序:先读 `READ PROMPT:`(`6-review`、`5-test`),再读 `READ TEMPLATE:`(`REVIEW`、`TEST`)。
|
|
27
33
|
|
|
28
34
|
### 必查清单(review 逐项核对 · 执行者交付纪律)
|
|
29
35
|
|
|
@@ -164,11 +170,11 @@ Load `flow-comet-test` during this Node and record completed check `required-ski
|
|
|
164
170
|
**加载声明(阶段层 · 双步硬规则)**:本节点技能已由入口路由经 Skill 工具加载(你正在阅读的就是它);本节点 Required Skill Calls 的加载与声明同样不可跳过:
|
|
165
171
|
|
|
166
172
|
1. 本节点的同名条目已随路由加载——同名 required 条目(`flow-comet-review`)无需重复加载,仅需运行下方对应声明命令(只读取 SKILL.md 文件不叫加载,**不得跳过**真正的 Skill 工具注入步骤)。`flow-comet-test` 为本节点 Required Skill Call,每次 review **必须用 Skill 工具加载**。
|
|
167
|
-
2.
|
|
173
|
+
2. 加载完成后**立即**运行声明命令,每个协议文件对应一条(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明)。`--templates` 声明本节点该读的产出物模板(review → `REVIEW.md` + `TEST.md`,两条命令各写全清单):
|
|
168
174
|
|
|
169
175
|
```bash
|
|
170
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load review flow-comet-review --prompt flow-kit/prompts/6-review.md
|
|
171
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load review flow-comet-test --prompt flow-kit/prompts/5-test.md
|
|
176
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load review flow-comet-review --prompt flow-kit/prompts/6-review.md --templates REVIEW.md,TEST.md
|
|
177
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load review flow-comet-test --prompt flow-kit/prompts/5-test.md --templates REVIEW.md,TEST.md
|
|
172
178
|
```
|
|
173
179
|
|
|
174
180
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。
|
|
@@ -201,7 +207,7 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs record review '{"summa
|
|
|
201
207
|
| `review-evidence` | REVIEW.md exists | artifact-exists |
|
|
202
208
|
| `critical-resolved` | 0 unacknowledged Critical items | 执行纪律(review 把关),guard 不校验 |
|
|
203
209
|
| `no-code-changes` | Reviewer did not modify code files | 执行纪律(review 把关),guard 不校验 |
|
|
204
|
-
| `test-pyramid-checked` | TEST.md 5
|
|
210
|
+
| `test-pyramid-checked` | TEST.md 5 轮金字塔的结构在场(各轮 H2 标题 + 结构子段)+ REVIEW 的 `### 2.0` 完整性小节 | 结构级(`### 2.0` 子段由 REVIEW 模板骨架在本出口强制;`TEST.md` 骨架由 verify 出口按登记表校验——缺席即 BLOCKED,条件轮写 `N/A` 放行);5 轮内容质量仍由 review 自己把关 |
|
|
205
211
|
|
|
206
212
|
## Exit Check
|
|
207
213
|
|
|
@@ -17,9 +17,19 @@ Responsibility: 委托 [P] 并行任务给子代理,要求加载 flow-comet-de
|
|
|
17
17
|
|
|
18
18
|
### 必填段清单(结构+存在级)
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
|
20
|
+
段形唯一权威 = `flow-kit/templates/SUMMARY.md` + 登记表 `../flow-comet/reference/artifact-templates.json`(模板缺席时出口输出「未校验(模板缺失)」)。
|
|
21
|
+
|
|
22
|
+
| 文件 | 无条件段(缺席 = BLOCKED) | 条件段与增量段(在场才校验 / 位置按登记表) |
|
|
23
|
+
|------|---------------------------|-------------------------------------------|
|
|
24
|
+
| SUMMARY.md | `## 做了什么(一段话)` / `## 改动文件` / `## verify 输出` / `## 6 维自查`(须含实质内容)/ `## 越界检查` / `## 是否触发新工作` / `## 完成判定` | 条件段:`## 数据库迁移`(涉 schema 变更)/ `## 破坏性变更` / `## 决策与偏离`——标题必须在场,不涉及时写「不适用」;增量段:`## 自检方法`(紧随 `## 越界检查` 或位于骨架段之后,须声明自检方法名)与 `## LESSONS 扫描`(紧随自检方法之后或文末,逐条回应命中的 `L-NNN`),两者均必填 |
|
|
25
|
+
|
|
26
|
+
声明本次读到的模板:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load subagent-execute flow-comet-subagent-execute --prompt flow-kit/prompts/4-dev.md --templates SUMMARY.md
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
加载顺序:先 `READ PROMPT:`(步骤权威),有模板的节点再 `READ TEMPLATE:`(段形权威);design 前端另有一行条件提示词 `2a-ui-design`。
|
|
23
33
|
|
|
24
34
|
guard 校验见 workflow-guard.mjs NODE_TRANSITION_GATES / W1-B;「填得好不好」由 review 把关。
|
|
25
35
|
|
|
@@ -37,19 +37,21 @@ Responsibility: 委托 [P] 并行任务给子代理,要求加载 flow-comet-de
|
|
|
37
37
|
|
|
38
38
|
### 必填段清单(结构+存在级)
|
|
39
39
|
|
|
40
|
-
|
|
|
41
|
-
|
|
42
|
-
| SUMMARY.md | `## verify
|
|
40
|
+
| 文件(模板 = `flow-kit/templates/<DOC>.md`) | 左栏 · 无条件段(模板 H2,缺席 / 空正文 = BLOCKED) | 右栏 · 条件段(**标题必须在场**,正文可写 `N/A`)/ 增量段(按登记位置) |
|
|
41
|
+
|------|------|------|
|
|
42
|
+
| `SUMMARY.md` | `## 做了什么(一段话)` / `## 改动文件` / `## verify 输出(必填)` / `## 6 维自查`(须含实质内容)/ `## 越界检查(必填)` / `## 是否触发新工作` / `## 完成判定`;首部四字段 `Change ID` / `Task ID` / `完成时间` / `AI 角色` 必填 | **条件段**:`## 数据库迁移(涉及 schema 变更必填)` / `## 破坏性变更(涉及破坏性改动必填)` / `## 决策与偏离(如有)`——标题必须在场,不适用写 `N/A`;**增量段**:`## 自检方法`(整段必填,紧随 `## 越界检查` 或文末)、`## LESSONS 扫描`(整段必填,紧随 `## 自检方法`) |
|
|
43
43
|
|
|
44
|
-
> **注意**:flow-kit 的 SUMMARY 模板**不含 `## 自检方法`
|
|
44
|
+
> **注意**:flow-kit 的 SUMMARY 模板**不含 `## 自检方法` 与 `## LESSONS 扫描` 两段**——它们是 flow-comet 登记的增量段。使用 `flow-kit/templates/SUMMARY.md` 填写后,**必须按上方右栏补写这两段**,否则新 change 的 exit 会被 BLOCKED。
|
|
45
45
|
>
|
|
46
46
|
> **无 parallel 任务时**:若路由到此节点但 TASK.md 无 `parallel="true" status="pending"` 任务(如全部任务已被 execute 串行处理),按常规流程记录证据后直接退出(entry → record → exit),不要空转等待。
|
|
47
47
|
|
|
48
48
|
加载声明(阶段层 · 双步硬规则)见下文 Required Skill Calls 节。
|
|
49
49
|
|
|
50
|
-
guard 校验见 workflow-guard.mjs
|
|
50
|
+
guard 校验见 workflow-guard.mjs 的委托出口门禁(必填段 + 6 维自查实质内容 + 自检方法声明三值 + LESSONS 扫描段与命中核对)与模板骨架派生(段标题 / 段序 / 首部字段 / 增量段位置);「填得好不好」由 review 把关。
|
|
51
51
|
|
|
52
|
-
>
|
|
52
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
53
|
+
|
|
54
|
+
加载顺序:先读 `READ PROMPT:`(`4-dev`),再读 `READ TEMPLATE:`(`SUMMARY`)。
|
|
53
55
|
|
|
54
56
|
# Subagent Execute
|
|
55
57
|
|
|
@@ -129,6 +131,7 @@ Division of labor (pass-based collaboration): this node handles parallel delegat
|
|
|
129
131
|
- Explicit requirement to return `completedChecks` in the Return Contract containing `required-skill:subagent-execute.flow-comet-dev`(证明已加载 implementation skill;guard W1-D 严格校验,缺失 → exit BLOCKED,无旧 change 豁免)。Skill 工具不可用而走降级时该条目标记仍按契约回传,但必须与 `skillToolFallback` 降级声明并排出现——只回传标记而无声明视为不实声明,orchestrator 不得记录 result。
|
|
130
132
|
- The task's `read_files` and `write_files` boundaries.
|
|
131
133
|
- Instruction to produce `<task-id>-SUMMARY.md` in `.specs/<change-id>/` following the `flow-kit/templates/SUMMARY.md` template(标题/首部/段序保真,另补 flow-comet 增量 `## 自检方法` 段)。
|
|
134
|
+
- **写前读模板(固定句式)**:「开工前先读 <本任务产出物的模板路径>,按其标题 / 首部 / 段序填写,并按本仓登记补写增量段」——模板路径逐任务给出(本节点默认 `flow-kit/templates/SUMMARY.md`);只写「按模板填写」视为委托前检查未完成。
|
|
132
135
|
- **提交边界警告**:提交**只含该任务 write_files 范围内的文件**(含测试文件)——不得包含 TASK.md 与其他协调者维护的 .specs 工件(新 change 提交越界 BLOCKED;实测子代理提交含 TASK.md 被 W2-D 拦截)。**提交从属规则**:任务专属的 `<task-id>-SUMMARY.md`(位于 `.specs/<change-id>/`,是 flow-comet 强制产物)允许随任务提交属流程默认豁免——目标仓库的既有规定优先,若目标仓库忽略清单等既有规定拒绝其入库,被拒即为正确行为,严禁 force-add 强加越库提交;委托校验对任务摘要的豁免属于校验宽容度,不是入库指令。
|
|
133
136
|
|
|
134
137
|
- **提交面 pathspec 纪律(五要素,见 Guidance 同名小节)**:子代理必须用 `git add -- <自己字面路径>` + `git commit -- <同一路径>`,锁失败重试,禁裸 `add` / `commit -a` / `stash` / `clean` / `reset`(适用条件:**多个写者共享同一工作区**;各自独立工作区内的局部 `reset` / `clean` 不在禁令内)。
|
|
@@ -218,10 +221,10 @@ The subagent-execute node identifies all `parallel="true"` pending tasks in TASK
|
|
|
218
221
|
**加载声明(阶段层 · 双步硬规则)**:本节点技能已由入口路由经 Skill 工具加载(你正在阅读的就是它);本节点 Required Skill Calls 的加载与声明同样不可跳过:
|
|
219
222
|
|
|
220
223
|
1. **用 Skill 工具加载** `flow-comet-dev`。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让 flow-comet-dev 指令生效的是 Skill 工具把它注入本次会话。本节点的 flow-comet-dev 为 handoff scope——协调者在此声明(声明标记的自动补写不覆盖 handoff scope,必须手动声明),各子代理在各自会话按 `flow-kit/prompts/4-dev.md` 协议用 Skill 工具加载并执行;协调者构造 handoff prompt 时按 `flow-kit/prompts/4-dev.md` + `flow-kit/templates/SUMMARY.md` 引用子代理的 dev 协议与交付模板。
|
|
221
|
-
2.
|
|
224
|
+
2. 加载完成后**立即**运行声明命令(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明)。`--templates` 声明本节点该读的产出物模板(subagent-execute → `SUMMARY.md`):
|
|
222
225
|
|
|
223
226
|
```bash
|
|
224
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load subagent-execute flow-comet-dev --prompt flow-kit/prompts/4-dev.md
|
|
227
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load subagent-execute flow-comet-dev --prompt flow-kit/prompts/4-dev.md --templates SUMMARY.md
|
|
225
228
|
```
|
|
226
229
|
|
|
227
230
|
> **跑 skill-load 声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。
|
|
@@ -7,7 +7,7 @@ description: "flow-kit TASK 阶段协议:拆原子任务(XML 格式)、rea
|
|
|
7
7
|
|
|
8
8
|
本 Skill 为 flow-comet 的 plan 节点提供 flow-kit 的 TASK 拆解流程。
|
|
9
9
|
|
|
10
|
-
>
|
|
10
|
+
> **模板权威**:本节点产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
11
11
|
|
|
12
12
|
## 加载
|
|
13
13
|
|
|
@@ -7,12 +7,16 @@ description: "flow-kit TEST 阶段协议:5 轮测试金字塔(功能/性能/
|
|
|
7
7
|
|
|
8
8
|
本 Skill 为 flow-comet 的 review 节点提供 flow-kit 的 5 轮测试金字塔。
|
|
9
9
|
|
|
10
|
-
>
|
|
10
|
+
> **模板权威**:本技能产出工件的段形 = **上游模板 + 本仓登记的增量段**——唯一权威 = `flow-kit/templates/**`(段与正文),条件段 / 结构子段 / 增量段与指纹由 `../flow-comet/reference/artifact-templates.json` 登记;`.specs/archive/**` 是历史证据、**不是模板来源**——不得以「上一轮就是这么写的」对齐段形。
|
|
11
11
|
|
|
12
12
|
## 加载
|
|
13
13
|
|
|
14
14
|
读取 `flow-kit/prompts/5-test.md` 并按其执行。
|
|
15
15
|
|
|
16
|
+
## 上游段表不采用(覆盖声明)
|
|
17
|
+
|
|
18
|
+
`flow-kit/prompts/5-test.md` 把「本次测试范围声明」写成职责小节里的一个 H2,且其 H3 编号与模板错位(例:1.3 覆盖率与边界、1.4 测试质量自检、2.2 前端性能、4.2 数据迁移、5.2 指标与追踪、5.3 告警与健康检查)——**这组 H3 编号不采用**:H2 / H3 的段名与段序一律以 `flow-kit/templates/TEST.md` 为准(`第 2 轮` ~ `第 5 轮` 是标题必须在场的条件段,不适用写 `N/A`)。
|
|
19
|
+
|
|
16
20
|
### 5 轮测试金字塔
|
|
17
21
|
|
|
18
22
|
| 轮次 | 内容 | 适用性 |
|
|
@@ -40,4 +44,4 @@ description: "flow-kit TEST 阶段协议:5 轮测试金字塔(功能/性能/
|
|
|
40
44
|
|
|
41
45
|
## 使用范围
|
|
42
46
|
|
|
43
|
-
TEST.md
|
|
47
|
+
TEST.md 的**结构在场**由 **verify 出口**按登记表骨架校验(5 轮 H2 与结构子段,条件轮写 `N/A` 放行);**5 轮内容质量**由 review 节点第 2 轮检查(`### 2.0 TEST.md 5 轮金字塔完整性` 小节)。brooks-lint 已装时用 `/brooks-test`(Codex 用 `$brooks-test`),未装时用内置清单。
|