flow-comet 1.6.4 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +36 -6
- 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/commit-discipline.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +29 -4
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +174 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +17 -95
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +28 -4
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +136 -19
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +54 -18
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +25 -10
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +4 -2
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +21 -13
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +163 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +448 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +396 -27
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +1035 -172
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +129 -98
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +797 -232
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +91 -22
- package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +69 -13
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +454 -135
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +66 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +109 -13
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +55 -2
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +149 -34
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +79 -9
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +78 -8
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +60 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +167 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +341 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +287 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1454 -16
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1202 -8
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1205 -77
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +753 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +52 -11
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +582 -3
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +9 -1
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +5 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +22 -6
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +2 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +18 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +4100 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +6 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +203 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +312 -63
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
- 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 +42 -15
- 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 +21 -10
- package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-review/SKILL.md +33 -18
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +44 -16
- package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
- 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 +3 -3
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +2 -2
- package/scripts/lib/installer-flowkit.mjs +43 -3
|
@@ -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
|
+
}
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
五要素(缺一不可):
|
|
13
13
|
|
|
14
14
|
1. **`git add -- <自己字面路径>`**:逐条字面路径(取自本任务 `write_files`),禁用 `.` / `-A` / `-u` 等宽泛形态。
|
|
15
|
-
2. **`git commit --
|
|
15
|
+
2. **`git commit -m "<消息>" -- <同一路径>`**:消息(含正文尾注 `-m "Task: <id>"`)写在 `--` **之前**,pathspec 写在 `--` 之后——提交以 pathspec 限定范围,保证提交只含自己的文件;路径集与上一步**逐字一致**。消息若落到 `--` 之后(`git commit -- <路径> -m "<消息>"`),`-m` 会被当成 pathspec、提交直接失败(退出码 1)。
|
|
16
16
|
3. **锁失败重试**:并发提交会撞 `index.lock` / `cannot lock ref`——**失败即重试**(临时仓真并发实测:20 提交 / 25 次锁失败全部重试成功);不得因锁失败改用宽泛命令。
|
|
17
17
|
4. **禁裸 `add` / `commit -a` / `stash` / `clean` / `reset`**:无 pathspec 的 `git add`、`git commit -a`、`git stash`、`git clean`、`git reset` 一律禁止——它们作用于整个共享工作区。
|
|
18
18
|
5. **为什么**:并发写者共享**同一个索引与工作树**——宽泛命令存在**并发索引竞态**:一方 `add -A` 会把另一方的半成品纳入自己的提交(串味 / 多文件提交);`stash` / `clean` / `reset` 更会直接破坏同伴的未提交工作。
|
|
@@ -107,15 +107,38 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
|
|
|
107
107
|
**节点技能两层加载模型(入口层 · 双步硬规则)**:路由到节点后,以下两步**都不可跳过**:
|
|
108
108
|
|
|
109
109
|
1. **用 Skill 工具加载该节点的 Implementation 技能**(见下方 Skill Bindings 表 Implementation 列,如 execute → flow-comet-execute)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让该 skill 的指令生效的是 Skill 工具把它注入本次会话。
|
|
110
|
-
2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation
|
|
110
|
+
2. 随后按该节点 SKILL 的 Required Skill Calls,用 Skill 工具加载协议技能(与 Implementation 同名的条目已随路由加载,无需重复加载),加载完成后**立即**声明「加载了哪个技能、按哪份协议工作」。**一个节点该读的协议常常不止一份**(open 是 `0-change.md` + `1-requirement.md`,review 是 `6-review.md` + `5-test.md`)——**一份命令可以给多个 `--prompt`**,`skill-load` 会把它们**全部**记进同一个标记的 `protocols` 里,不是只留第一个:
|
|
111
111
|
|
|
112
112
|
```bash
|
|
113
|
-
|
|
113
|
+
# 单份协议(plan)
|
|
114
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load plan flow-comet-task --prompt flow-kit/prompts/3-task.md --templates TASK.md
|
|
115
|
+
|
|
116
|
+
# 多份协议(open):一条命令两个 --prompt,两份都记进标记
|
|
117
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-change --prompt flow-kit/prompts/0-change.md --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
|
|
118
|
+
|
|
119
|
+
# 同一节点的第二个 guarded 必需技能(open = change + requirement):每个必需技能各一条,
|
|
120
|
+
# 每条都带该节点全部 --prompt 与模板全清单——一条命令只写一个技能标记
|
|
121
|
+
node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load open flow-comet-requirement --prompt flow-kit/prompts/0-change.md --prompt flow-kit/prompts/1-requirement.md --templates CHANGE.md,REQUIREMENT.md
|
|
114
122
|
```
|
|
115
123
|
|
|
124
|
+
> **分条等价**:按协议文件分几条命令声明,与合并成一条等价——出口判据按节点汇总,只问「该读的这几份是否都被声明过」,不要求与技能一一对应。
|
|
125
|
+
|
|
126
|
+
> **`--templates` 是内置节点的必填声明**(每个标记各写全清单):open → `CHANGE.md,REQUIREMENT.md` · design → `DESIGN.md`(前端可加 `UI-DESIGN.md`)· plan → `TASK.md` · execute / subagent-execute → `SUMMARY.md` · review → `REVIEW.md,TEST.md` · verify / archive 为零模板节点,**省略该参数**。逐节点示例命令见各节点册的「加载声明」小节。
|
|
127
|
+
|
|
128
|
+
> **加载链的两条指针**:节点入口**先**打印 `READ PROMPT:`(指向 `flow-kit/prompts/<阶段>.md`——这一步怎么做),**再**打印 `READ TEMPLATE:`(指向 `flow-kit/templates/<DOC>.md`——产出长什么样),**有模板的节点两行都要读**;零模板节点(verify / archive)只有 `READ PROMPT:`。design 的**前端** change 还会多打印一行 `READ PROMPT(条件提示词): …2a-ui-design.md…`(按 `frontendCriterion` 判定;非前端不打印)。`--prompt` 必须是该节点的协议文件(以入口打印的 `READ PROMPT:` 行为准);落在节点协议面外的路径会在下一次入口被拦下(BLOCKED,逐条点名)并给出重声明命令——**入口只判「写下的每条声明对不对」,不判「该写的都写了没有」**:该节点该读却还没声明的那几份由出口的声明门逐份点名(见下方「exit 核对声明标记」)。重跑声明即可,不要手改标记。
|
|
129
|
+
|
|
116
130
|
> **跑声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。协议的引用示例:execute / subagent-execute 节点加载 flow-comet-dev 时用 `--prompt flow-kit/prompts/4-dev.md`(DEV 阶段协议),交付物按 `flow-kit/templates/SUMMARY.md` 模板填写并补写 `## 自检方法` 段。
|
|
117
131
|
|
|
118
|
-
节点退出(exit)与证据记录(record
|
|
132
|
+
节点退出(exit)与证据记录(record)会核对声明标记。
|
|
133
|
+
|
|
134
|
+
**exit 核对声明标记(覆盖判据)——判据是「全部覆盖」,不是「任一命中」**。两条同时成立才算声明齐备,缺任一条即判缺声明:
|
|
135
|
+
|
|
136
|
+
- **协议文件面**:该节点该读的**每一份**协议文件都要被声明过(open 两份、review 两份,其余节点一份)。多份可以在同一个标记的 `protocols` 里(一条命令给多个 `--prompt`),也可以分散在各技能自己的标记上——判据按节点汇总,只看这些文件是否都被声明过。
|
|
137
|
+
- **技能面**:协议 `requiredSkillCalls` 里**每个** `guarded` 必需技能,都要有一个属于它的标记(适用性门控的绑定除外——`flow-comet-ui-design` 只在**前端** change 上要求,见下方该段判据)。**`handoff-guarded` 不在判据内**——那是子代理侧义务,由 Return Contract 的 `required-skill:` 核对负责(让协调者声明一个它没加载的技能,只会造出另一类假声明)。
|
|
138
|
+
|
|
139
|
+
**缺声明时的恢复命令形态**(BLOCKED / WARN 报文给的就是这个形态):报文按**协议派生**给出该节点**每个** `guarded` 必需技能各一条命令(`node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <skill> …`)——每条把该节点该读的**全部**协议文件都带上(多个 `--prompt`)并带 `--templates <该节点模板全清单>`,三个面一次给全,照抄即通。旧口径的 `skill-load <node> <skill> --prompt <缺的那份协议文件>` 只补缺项、漏模板清单,照抄完同一 exit 会再被覆盖门与模板门各拦一次(已废弃;报文仍逐项点名缺哪份协议文件、哪个必需技能,命令本身则给全)。同一 `<node>-<skill>` 重跑会**覆写**该标记,补齐后重试 `exit <node>`。**分级**:新 change BLOCKED(强制全部覆盖)、旧 change 只 WARN(既有 change 不因判据变严卡死)。**兼容**:判据改为全部覆盖之前写下的标记只有一个 `protocol` 单值(历史形态甚至是完整路径),照样按 basename 计入覆盖;不可解析的标记**不计入**,并在报文里列名——不静默当通过。
|
|
140
|
+
|
|
141
|
+
声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:新 change 的 required 条目不再自动补写——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);声明标记自动补写仅对旧 change 兜底(按协议 requiredSkillCalls 代记,标记带 `auto: true`),手动声明仍推荐(如实记录加载动作与协议文件)。`flow-comet-ui-design` 与协议同等级(`guarded`)且**仅前端适用**:前端 change 须先加载并 `skill-load` 声明、record 载荷带 `required-skill:design.flow-comet-ui-design`(出口不再自动补写);非前端不加载不声明(出口输出可见的 `UI-DESIGN: skipped(非前端)`);旧 change 渐进,缺件仅 WARN。前端判据是**结构级**的:`CHANGE.md` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**——**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」不算标注,仍判前端。
|
|
119
142
|
|
|
120
143
|
> **侧命令**:`evolve`(架构沉淀同步)/ `health`(健康巡检)/ `context-scan`(上下文重扫)三条横向命令**不进 8 节点流程**——不路由、不 entry/exit、不写节点证据,一律由用户显式调用;触发词、命令面与落盘产物见主 `SKILL.md` 的「侧命令」小节(单一来源,本文不复述其命令表)。
|
|
121
144
|
|
|
@@ -168,9 +191,11 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs record <node-id> '{"su
|
|
|
168
191
|
|
|
169
192
|
All artifacts in `.specs/<change-id>/`. Cross-change files in `.specs/` (CONTEXT.md, LESSONS.md, CHANGELOG.md).
|
|
170
193
|
|
|
171
|
-
>
|
|
194
|
+
> **模板权威**:工件段形 = **上游模板 + 本仓登记的增量段**——`flow-kit/templates/**` 是唯一权威,增量段与条件段登记见 `reference/artifact-templates.json`。
|
|
172
195
|
> **archive 定位与读法**:见主 `SKILL.md` 的「Artifact Paths」小节(单一来源——「何时可读 / 读什么 / 不读什么」的三段判据只在那一处表达,本文不复述)。
|
|
173
196
|
|
|
197
|
+
> **要核对某工件的条件段 / 结构子段 / 增量段登记时,先读 `reference/artifact-template-overlay.md`**(逐工件的人类可读登记册;快照与指纹以登记表 JSON 为准)。
|
|
198
|
+
|
|
174
199
|
### Scripts
|
|
175
200
|
|
|
176
201
|
> **命令路径的平台化**:本文件命令统一为**权威源设计形态** `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 请用安装器。
|
|
@@ -38,6 +38,10 @@
|
|
|
38
38
|
"outputSchemas": [
|
|
39
39
|
"flowkit.intake.v1"
|
|
40
40
|
],
|
|
41
|
+
"templates": [
|
|
42
|
+
"CHANGE",
|
|
43
|
+
"REQUIREMENT"
|
|
44
|
+
],
|
|
41
45
|
"guardrails": [
|
|
42
46
|
{
|
|
43
47
|
"id": "intake-artifacts",
|
|
@@ -84,6 +88,9 @@
|
|
|
84
88
|
"outputSchemas": [
|
|
85
89
|
"flowkit.design.v1"
|
|
86
90
|
],
|
|
91
|
+
"templates": [
|
|
92
|
+
"DESIGN"
|
|
93
|
+
],
|
|
87
94
|
"guardrails": [
|
|
88
95
|
{
|
|
89
96
|
"id": "design-artifacts",
|
|
@@ -123,6 +130,9 @@
|
|
|
123
130
|
"outputSchemas": [
|
|
124
131
|
"flowkit.plan.v1"
|
|
125
132
|
],
|
|
133
|
+
"templates": [
|
|
134
|
+
"TASK"
|
|
135
|
+
],
|
|
126
136
|
"guardrails": [
|
|
127
137
|
{
|
|
128
138
|
"id": "plan-artifacts",
|
|
@@ -161,6 +171,9 @@
|
|
|
161
171
|
"outputSchemas": [
|
|
162
172
|
"flowkit.execution.v1"
|
|
163
173
|
],
|
|
174
|
+
"templates": [
|
|
175
|
+
"SUMMARY"
|
|
176
|
+
],
|
|
164
177
|
"guardrails": [
|
|
165
178
|
{
|
|
166
179
|
"id": "build-evidence",
|
|
@@ -199,6 +212,9 @@
|
|
|
199
212
|
"outputSchemas": [
|
|
200
213
|
"flowkit.handoff.v1"
|
|
201
214
|
],
|
|
215
|
+
"templates": [
|
|
216
|
+
"SUMMARY"
|
|
217
|
+
],
|
|
202
218
|
"guardrails": [
|
|
203
219
|
{
|
|
204
220
|
"id": "handoff-evidence",
|
|
@@ -244,6 +260,10 @@
|
|
|
244
260
|
"outputSchemas": [
|
|
245
261
|
"flowkit.review.v1"
|
|
246
262
|
],
|
|
263
|
+
"templates": [
|
|
264
|
+
"REVIEW",
|
|
265
|
+
"TEST"
|
|
266
|
+
],
|
|
247
267
|
"guardrails": [
|
|
248
268
|
{
|
|
249
269
|
"id": "review-evidence",
|
|
@@ -282,6 +302,7 @@
|
|
|
282
302
|
"outputSchemas": [
|
|
283
303
|
"flowkit.verify.v1"
|
|
284
304
|
],
|
|
305
|
+
"templates": [],
|
|
285
306
|
"guardrails": [
|
|
286
307
|
{
|
|
287
308
|
"id": "verify-evidence",
|
|
@@ -320,6 +341,7 @@
|
|
|
320
341
|
"outputSchemas": [
|
|
321
342
|
"flowkit.archive.v1"
|
|
322
343
|
],
|
|
344
|
+
"templates": [],
|
|
323
345
|
"guardrails": [
|
|
324
346
|
{
|
|
325
347
|
"id": "archive-evidence",
|