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
|
@@ -1 +1 @@
|
|
|
1
|
-
1.6.
|
|
1
|
+
1.6.5
|
|
@@ -7,6 +7,18 @@ description: "Use when the user wants the flow-comet managed workflow for flow-k
|
|
|
7
7
|
|
|
8
8
|
# flow-comet
|
|
9
9
|
|
|
10
|
+
## 协议覆盖声明(phase-gated · 上游 vendored 只读基准)
|
|
11
|
+
|
|
12
|
+
**上游只读基准**:`flow-kit/prompts/**` 与 `flow-kit/templates/**` 是随包引入的上游 vendored 基准,本仓**只读引用、不修改**;下列是本仓有意的方向修正,逐条可审计。
|
|
13
|
+
|
|
14
|
+
**不采用(逐条点名)**:① flow-kit 设计原则里的「artifact-first,不是 phase-gated(阶段可压缩、可回炉)」——本仓是 **phase-gated**:8 节点 entry/exit 门 + 节点顺序门,`currentNode` 不匹配即 BLOCKED;② 上游各 prompt 的段表只作内容指引、不作段形来源——`flow-kit/prompts/0-change.md` 的 CHANGE 自检 5 段清单、`flow-kit/prompts/2-design.md` 的 §3 / §4 编号(与模板的 3 / 4 / 5 互换)、`flow-kit/prompts/5-test.md` 的 H3 编号(与模板 H3 错位)一律不采用。
|
|
15
|
+
|
|
16
|
+
**沿用上游**:工件优先级(`.specs/<change-id>/` 是唯一进度真相,可回炉重进)与各阶段的内容协议(反问 / 决策清单 / 5 轮金字塔 / LESSONS 提名)全部沿用;段名、段序与结构子段以 `flow-kit/templates/**` 加 `reference/artifact-templates.json` 为唯一来源。
|
|
17
|
+
|
|
18
|
+
**阶段门是工件门的加强,不是替代**:工件仍是唯一真相,阶段门只把「缺工件」从「事后发现」提前到「出口拦截」——不能拿阶段门替代工件本身。
|
|
19
|
+
|
|
20
|
+
**以本节为准**:本节的 phase-gated 反转全局生效;其余覆盖项按各自小节划定适用面,节点册与技能册另有覆盖声明的,以该册声明为准。
|
|
21
|
+
|
|
10
22
|
## Decision Core
|
|
11
23
|
|
|
12
24
|
### 自动节点检测
|
|
@@ -167,7 +179,7 @@ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--
|
|
|
167
179
|
|
|
168
180
|
**新 change 严格模式**:`init` 创建的 change 标记为"新"(`newChange: true`)——新 change 下全部内容级检查强制 BLOCKED(处置标记/缓存证据/波次散文/越权委托/SUMMARY 完整性/进入证据等);旧 change(历史遗留,无标记)保持渐进 WARN。执行者可通过 `status` 确认当前 change 的新旧。
|
|
169
181
|
|
|
170
|
-
> **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` 建标记,并在 record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端不加载、不声明,出口打印可见的 `UI-DESIGN: skipped(非前端)` 后放行;旧 change 缺件仅 WARN。
|
|
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。
|
|
171
183
|
|
|
172
184
|
**节点技能两层加载模型(入口层 · 双步硬规则)**:路由到节点后,以下两步**都不可跳过**:
|
|
173
185
|
|
|
@@ -175,9 +187,13 @@ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--
|
|
|
175
187
|
2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation 同名的条目已随路由加载,无需重复加载),加载完成后**立即**逐条运行声明命令(open/review 等涉及多个协议文件的节点,每个协议文件对应一条声明命令):
|
|
176
188
|
|
|
177
189
|
```bash
|
|
178
|
-
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <skill> --prompt flow-kit/prompts/<阶段>.md
|
|
190
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <skill> --prompt flow-kit/prompts/<阶段>.md --templates <模板基名,...>
|
|
179
191
|
```
|
|
180
192
|
|
|
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),不会静默写成一条与节点无关的声明。
|
|
194
|
+
|
|
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。
|
|
196
|
+
|
|
181
197
|
> **跑声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。协议的引用示例:execute / subagent-execute 节点加载 flow-comet-dev 时用 `--prompt flow-kit/prompts/4-dev.md`(DEV 阶段协议),交付物按 `flow-kit/templates/SUMMARY.md` 模板填写并补写 `## 自检方法` 段。
|
|
182
198
|
|
|
183
199
|
节点退出(exit)与证据记录(record)会核对声明标记。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:新 change 的 required 条目不再自动补写——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);声明标记自动补写仅对旧 change 兜底(按协议 requiredSkillCalls 代记,标记带 `auto: true`),手动声明仍推荐(如实记录加载动作与协议文件)。
|
|
@@ -252,9 +268,11 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs record <node-id> '{"su
|
|
|
252
268
|
|
|
253
269
|
All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT.md, LESSONS.md, CHANGELOG.md).
|
|
254
270
|
|
|
255
|
-
>
|
|
271
|
+
> **模板权威**:工件段形 = **上游模板 + 本仓登记的增量段**——`flow-kit/templates/**` 是唯一权威(段与正文),条件段 / 结构子段 / 增量段与指纹由 `reference/artifact-templates.json` 登记。
|
|
256
272
|
> **archive 定位与读法**:`.specs/archive/**` 是历史证据。**何时可读**:工作区文档明确要求(如断点续传 / 决策追溯),或某 guard 硬校验的约定在模板与 LESSONS 中查不到时;**读什么**:只取结构与证据;**不读什么**:不作为格式规范或决策依据,不得以归档工件对齐段形。
|
|
257
273
|
|
|
274
|
+
> **要判定某一段是上游模板段还是本仓登记的增量段、或要核对某工件的条件段与结构子段登记时,先读 `reference/artifact-template-overlay.md`**(按登记表派生的人类可读册:逐工件的标题形态 / 首部字段 / 无条件段 / 条件段 / 结构子段 / 增量段与位置)。
|
|
275
|
+
|
|
258
276
|
### Scripts
|
|
259
277
|
|
|
260
278
|
> **命令路径的平台化**:本文件命令统一为**权威源设计形态** `node .claude/skills/flow-comet/scripts/...`。安装时由 prepare-env 按平台处理——Claude Code 平台零替换(即此形态);Codex 平台自动替换为 `node .agents/skills/flow-comet/scripts/...`(技能安装于 `.agents/skills/`,Codex 自动发现)。相对引用(`reference/`、`flow-kit/`)不替换——随技能目录整体复制,相对位置不变。手动复制(方案 C)仅面向 Claude Code;Codex 请用安装器。
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# 工件模板登记册(人类可读版)
|
|
2
|
+
|
|
3
|
+
> **读者对象**:要核对「某份工件的某一段从哪来」的执行者与审查者——典型场景是段形被判缺时,确认这一段是上游模板段,还是本仓追加的增量段。
|
|
4
|
+
> **何时读**:要判定某段的归属、要核对条件段与结构子段的登记、或要确认某个工件的标题形态与首部字段时读它。快照口径与指纹以 `reference/artifact-templates.json` 为准——本册(下称「登记册」)是那张登记表的人类可读派生,登记表增删改后同批更新本册。
|
|
5
|
+
|
|
6
|
+
## 一、单一来源与派生关系
|
|
7
|
+
|
|
8
|
+
| 层 | 载体 | 作用 |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| 内容权威 | `flow-kit/templates/<DOC>.md` | 段名、段序、正文原文——段集合以它为准 |
|
|
11
|
+
| 结构登记 | `reference/artifact-templates.json` | 模板本身推不出的三类信息:条件段、结构子段、增量段;另记首部字段 / 标题形态 / 指纹 |
|
|
12
|
+
| 本册 | `reference/artifact-template-overlay.md` | 上面两者的合并读法(供人读;改登记表时同批更新,发版期比对指纹) |
|
|
13
|
+
|
|
14
|
+
**合并与判定口径**(与引擎同口径,逐条对应报错类别):
|
|
15
|
+
|
|
16
|
+
- **段集合以模板为准**:登记表里多出的段(模板已删)忽略并提示;模板里多出的段(登记表未登记)按无条件段处理。
|
|
17
|
+
- **段名归一**:忽略编号、括号内容与大小写,核心词必须一致(`## 1. 决策清单` 与 `## 决策清单` 同键);结构子段里的同名对按括号内容区分(`Button (Primary)` 与 `Button (Secondary)` 不是一段)。
|
|
18
|
+
- **无条件段**:缺标题即拦;段正文不得为空。
|
|
19
|
+
- **条件段**:**标题必须在场**(缺席即拦);正文可写 `N/A` / `不适用` / `无` / `—` / `未涉及` / `无变更`,视为已填;与模板该段正文逐字相同判未填。
|
|
20
|
+
- **结构子段**:父段在场且父段正文不是整段 `N/A` 时必须在场;父段整段写 `N/A` 则子段豁免。
|
|
21
|
+
- **增量段**:不参与模板全序;只校验位置(紧随锚段 / 文末 / 位置不限 / 写在指定段内)。`required` 只由各自门禁消费,本层不做存在性兜底。
|
|
22
|
+
- **首部与标题**:标题形态按模板首行(大小写不敏感);首部只校验已在场的 `- **字段**:` 键的值非空。
|
|
23
|
+
- **模板缺席**:整份不校验并输出「未校验(模板缺失)」——不拿内置骨架顶替;标题形态与首部字段来自登记表,照常校验。
|
|
24
|
+
- **两阶段报错**:同一工件首次失败只给模板路径与类别计数,再次失败才列段名(记录在 `.specs/<change-id>/.template-hints.json`,通过后清除)。
|
|
25
|
+
|
|
26
|
+
## 二、逐工件登记
|
|
27
|
+
|
|
28
|
+
### ARCHITECTURE — `flow-kit/templates/ARCHITECTURE.md`
|
|
29
|
+
|
|
30
|
+
- 标题形态:`# ARCHITECTURE — 项目级系统架构(活文档)`
|
|
31
|
+
- 首部字段:维护者 / 首次创建 / 最近修订 / 当前 ADR 编号最大值
|
|
32
|
+
- 无条件段(8):`1. 系统概览` · `2. 模块清单 + 边界` · `3. ADR 列表` · `4. 跨模块契约` · `5. 扩展点` · `6. 容量 / 性能边界` · `7. 已知技术债 + 长期方向` · `8. 修订历史`
|
|
33
|
+
- 条件段:无
|
|
34
|
+
- 结构子段:`1.1 一句话定位` · `1.2 服务边界图` · `1.3 关键非功能性指标` · `2.1 模块表` · `2.2 模块依赖规则` · `4.1 公共 HTTP API` · `4.2 事件总线` · `4.3 数据库 schema` · `4.4 共享配置项`
|
|
35
|
+
- 增量段:无
|
|
36
|
+
- 附加:「ADR 列表」段内的 `### ADR-<数字>` 条目另按条目字段校验(健康巡检与架构沉淀两条侧命令共用同一判据)。
|
|
37
|
+
|
|
38
|
+
### CHANGE — `flow-kit/templates/CHANGE.md`
|
|
39
|
+
|
|
40
|
+
- 标题形态:`# CHANGE: <一句话标题>`
|
|
41
|
+
- 首部字段:Change ID / 创建日期 / 路径建议 / 状态
|
|
42
|
+
- 无条件段(6):`Why(为什么做)` · `What(做什么)` · `影响面` · `范围排除(这次不做)` · `验收线(粗粒度,不是 AC)` · `风险与未知`
|
|
43
|
+
- 条件段(1):`视觉调性(前端项目必填,由 0-change 步骤 0.6 预选填入)`——标题必须在场;非前端写「不适用」的结构形态标记,缺席不再默认判非前端
|
|
44
|
+
- 结构子段:无
|
|
45
|
+
- 增量段(1):`架构层影响声明`(整段,可选,位置 = 文末 / `风险与未知` 之后)
|
|
46
|
+
|
|
47
|
+
### CONTEXT — `flow-kit/templates/CONTEXT.md`
|
|
48
|
+
|
|
49
|
+
- 标题形态:`# CONTEXT — 项目共享上下文`
|
|
50
|
+
- 首部字段:无
|
|
51
|
+
- 无条件段(7):`项目概要` · `技术栈(团队级默认 / 已锁定)` · `域语言(术语表)` · `已锁决策` · `默认偏好` · `既有抽象索引` · `intel-scan 元数据`
|
|
52
|
+
- 条件段:无
|
|
53
|
+
- 结构子段(挂在「既有抽象索引」下):`HTTP 客户端` · `数据库访问` · `状态管理` · `工具函数` · `自定义 hooks` · `错误处理` · `Schema / 迁移` · `命名约定` · `禁动清单` · `技术债`
|
|
54
|
+
- 增量段:无
|
|
55
|
+
|
|
56
|
+
### DESIGN — `flow-kit/templates/DESIGN.md`
|
|
57
|
+
|
|
58
|
+
- 标题形态:`# DESIGN: <change 标题>`
|
|
59
|
+
- 首部字段:Change ID / 关联 / 作者
|
|
60
|
+
- 无条件段(5):`0. 技术栈选定` · `1. 决策清单` · `2. 数据流 / 架构图` · `5. 风险` · `6. 不在范围`
|
|
61
|
+
- 条件段(4):`0.5 既有架构对齐` · `3. 关键状态机(如有)` · `4. ADR 索引` · `9. 架构沉淀建议`——标题必须在场
|
|
62
|
+
- 结构子段:`0.5.1 本次 change 触碰的既有模块` · `0.5.2 既有抽象沿用对照表` · `0.5.3 沿用模式 vs 引入新模式`(挂在 0.5);`9.1` ~ `9.5` 五个沉淀槽(挂在 9)
|
|
63
|
+
- 增量段:无
|
|
64
|
+
- 附加:`DESIGN-lite.md` 不是登记工件,只校验标题形态。
|
|
65
|
+
|
|
66
|
+
### LESSONS — `flow-kit/templates/LESSONS.md`
|
|
67
|
+
|
|
68
|
+
- 标题形态:`# LESSONS — 跨任务失败知识库`
|
|
69
|
+
- 首部字段:无
|
|
70
|
+
- 无条件段(5):`标签索引` · `使用方式` · `条目格式(复制此模板新增)` · `提名条件` · `复核与剪枝`
|
|
71
|
+
- 条件段(1):`条目区(实际项目里把下面的示例替换成你的真实条目)`——标题必须在场
|
|
72
|
+
- 结构子段:`写代码前(DEV 阶段,R1.8)` · `任务完成后(INTEGRATION ARCHIVE 步骤)`(挂在「使用方式」)
|
|
73
|
+
- 增量段:无
|
|
74
|
+
- 附加:条目本身写 `### L-NNN` 并在「条目区」内按编号升序;`## L-NNN` 旧形态在 open / verify / archive 三个出口被拦。
|
|
75
|
+
|
|
76
|
+
### PROGRESS — `flow-kit/templates/PROGRESS.md`
|
|
77
|
+
|
|
78
|
+
- 标题形态:`# PROGRESS: <T01 - 任务名>`
|
|
79
|
+
- 首部字段:Change ID / Task ID / 暂停时间 / 触发清窗的信号
|
|
80
|
+
- 无条件段(6):`已完成的子步骤` · `当前正在做(清窗那一刻的状态)` · `已排除的方案(反重复关键)` · `待确认的假设` · `临时记下的线索 / 文件位置` · `恢复指引(给下一会话的 AI)`
|
|
81
|
+
- 条件段:无
|
|
82
|
+
- 结构子段:无
|
|
83
|
+
- 增量段:无
|
|
84
|
+
|
|
85
|
+
### REQUIREMENT — `flow-kit/templates/REQUIREMENT.md`
|
|
86
|
+
|
|
87
|
+
- 标题形态:`# REQUIREMENT: <change 标题>`
|
|
88
|
+
- 首部字段:Change ID / 关联
|
|
89
|
+
- 无条件段(5):`用户故事` · `验收准则(AC)` · `范围切分` · `非功能性需求` · `依赖与假设`
|
|
90
|
+
- 条件段:无
|
|
91
|
+
- 结构子段(挂在「范围切分」):`v1(本次必做)` · `v2(下一轮考虑,不本次)` · `out(永远不做)`
|
|
92
|
+
- 增量段:无
|
|
93
|
+
|
|
94
|
+
### REVIEW — `flow-kit/templates/REVIEW.md`
|
|
95
|
+
|
|
96
|
+
- 标题形态:`# REVIEW: <change 标题>`
|
|
97
|
+
- 首部字段:Change ID / 审查时间 / 审查者 / 总体结论
|
|
98
|
+
- 无条件段(3):`第一轮 · Spec 合规审查` · `第二轮 · 代码质量审查(6 维衰退风险)` · `总结`
|
|
99
|
+
- 条件段(2):`第三轮 · UI 视觉审查`(仅前端) · `第四轮 · 补充审查(按触发条件)`——标题必须在场
|
|
100
|
+
- 结构子段:`2.0 TEST.md 5 轮金字塔完整性` · `2.1 6 维诊断 · 严重度统计` · `2.2 6 维诊断 · 详细发现` · `2.3 架构依赖图`;`4.1 技术债评估` · `4.2 跨模型分歧`
|
|
101
|
+
- 增量段(1):`处置标记`(条目级标记,必填,位置 = 写在 `2.2 6 维诊断 · 详细发现` 段内)——发现写在模板外的段而 2.2 无条目同样被拦
|
|
102
|
+
|
|
103
|
+
### STATE — `flow-kit/templates/STATE.md`
|
|
104
|
+
|
|
105
|
+
- 标题形态:`# STATE — 跨会话项目状态`
|
|
106
|
+
- 首部字段:无
|
|
107
|
+
- 无条件段(6):`当前位置` · `阻塞与待决策` · `决策日志(最近 10 条,倒序)` · `已归档 Changes(最近 5 个,倒序)` · `横向命令状态` · `健康检查(AI 每次会话开始前自检)`
|
|
108
|
+
- 条件段:无
|
|
109
|
+
- 结构子段:无
|
|
110
|
+
- 增量段:无
|
|
111
|
+
- 说明:本仓的运行状态由引擎状态文件承载,本模板不参与节点门禁。
|
|
112
|
+
|
|
113
|
+
### SUMMARY — `flow-kit/templates/SUMMARY.md`
|
|
114
|
+
|
|
115
|
+
- 标题形态:`# SUMMARY: <T01 - 任务名>`
|
|
116
|
+
- 首部字段:Change ID / Task ID / 完成时间 / AI 角色
|
|
117
|
+
- 无条件段(7):`做了什么(一段话)` · `改动文件` · `verify 输出(必填)` · `6 维自查` · `越界检查(必填)` · `是否触发新工作` · `完成判定`
|
|
118
|
+
- 条件段(3):`数据库迁移`(涉及 schema 变更必填) · `破坏性变更`(涉及破坏性改动必填) · `决策与偏离(如有)`——标题必须在场,不适用写 `N/A`
|
|
119
|
+
- 结构子段:`已知接受 + 理由` · `已知小问题`(挂在 6 维自查);`Schema Diff` · `迁移文件` · `执行状态` · `提醒`(挂在数据库迁移);`判定命中` · `引用图` · `反问用户结果` · `回归测试覆盖`(挂在破坏性变更)
|
|
120
|
+
- 增量段(2):`自检方法`(整段,必填,紧随 `越界检查` 或文末) · `LESSONS 扫描`(整段,必填,紧随 `自检方法`)——两段都只按位置校验,存在性由执行/委托出口门禁消费
|
|
121
|
+
|
|
122
|
+
### TASK — `flow-kit/templates/TASK.md`
|
|
123
|
+
|
|
124
|
+
- 标题形态:`# TASK: <change 标题>`
|
|
125
|
+
- 首部字段:Change ID / 关联
|
|
126
|
+
- 无条件段(5):`波次划分` · `任务清单` · `状态字段说明` · `阻塞日志` · `Fix 任务(来自 REVIEW / INTEGRATION)`
|
|
127
|
+
- 条件段:无
|
|
128
|
+
- 结构子段:无(任务块的 7 字段是元素级结构,不在段层登记)
|
|
129
|
+
- 增量段:无
|
|
130
|
+
- 说明:段正文本身就可能是成品形态(空阻塞日志 / 表格说明),照抄不算未填。
|
|
131
|
+
|
|
132
|
+
### TEST — `flow-kit/templates/TEST.md`
|
|
133
|
+
|
|
134
|
+
- 标题形态:`# TEST: <change 标题>`
|
|
135
|
+
- 首部字段:Change ID / 关联 / 项目类型
|
|
136
|
+
- 无条件段(4):`0. 本次测试范围声明(5 轮金字塔)` · `第 1 轮 · 功能测试` · `新增测试登记` · `回归保护`
|
|
137
|
+
- 条件段(4):`第 2 轮 · 性能测试` · `第 3 轮 · 安全测试` · `第 4 轮 · 兼容性测试` · `第 5 轮 · 可观测性验证`——标题必须在场,不适用写 `N/A`
|
|
138
|
+
- 结构子段:`1.1 测试矩阵` · `1.2 UAT 脚本` · `1.3 覆盖率` · `1.4 边界 / 错误路径用例` · `1.5 测试质量自检` · `1.6 测试质量记事`;`2.1` ~ `2.4`;`3.1` ~ `3.4`;`4.1` ~ `4.4`;`5.1` ~ `5.4`
|
|
139
|
+
- 增量段(1):`验证命令`(整段,必填,位置不限但**标题后必须紧跟代码块**)——验证出口真实执行其中第一条命令并计数失败
|
|
140
|
+
|
|
141
|
+
### UI-DESIGN — `flow-kit/templates/UI-DESIGN.md`
|
|
142
|
+
|
|
143
|
+
- 标题形态:`# UI Design: <项目名>`
|
|
144
|
+
- 首部:frontmatter 顶层键 name / description / colors / typography / spacing / rounded / motion / shadow(行级解析,不引入 YAML 依赖)
|
|
145
|
+
- 无条件段(10):`1. 美学北极星` · `2. 4 个决策问题` · `3. 颜色系统` · `4. 字体系统` · `5. 间距 & 圆角 & 动效` · `6. 关键组件规约` · `7. Do's and Don'ts` · `8. 占位符策略` · `9. 反 AI-slop 自检结果` · `10. 触发任务`
|
|
146
|
+
- 可选段(1):`0. 视觉语汇对齐`(仅 brownfield 填;greenfield 可整段删除——这是模板允许删除的唯一段)
|
|
147
|
+
- 结构子段:`0.1` ~ `0.3`(挂在 0);`v0 确认摸路`(1);`Primary` / `Neutral` / `命名规则`(3);`层次表`(4);`Button (Primary)` / `Button (Secondary)` / `Input / Field` / `Card / Container` / `Navigation` / `Typography Hierarchy`(6);`Do` / `Don't`(7)
|
|
148
|
+
- 增量段:无
|
|
149
|
+
|
|
150
|
+
## 三、维护约定
|
|
151
|
+
|
|
152
|
+
- **改模板 ⇒ 同批改登记表**:段名、段序、结构子段、增量位置任一变化都要同步 `reference/artifact-templates.json`,并在发版期比对指纹(`templateCommit` + 每模板 sha256);本册同批更新。
|
|
153
|
+
- **不得另写段名清单**:门禁一律从登记表 + 模板派生骨架,代码与技能册都不再抄一份段名(抄一份就必然分叉)。
|
|
154
|
+
- **本册不是门禁**:它没有运行时消费方——判据落在引擎与登记表;本册只回答「这一段从哪来」。
|
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"templateCommit": "9b5dda7206ae841230f118348d660ad8d0ae2830",
|
|
4
|
+
"templateRoot": "flow-kit/templates",
|
|
5
|
+
"hashAlgorithm": "sha256",
|
|
6
|
+
"hashNormalization": "utf8 · 去 BOM · CRLF/CR 归一为 LF(行尾差异不应改变指纹)",
|
|
7
|
+
"semantics": {
|
|
8
|
+
"sections": "模板全部 H2 的结构登记。name 逐字取自模板标题行;conditional = 模板自身标注「条件适用 / 可整段 N/A / 如有」,标题必须在场;optional = 模板允许整段删除(当前仅 UI-DESIGN §0,greenfield 删)。",
|
|
9
|
+
"structureSubsections": "结构型 H3 的显式清单(模板里真有结构含义的子段)。示例条目(🔴 R<x> / 🔴 T<x> / ADR-NNN / AC-1 / L-001)一律不登记——它们是书写样例,不是骨架。parent = 所属 H2 的逐字标题。",
|
|
10
|
+
"increments": "flow-comet 在本仓追加的增量段(上游模板没有):kind=section 为整段,kind=marker 为段内条目级标记。position.mode:after-or-end(紧随 afterSection 或文末)/ end(文末)/ anywhere(位置不限,另有 constraint)/ within(写在 section 指定的段内)。required 表示内置节点必填。",
|
|
11
|
+
"titlePattern": "按标题行匹配的工整形态(大小写不敏感);titleForm 是模板里那行的字面形态,供报错文案使用。",
|
|
12
|
+
"headerFields": "首部 `- **字段**:` 键名清单(值非空才算填)。",
|
|
13
|
+
"frontmatterKeys": "YAML frontmatter 顶层键(仅 UI-DESIGN;行级解析,不引入 YAML 库)。",
|
|
14
|
+
"sha256": "模板文件按 hashNormalization 归一后的 sha256;与 templateCommit 一起构成锁定快照,发版期机检比对。"
|
|
15
|
+
},
|
|
16
|
+
"templates": {
|
|
17
|
+
"ARCHITECTURE": {
|
|
18
|
+
"file": "flow-kit/templates/ARCHITECTURE.md",
|
|
19
|
+
"titlePattern": "^#\\s*ARCHITECTURE\\b",
|
|
20
|
+
"titleForm": "# ARCHITECTURE — 项目级系统架构(活文档)",
|
|
21
|
+
"headerFields": ["维护者", "首次创建", "最近修订", "当前 ADR 编号最大值"],
|
|
22
|
+
"sections": [
|
|
23
|
+
{ "name": "1. 系统概览" },
|
|
24
|
+
{ "name": "2. 模块清单 + 边界" },
|
|
25
|
+
{ "name": "3. ADR 列表(Architecture Decision Records · 不可逆决策清单)" },
|
|
26
|
+
{ "name": "4. 跨模块契约" },
|
|
27
|
+
{ "name": "5. 扩展点(Where to plug in new things)" },
|
|
28
|
+
{ "name": "6. 容量 / 性能边界(Where things break)" },
|
|
29
|
+
{ "name": "7. 已知技术债 + 长期方向" },
|
|
30
|
+
{ "name": "8. 修订历史" }
|
|
31
|
+
],
|
|
32
|
+
"structureSubsections": [
|
|
33
|
+
{ "name": "1.1 一句话定位", "parent": "1. 系统概览" },
|
|
34
|
+
{ "name": "1.2 服务边界图", "parent": "1. 系统概览" },
|
|
35
|
+
{ "name": "1.3 关键非功能性指标(NFR 基线)", "parent": "1. 系统概览" },
|
|
36
|
+
{ "name": "2.1 模块表", "parent": "2. 模块清单 + 边界" },
|
|
37
|
+
{ "name": "2.2 模块依赖规则(hard rules)", "parent": "2. 模块清单 + 边界" },
|
|
38
|
+
{ "name": "4.1 公共 HTTP API", "parent": "4. 跨模块契约" },
|
|
39
|
+
{ "name": "4.2 事件总线", "parent": "4. 跨模块契约" },
|
|
40
|
+
{ "name": "4.3 数据库 schema(顶层关系,详细 schema 走 migrations)", "parent": "4. 跨模块契约" },
|
|
41
|
+
{ "name": "4.4 共享配置项", "parent": "4. 跨模块契约" }
|
|
42
|
+
],
|
|
43
|
+
"increments": [],
|
|
44
|
+
"sha256": "441567c3d1e8ff99842191c6191726ca88e0b6ac4585629b3dbe7d64ee6b30b7"
|
|
45
|
+
},
|
|
46
|
+
"CHANGE": {
|
|
47
|
+
"file": "flow-kit/templates/CHANGE.md",
|
|
48
|
+
"titlePattern": "^#\\s*CHANGE\\b",
|
|
49
|
+
"titleForm": "# CHANGE: <一句话标题>",
|
|
50
|
+
"headerFields": ["Change ID", "创建日期", "路径建议", "状态"],
|
|
51
|
+
"sections": [
|
|
52
|
+
{ "name": "Why(为什么做)" },
|
|
53
|
+
{ "name": "What(做什么)" },
|
|
54
|
+
{ "name": "视觉调性(前端项目必填,由 0-change 步骤 0.6 预选填入)", "conditional": true },
|
|
55
|
+
{ "name": "影响面" },
|
|
56
|
+
{ "name": "范围排除(这次不做)" },
|
|
57
|
+
{ "name": "验收线(粗粒度,不是 AC)" },
|
|
58
|
+
{ "name": "风险与未知" }
|
|
59
|
+
],
|
|
60
|
+
"structureSubsections": [],
|
|
61
|
+
"increments": [
|
|
62
|
+
{
|
|
63
|
+
"section": "架构层影响声明",
|
|
64
|
+
"kind": "section",
|
|
65
|
+
"required": false,
|
|
66
|
+
"position": { "mode": "end", "afterSection": "风险与未知" }
|
|
67
|
+
}
|
|
68
|
+
],
|
|
69
|
+
"sha256": "6be07ca0d639bd06c48db556a1072fa94f161a2c7c1b7fa01343fb561bd885d0"
|
|
70
|
+
},
|
|
71
|
+
"CONTEXT": {
|
|
72
|
+
"file": "flow-kit/templates/CONTEXT.md",
|
|
73
|
+
"titlePattern": "^#\\s*CONTEXT\\b",
|
|
74
|
+
"titleForm": "# CONTEXT — 项目共享上下文",
|
|
75
|
+
"headerFields": [],
|
|
76
|
+
"sections": [
|
|
77
|
+
{ "name": "项目概要" },
|
|
78
|
+
{ "name": "技术栈(团队级默认 / 已锁定)" },
|
|
79
|
+
{ "name": "域语言(术语表)" },
|
|
80
|
+
{ "name": "已锁决策" },
|
|
81
|
+
{ "name": "默认偏好(AI 在缺省时按此决策)" },
|
|
82
|
+
{ "name": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
83
|
+
{ "name": "intel-scan 元数据" }
|
|
84
|
+
],
|
|
85
|
+
"structureSubsections": [
|
|
86
|
+
{ "name": "HTTP 客户端", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
87
|
+
{ "name": "数据库访问", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
88
|
+
{ "name": "状态管理", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
89
|
+
{ "name": "工具函数(utils / helpers)", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
90
|
+
{ "name": "自定义 hooks(前端)", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
91
|
+
{ "name": "错误处理", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
92
|
+
{ "name": "Schema / 迁移", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
93
|
+
{ "name": "命名约定", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
94
|
+
{ "name": "禁动清单(AI 不许\"顺手\"碰)", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" },
|
|
95
|
+
{ "name": "技术债(来自 M-health · 给 AI 在 2-design / 4-dev 时参考,别再加同类债)", "parent": "既有抽象索引(来自 I-intel-scan · 防 AI 重复实现 · B5 老项目护栏)" }
|
|
96
|
+
],
|
|
97
|
+
"increments": [],
|
|
98
|
+
"sha256": "c9a99f69cbae55b1d43c0691b1478bc851035588342f2df744b878023e4496e4"
|
|
99
|
+
},
|
|
100
|
+
"DESIGN": {
|
|
101
|
+
"file": "flow-kit/templates/DESIGN.md",
|
|
102
|
+
"titlePattern": "^#\\s*DESIGN\\b",
|
|
103
|
+
"titleForm": "# DESIGN: <change 标题>",
|
|
104
|
+
"headerFields": ["Change ID", "关联", "作者"],
|
|
105
|
+
"sections": [
|
|
106
|
+
{ "name": "0. 技术栈选定" },
|
|
107
|
+
{ "name": "0.5 既有架构对齐(brownfield 必填 · 来自 2-design 步骤 0.5 / B2 老项目护栏)", "conditional": true },
|
|
108
|
+
{ "name": "1. 决策清单" },
|
|
109
|
+
{ "name": "2. 数据流 / 架构图" },
|
|
110
|
+
{ "name": "3. 关键状态机(如有)", "conditional": true },
|
|
111
|
+
{ "name": "4. ADR 索引", "conditional": true },
|
|
112
|
+
{ "name": "5. 风险" },
|
|
113
|
+
{ "name": "6. 不在范围" },
|
|
114
|
+
{ "name": "9. 架构沉淀建议(本 change 完成后供 `A-evolve` 同步用 · 软约束)", "conditional": true }
|
|
115
|
+
],
|
|
116
|
+
"structureSubsections": [
|
|
117
|
+
{ "name": "0.5.1 本次 change 触碰的既有模块", "parent": "0.5 既有架构对齐(brownfield 必填 · 来自 2-design 步骤 0.5 / B2 老项目护栏)" },
|
|
118
|
+
{ "name": "0.5.2 既有抽象沿用对照表", "parent": "0.5 既有架构对齐(brownfield 必填 · 来自 2-design 步骤 0.5 / B2 老项目护栏)" },
|
|
119
|
+
{ "name": "0.5.3 沿用模式 vs 引入新模式", "parent": "0.5 既有架构对齐(brownfield 必填 · 来自 2-design 步骤 0.5 / B2 老项目护栏)" },
|
|
120
|
+
{ "name": "9.1 新增的可复用抽象(建议 append 到 CONTEXT 「既有抽象索引」段)", "parent": "9. 架构沉淀建议(本 change 完成后供 `A-evolve` 同步用 · 软约束)" },
|
|
121
|
+
{ "name": "9.2 新增 / 改变的项目级技术决策(建议 append 到 CONTEXT「已锁技术决策」段 · 或将来升 ARCHITECTURE.md「ADR 列表」)", "parent": "9. 架构沉淀建议(本 change 完成后供 `A-evolve` 同步用 · 软约束)" },
|
|
122
|
+
{ "name": "9.3 新增 / 修改的跨模块契约(API / Schema / 事件总线)(建议 append 到 CONTEXT「跨模块契约」段)", "parent": "9. 架构沉淀建议(本 change 完成后供 `A-evolve` 同步用 · 软约束)" },
|
|
123
|
+
{ "name": "9.4 新增 / 升级的依赖(建议 append 到 CONTEXT「技术栈」段)", "parent": "9. 架构沉淀建议(本 change 完成后供 `A-evolve` 同步用 · 软约束)" },
|
|
124
|
+
{ "name": "9.5 禁动清单变化(建议 patch CONTEXT「禁动清单」段)", "parent": "9. 架构沉淀建议(本 change 完成后供 `A-evolve` 同步用 · 软约束)" }
|
|
125
|
+
],
|
|
126
|
+
"increments": [],
|
|
127
|
+
"sha256": "d81cf5d13cb85d0919da4d02811f2384b4ea4b2c798245102254d64860c2216f"
|
|
128
|
+
},
|
|
129
|
+
"LESSONS": {
|
|
130
|
+
"file": "flow-kit/templates/LESSONS.md",
|
|
131
|
+
"titlePattern": "^#\\s*LESSONS\\b",
|
|
132
|
+
"titleForm": "# LESSONS — 跨任务失败知识库",
|
|
133
|
+
"headerFields": [],
|
|
134
|
+
"sections": [
|
|
135
|
+
{ "name": "标签索引" },
|
|
136
|
+
{ "name": "使用方式" },
|
|
137
|
+
{ "name": "条目格式(复制此模板新增)" },
|
|
138
|
+
{ "name": "提名条件(满足任一即建议入库)" },
|
|
139
|
+
{ "name": "复核与剪枝(每个 ARCHIVE 步骤顺手做)" },
|
|
140
|
+
{ "name": "条目区(实际项目里把下面的示例替换成你的真实条目)", "conditional": true }
|
|
141
|
+
],
|
|
142
|
+
"structureSubsections": [
|
|
143
|
+
{ "name": "写代码前(DEV 阶段,R1.8)", "parent": "使用方式" },
|
|
144
|
+
{ "name": "任务完成后(INTEGRATION ARCHIVE 步骤)", "parent": "使用方式" }
|
|
145
|
+
],
|
|
146
|
+
"increments": [],
|
|
147
|
+
"sha256": "1417667297b05088101f9c280e092b16dd49d627d7134aa2f5e85755a6992327"
|
|
148
|
+
},
|
|
149
|
+
"PROGRESS": {
|
|
150
|
+
"file": "flow-kit/templates/PROGRESS.md",
|
|
151
|
+
"titlePattern": "^#\\s*PROGRESS\\b",
|
|
152
|
+
"titleForm": "# PROGRESS: <T01 - 任务名>",
|
|
153
|
+
"headerFields": ["Change ID", "Task ID", "暂停时间", "触发清窗的信号"],
|
|
154
|
+
"sections": [
|
|
155
|
+
{ "name": "已完成的子步骤" },
|
|
156
|
+
{ "name": "当前正在做(清窗那一刻的状态)" },
|
|
157
|
+
{ "name": "已排除的方案(反重复关键)" },
|
|
158
|
+
{ "name": "待确认的假设" },
|
|
159
|
+
{ "name": "临时记下的线索 / 文件位置" },
|
|
160
|
+
{ "name": "恢复指引(给下一会话的 AI)" }
|
|
161
|
+
],
|
|
162
|
+
"structureSubsections": [],
|
|
163
|
+
"increments": [],
|
|
164
|
+
"sha256": "6726107309553ee567c71982cdd4a78a025abe1da9a9b174ed2701cb4c713eb8"
|
|
165
|
+
},
|
|
166
|
+
"REQUIREMENT": {
|
|
167
|
+
"file": "flow-kit/templates/REQUIREMENT.md",
|
|
168
|
+
"titlePattern": "^#\\s*REQUIREMENT\\b",
|
|
169
|
+
"titleForm": "# REQUIREMENT: <change 标题>",
|
|
170
|
+
"headerFields": ["Change ID", "关联"],
|
|
171
|
+
"sections": [
|
|
172
|
+
{ "name": "用户故事" },
|
|
173
|
+
{ "name": "验收准则(AC)" },
|
|
174
|
+
{ "name": "范围切分" },
|
|
175
|
+
{ "name": "非功能性需求" },
|
|
176
|
+
{ "name": "依赖与假设" }
|
|
177
|
+
],
|
|
178
|
+
"structureSubsections": [
|
|
179
|
+
{ "name": "v1(本次必做)", "parent": "范围切分" },
|
|
180
|
+
{ "name": "v2(下一轮考虑,不本次)", "parent": "范围切分" },
|
|
181
|
+
{ "name": "out(永远不做)", "parent": "范围切分" }
|
|
182
|
+
],
|
|
183
|
+
"increments": [],
|
|
184
|
+
"sha256": "a8f662f5711b19d3af5eb7a019f3fae8f55499319be6d97da6ccb935dba59213"
|
|
185
|
+
},
|
|
186
|
+
"REVIEW": {
|
|
187
|
+
"file": "flow-kit/templates/REVIEW.md",
|
|
188
|
+
"titlePattern": "^#\\s*REVIEW\\b",
|
|
189
|
+
"titleForm": "# REVIEW: <change 标题>",
|
|
190
|
+
"headerFields": ["Change ID", "审查时间", "审查者", "总体结论"],
|
|
191
|
+
"sections": [
|
|
192
|
+
{ "name": "第一轮 · Spec 合规审查" },
|
|
193
|
+
{ "name": "第二轮 · 代码质量审查(6 维衰退风险)" },
|
|
194
|
+
{ "name": "第三轮 · UI 视觉审查(仅前端 · 见 6-review.md 第 3 节)", "conditional": true },
|
|
195
|
+
{ "name": "第四轮 · 补充审查(按触发条件)", "conditional": true },
|
|
196
|
+
{ "name": "总结" }
|
|
197
|
+
],
|
|
198
|
+
"structureSubsections": [
|
|
199
|
+
{ "name": "2.0 TEST.md 5 轮金字塔完整性", "parent": "第二轮 · 代码质量审查(6 维衰退风险)" },
|
|
200
|
+
{ "name": "2.1 6 维诊断 · 严重度统计", "parent": "第二轮 · 代码质量审查(6 维衰退风险)" },
|
|
201
|
+
{ "name": "2.2 6 维诊断 · 详细发现(4 要素 · 来自 brooks-lint 输出 / 内置回退)", "parent": "第二轮 · 代码质量审查(6 维衰退风险)" },
|
|
202
|
+
{ "name": "2.3 架构依赖图(大型 change · 来自 /brooks-audit)", "parent": "第二轮 · 代码质量审查(6 维衰退风险)" },
|
|
203
|
+
{ "name": "4.1 技术债评估(来自 /brooks-debt,仅里程碑 / 重构)", "parent": "第四轮 · 补充审查(按触发条件)" },
|
|
204
|
+
{ "name": "4.2 跨模型分歧", "parent": "第四轮 · 补充审查(按触发条件)" }
|
|
205
|
+
],
|
|
206
|
+
"increments": [
|
|
207
|
+
{
|
|
208
|
+
"section": "处置标记",
|
|
209
|
+
"kind": "marker",
|
|
210
|
+
"required": true,
|
|
211
|
+
"position": {
|
|
212
|
+
"mode": "within",
|
|
213
|
+
"section": "2.2 6 维诊断 · 详细发现(4 要素 · 来自 brooks-lint 输出 / 内置回退)"
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
],
|
|
217
|
+
"sha256": "929305dc9f087ac469587ad01149eeae9329599103ccaeefb23bb59da9ce5678"
|
|
218
|
+
},
|
|
219
|
+
"STATE": {
|
|
220
|
+
"file": "flow-kit/templates/STATE.md",
|
|
221
|
+
"titlePattern": "^#\\s*STATE\\b",
|
|
222
|
+
"titleForm": "# STATE — 跨会话项目状态",
|
|
223
|
+
"headerFields": [],
|
|
224
|
+
"sections": [
|
|
225
|
+
{ "name": "当前位置" },
|
|
226
|
+
{ "name": "阻塞与待决策" },
|
|
227
|
+
{ "name": "决策日志(最近 10 条,倒序)" },
|
|
228
|
+
{ "name": "已归档 Changes(最近 5 个,倒序)" },
|
|
229
|
+
{ "name": "横向命令状态(GO.md / 各 prompt 会读这里决定要不要主动提示)" },
|
|
230
|
+
{ "name": "健康检查(AI 每次会话开始前自检)" }
|
|
231
|
+
],
|
|
232
|
+
"structureSubsections": [],
|
|
233
|
+
"increments": [],
|
|
234
|
+
"sha256": "71d23fe1b21c11bd6e9fd701eb4494b97b816368f91462fa3c28ad0f5a5ce20f"
|
|
235
|
+
},
|
|
236
|
+
"SUMMARY": {
|
|
237
|
+
"file": "flow-kit/templates/SUMMARY.md",
|
|
238
|
+
"titlePattern": "^#\\s*SUMMARY\\b",
|
|
239
|
+
"titleForm": "# SUMMARY: <T01 - 任务名>",
|
|
240
|
+
"headerFields": ["Change ID", "Task ID", "完成时间", "AI 角色"],
|
|
241
|
+
"sections": [
|
|
242
|
+
{ "name": "做了什么(一段话)" },
|
|
243
|
+
{ "name": "改动文件" },
|
|
244
|
+
{ "name": "verify 输出(必填)" },
|
|
245
|
+
{ "name": "6 维自查(生产代码改动必填 · 来自 4-dev 步骤 4)" },
|
|
246
|
+
{ "name": "数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)", "conditional": true },
|
|
247
|
+
{ "name": "越界检查(必填 · 来自 4-dev 步骤 5 / R6.5 / B3 老项目护栏)" },
|
|
248
|
+
{ "name": "破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)", "conditional": true },
|
|
249
|
+
{ "name": "决策与偏离(如有)", "conditional": true },
|
|
250
|
+
{ "name": "是否触发新工作" },
|
|
251
|
+
{ "name": "完成判定" }
|
|
252
|
+
],
|
|
253
|
+
"structureSubsections": [
|
|
254
|
+
{ "name": "已知接受 + 理由(🟡 Major 项不修的)", "parent": "6 维自查(生产代码改动必填 · 来自 4-dev 步骤 4)" },
|
|
255
|
+
{ "name": "已知小问题(🟢 Minor 项可省的)", "parent": "6 维自查(生产代码改动必填 · 来自 4-dev 步骤 4)" },
|
|
256
|
+
{ "name": "Schema Diff", "parent": "数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)" },
|
|
257
|
+
{ "name": "迁移文件", "parent": "数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)" },
|
|
258
|
+
{ "name": "执行状态", "parent": "数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)" },
|
|
259
|
+
{ "name": "提醒(用户选\"只生成 SQL\" 或未检测到凭据时必填)", "parent": "数据库迁移(涉及 schema 变更必填 · 来自 4-dev 步骤 1.7 / R4.5)" },
|
|
260
|
+
{ "name": "判定命中", "parent": "破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)" },
|
|
261
|
+
{ "name": "引用图(必填 · grep 结果)", "parent": "破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)" },
|
|
262
|
+
{ "name": "反问用户结果", "parent": "破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)" },
|
|
263
|
+
{ "name": "回归测试覆盖", "parent": "破坏性变更(涉及破坏性改动必填 · 来自 4-dev 步骤 1.8 / R4.6 / B4 老项目护栏)" }
|
|
264
|
+
],
|
|
265
|
+
"increments": [
|
|
266
|
+
{
|
|
267
|
+
"section": "自检方法",
|
|
268
|
+
"kind": "section",
|
|
269
|
+
"required": true,
|
|
270
|
+
"position": { "mode": "after-or-end", "afterSection": "越界检查(必填 · 来自 4-dev 步骤 5 / R6.5 / B3 老项目护栏)" }
|
|
271
|
+
},
|
|
272
|
+
{
|
|
273
|
+
"section": "LESSONS 扫描",
|
|
274
|
+
"kind": "section",
|
|
275
|
+
"required": true,
|
|
276
|
+
"position": { "mode": "after-or-end", "afterSection": "自检方法" }
|
|
277
|
+
}
|
|
278
|
+
],
|
|
279
|
+
"sha256": "baf611a42e49772cf57e924d2c9fa6a793dfc85cef5a4946b74a7bb2c6923277"
|
|
280
|
+
},
|
|
281
|
+
"TASK": {
|
|
282
|
+
"file": "flow-kit/templates/TASK.md",
|
|
283
|
+
"titlePattern": "^#\\s*TASK\\b",
|
|
284
|
+
"titleForm": "# TASK: <change 标题>",
|
|
285
|
+
"headerFields": ["Change ID", "关联"],
|
|
286
|
+
"sections": [
|
|
287
|
+
{ "name": "波次划分" },
|
|
288
|
+
{ "name": "任务清单" },
|
|
289
|
+
{ "name": "状态字段说明" },
|
|
290
|
+
{ "name": "阻塞日志" },
|
|
291
|
+
{ "name": "Fix 任务(来自 REVIEW / INTEGRATION)" }
|
|
292
|
+
],
|
|
293
|
+
"structureSubsections": [],
|
|
294
|
+
"increments": [],
|
|
295
|
+
"sha256": "2638a2c247ede93c10ea57f9a30e56168e1e44e9f64ef69b03573d4c3bf0b7de"
|
|
296
|
+
},
|
|
297
|
+
"TEST": {
|
|
298
|
+
"file": "flow-kit/templates/TEST.md",
|
|
299
|
+
"titlePattern": "^#\\s*TEST\\b",
|
|
300
|
+
"titleForm": "# TEST: <change 标题>",
|
|
301
|
+
"headerFields": ["Change ID", "关联", "项目类型"],
|
|
302
|
+
"sections": [
|
|
303
|
+
{ "name": "0. 本次测试范围声明(5 轮金字塔)" },
|
|
304
|
+
{ "name": "第 1 轮 · 功能测试" },
|
|
305
|
+
{ "name": "第 2 轮 · 性能测试", "conditional": true },
|
|
306
|
+
{ "name": "第 3 轮 · 安全测试", "conditional": true },
|
|
307
|
+
{ "name": "第 4 轮 · 兼容性测试", "conditional": true },
|
|
308
|
+
{ "name": "第 5 轮 · 可观测性验证", "conditional": true },
|
|
309
|
+
{ "name": "新增测试登记" },
|
|
310
|
+
{ "name": "回归保护" }
|
|
311
|
+
],
|
|
312
|
+
"structureSubsections": [
|
|
313
|
+
{ "name": "1.1 测试矩阵(AC → 用例)", "parent": "第 1 轮 · 功能测试" },
|
|
314
|
+
{ "name": "1.2 UAT 脚本", "parent": "第 1 轮 · 功能测试" },
|
|
315
|
+
{ "name": "1.3 覆盖率", "parent": "第 1 轮 · 功能测试" },
|
|
316
|
+
{ "name": "1.4 边界 / 错误路径用例", "parent": "第 1 轮 · 功能测试" },
|
|
317
|
+
{ "name": "1.5 测试质量自检(6 维测试衰退风险)", "parent": "第 1 轮 · 功能测试" },
|
|
318
|
+
{ "name": "1.6 测试质量记事(backlog)", "parent": "第 1 轮 · 功能测试" },
|
|
319
|
+
{ "name": "2.1 性能预算(来自 REQUIREMENT.md 非功能性需求)", "parent": "第 2 轮 · 性能测试" },
|
|
320
|
+
{ "name": "2.2 实测结果", "parent": "第 2 轮 · 性能测试" },
|
|
321
|
+
{ "name": "2.3 工具输出", "parent": "第 2 轮 · 性能测试" },
|
|
322
|
+
{ "name": "2.4 退步项处理", "parent": "第 2 轮 · 性能测试" },
|
|
323
|
+
{ "name": "3.1 依赖漏洞", "parent": "第 3 轮 · 安全测试" },
|
|
324
|
+
{ "name": "3.2 秘钥扫描", "parent": "第 3 轮 · 安全测试" },
|
|
325
|
+
{ "name": "3.3 SAST", "parent": "第 3 轮 · 安全测试" },
|
|
326
|
+
{ "name": "3.4 OWASP Top 10", "parent": "第 3 轮 · 安全测试" },
|
|
327
|
+
{ "name": "4.1 跨浏览器(Web)", "parent": "第 4 轮 · 兼容性测试" },
|
|
328
|
+
{ "name": "4.2 视口", "parent": "第 4 轮 · 兼容性测试" },
|
|
329
|
+
{ "name": "4.3 数据迁移(涉及 schema 变更必填)", "parent": "第 4 轮 · 兼容性测试" },
|
|
330
|
+
{ "name": "4.4 跨版本", "parent": "第 4 轮 · 兼容性测试" },
|
|
331
|
+
{ "name": "5.1 日志", "parent": "第 5 轮 · 可观测性验证" },
|
|
332
|
+
{ "name": "5.2 指标", "parent": "第 5 轮 · 可观测性验证" },
|
|
333
|
+
{ "name": "5.3 链路追踪", "parent": "第 5 轮 · 可观测性验证" },
|
|
334
|
+
{ "name": "5.4 告警 + 健康检查", "parent": "第 5 轮 · 可观测性验证" }
|
|
335
|
+
],
|
|
336
|
+
"increments": [
|
|
337
|
+
{
|
|
338
|
+
"section": "验证命令",
|
|
339
|
+
"kind": "section",
|
|
340
|
+
"required": true,
|
|
341
|
+
"position": { "mode": "anywhere", "constraint": "code-block-follows" }
|
|
342
|
+
}
|
|
343
|
+
],
|
|
344
|
+
"sha256": "98f5fc15ca29ad7e300556e58376a25ace2a32f74cad86c4515e3b809221e2e0"
|
|
345
|
+
},
|
|
346
|
+
"UI-DESIGN": {
|
|
347
|
+
"file": "flow-kit/templates/UI-DESIGN.md",
|
|
348
|
+
"titlePattern": "^#\\s*UI\\s+Design\\b",
|
|
349
|
+
"titleForm": "# UI Design: <项目名>",
|
|
350
|
+
"headerFields": [],
|
|
351
|
+
"frontmatterKeys": ["name", "description", "colors", "typography", "spacing", "rounded", "motion", "shadow"],
|
|
352
|
+
"sections": [
|
|
353
|
+
{ "name": "0. 视觉语汇对齐(仅 brownfield 填 · greenfield 删掉此段)", "optional": true },
|
|
354
|
+
{ "name": "1. 美学北极星" },
|
|
355
|
+
{ "name": "2. 4 个决策问题(开工前回答)" },
|
|
356
|
+
{ "name": "3. 颜色系统" },
|
|
357
|
+
{ "name": "4. 字体系统" },
|
|
358
|
+
{ "name": "5. 间距 & 圆角 & 动效" },
|
|
359
|
+
{ "name": "6. 关键组件规约" },
|
|
360
|
+
{ "name": "7. Do's and Don'ts(本项目特定)" },
|
|
361
|
+
{ "name": "8. 占位符策略(反伪造 · 对应 R8.9)" },
|
|
362
|
+
{ "name": "9. 反 AI-slop 自检结果" },
|
|
363
|
+
{ "name": "10. 触发任务" }
|
|
364
|
+
],
|
|
365
|
+
"structureSubsections": [
|
|
366
|
+
{ "name": "0.1 观察报告(代码为源)", "parent": "0. 视觉语汇对齐(仅 brownfield 填 · greenfield 删掉此段)" },
|
|
367
|
+
{ "name": "0.2 用户校准结论", "parent": "0. 视觉语汇对齐(仅 brownfield 填 · greenfield 删掉此段)" },
|
|
368
|
+
{ "name": "0.3 应用策略", "parent": "0. 视觉语汇对齐(仅 brownfield 填 · greenfield 删掉此段)" },
|
|
369
|
+
{ "name": "v0 确认摸路", "parent": "1. 美学北极星" },
|
|
370
|
+
{ "name": "Primary", "parent": "3. 颜色系统" },
|
|
371
|
+
{ "name": "Neutral", "parent": "3. 颜色系统" },
|
|
372
|
+
{ "name": "命名规则", "parent": "3. 颜色系统" },
|
|
373
|
+
{ "name": "层次表", "parent": "4. 字体系统" },
|
|
374
|
+
{ "name": "Button (Primary)", "parent": "6. 关键组件规约" },
|
|
375
|
+
{ "name": "Button (Secondary)", "parent": "6. 关键组件规约" },
|
|
376
|
+
{ "name": "Input / Field", "parent": "6. 关键组件规约" },
|
|
377
|
+
{ "name": "Card / Container", "parent": "6. 关键组件规约" },
|
|
378
|
+
{ "name": "Navigation", "parent": "6. 关键组件规约" },
|
|
379
|
+
{ "name": "Typography Hierarchy", "parent": "6. 关键组件规约" },
|
|
380
|
+
{ "name": "Do", "parent": "7. Do's and Don'ts(本项目特定)" },
|
|
381
|
+
{ "name": "Don't(除了通用 anti-patterns,本项目额外禁止)", "parent": "7. Do's and Don'ts(本项目特定)" }
|
|
382
|
+
],
|
|
383
|
+
"increments": [],
|
|
384
|
+
"sha256": "5e8a7cfea23a4d5690849c8e816b8635eb8d7ab9bba8a2c41689f96cddffc6f5"
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
}
|