flow-comet 1.6.1 → 1.6.2
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/GUIDANCE.md +4 -2
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +31 -1
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +1 -1
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +129 -3
- package/.flow-comet/skills/flow-comet/scripts/context-scan.mjs +396 -0
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +778 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +2697 -12
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +664 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +55 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +602 -1
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +133 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +145 -1
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -3
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +153 -27
- package/.flow-comet/skills/flow-comet-change/SKILL.md +11 -1
- package/.flow-comet/skills/flow-comet-design/SKILL.md +4 -2
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +46 -11
- package/.flow-comet/skills/flow-comet-health/SKILL.md +57 -16
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +28 -3
- package/README.md +2 -2
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +2 -2
|
@@ -15,7 +15,7 @@ description: "flow-kit CHANGE 阶段协议:反问澄清、change-id 自动生
|
|
|
15
15
|
|
|
16
16
|
1. **自动生成 change-id**(kebab-case,2~4 词,检查 `.specs/<id>/` 不冲突)
|
|
17
17
|
2. **架构级变更检测**(步骤 0.4):命中 5 类信号时暂停,引导先跑 A-architect
|
|
18
|
-
3. **前端项目识别**(步骤 0.5
|
|
18
|
+
3. **前端项目识别**(步骤 0.5):关键词判定是否为前端项目;判定结果按「视觉调性段的标记约定」落盘(非前端以**结构形态**在该段标注「不适用」)
|
|
19
19
|
4. **视觉调性预选**(步骤 0.6,仅前端):9 张调性卡片 + 推荐
|
|
20
20
|
5. **结构化反问**(步骤 1):每轮最多 3 个问题
|
|
21
21
|
6. **影响面判定 + 范围排除**
|
|
@@ -26,6 +26,16 @@ description: "flow-kit CHANGE 阶段协议:反问澄清、change-id 自动生
|
|
|
26
26
|
|
|
27
27
|
- `.specs/<change-id>/CHANGE.md`
|
|
28
28
|
|
|
29
|
+
## 视觉调性段的标记约定(前端 / 非前端)
|
|
30
|
+
|
|
31
|
+
`CHANGE.md` 的 `## 视觉调性` 段(段名取自 `flow-kit/templates/CHANGE.md`)不只承载调性选择,还是下游 design 出口判定「是否前端」的**结构级判据**——它的在场状态必须与项目实情一致:
|
|
32
|
+
|
|
33
|
+
- **结构形态**(判据口径,与引擎的 design 出口适用性门控一致;本节只描述契约,两者不一致时以引擎的输出行为为准):`不适用` 标记**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签(`适用性` / `适用范围` / `是否前端` / `视觉调性` / `前端` / `界面` / `适用`)的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」(例如句子里写「不适用于暗色主题」)不算标注,仍判前端。
|
|
34
|
+
- **前端项目**:按步骤 0.6 的预选结果填段(选定 / 理由 / 参考产品 / 明确排除),不要以结构形态标注「不适用」。
|
|
35
|
+
- **非前端项目**:保留该段并以**结构形态**标注「不适用」(可附一句理由,例如「CLI 工具,无用户可见界面」)。段缺席同样按非前端处理,但缺席不留可读证据,故约定**显式标注**。
|
|
36
|
+
- **判据与强制等级**(下游据此分派):`flow-comet-ui-design` 在 design 节点的绑定等级为 `guarded`——段在场且无结构形态标记 ⇒ 判前端 ⇒ design 出口要求 `.specs/<change-id>/UI-DESIGN.md` 在场,并要求 `required-skill:design.flow-comet-ui-design` 真实声明(先加载、再声明);段缺席或有结构形态标记 ⇒ 判非前端 ⇒ 出口打印 `UI-DESIGN: skipped(非前端)` 与命中片段后放行,不要求 UI-DESIGN.md。
|
|
37
|
+
- **改判走本阶段**:change 进行中要改前端 / 非前端判定,回到这里改这一个段,不在 design / execute / verify 里就地绕开判据——改段即改变了 design 出口的判据输入。
|
|
38
|
+
|
|
29
39
|
## 状态推进
|
|
30
40
|
|
|
31
41
|
CHANGE.md 生成后,由 flow-comet 状态机(workflow-state/guard)推进节点。不需要手动维护 STATE.md。
|
|
@@ -107,11 +107,13 @@ The design node reads CHANGE.md and REQUIREMENT.md, then produces DESIGN.md thro
|
|
|
107
107
|
|
|
108
108
|
| Skill | Enforcement | Reason |
|
|
109
109
|
|-------|-------------|--------|
|
|
110
|
-
| `flow-comet-ui-design` |
|
|
110
|
+
| `flow-comet-ui-design` | Guarded(仅前端项目触发) | Produces UI-DESIGN.md with design tokens, anti-AI-slop check, visual north star——前端 change 须先 `skill-load` 建标记并在 record 载荷带 `required-skill:design.flow-comet-ui-design`(出口不再自动补写);非前端项目不加载不声明;旧 change 渐进 WARN |
|
|
111
111
|
|
|
112
112
|
**加载声明(阶段层 · 双步硬规则)**:本节点技能已由入口路由经 Skill 工具加载(你正在阅读的就是它);本节点 Required Skill Calls 的加载与声明同样不可跳过:
|
|
113
113
|
|
|
114
|
-
1. 本节点的同名条目已随路由加载——同名 required 条目(`flow-comet-design`)无需重复加载,仅需运行下方声明命令(只读取 SKILL.md 文件不叫加载,**不得跳过**真正的 Skill 工具注入步骤)。`flow-comet-ui-design` 为
|
|
114
|
+
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
|
+
|
|
116
|
+
> **前端判据(结构级 · 与引擎同口径)**:`CHANGE.md` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**时才判非前端——标记**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签(`适用性` / `适用范围` / `是否前端` / `视觉调性` / `前端` / `界面` / `适用`)的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」(如「不适用于暗色主题」)不算标注,仍判前端、仍要求 UI-DESIGN.md 与 `guarded` 声明。
|
|
115
117
|
2. 加载完成后**立即**运行声明命令(节点退出与证据记录会核对声明标记;声明如实记录加载动作,不等于产出证明):
|
|
116
118
|
|
|
117
119
|
```bash
|
|
@@ -1,26 +1,61 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: flow-comet-evolve
|
|
3
|
-
description: "Use only when explicitly invoked as /flow-comet-evolve; scan archived changes' DESIGN.md section 9,
|
|
3
|
+
description: "Use only when explicitly invoked as /flow-comet-evolve; scan archived changes' DESIGN.md section 9 through the engine command, review sediment candidates one by one, then patch CONTEXT.md with the approved ones. Not part of the 8-node flow."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# flow-comet-evolve(横向命令 · 架构沉淀)
|
|
7
7
|
|
|
8
8
|
## 触发
|
|
9
9
|
|
|
10
|
-
用户说「同步架构 / 整理沉淀 / evolve / 同步 CONTEXT
|
|
10
|
+
用户说「同步架构 / 整理沉淀 / evolve / 同步 CONTEXT」。本命令**只按显式调用与用户意图触发**——到期提示是提醒,不是自动加载条件。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
**覆盖声明(上游 vendored 只读)**:上游对应物 = `flow-kit/prompts/A-evolve.md`(只读基准,不修改)。**以下上游语义不采用**:① 载体 = 仓库根 `STATE.md` 的 `last_evolve_at` / `last_evolve_promoted` → 本仓载体 = **引擎 state**(`last_evolve_at`)+ `.specs/CONTEXT.md` 的 `## evolve 元数据` 段(本仓 `docs/internal/ARCHITECTURE.md` §六明确**不吸收** STATE.md 式跨会话状态跟踪);② 已扫 change 清单写回 `STATE.md` 数组 → 本仓写进 `.specs/evolve/<日期>-EVOLVE.md` 报告,**不进 state**。**沿用上游**:只扫 `DESIGN.md` §9、逐项人工确认、禁止批量 promote、报告落 `.specs/evolve/`、60 天 / ≥5 个带沉淀段 change 的建议阈值。`## evolve 元数据` 段的**段形权威 = `flow-kit/templates/CONTEXT.md`**(`## intel-scan 元数据` 为同源先例;校验实现在 `context-init.mjs`)。本命令语义与产物形态**以本节为准**。
|
|
13
|
+
|
|
14
|
+
**到期提示(引擎输出面)**:`node .claude/skills/flow-comet/scripts/workflow-state.mjs status` 在下列任一条件成立时输出一行 `EVOLVE-DUE:`(含上次沉淀时间、命中原因与「建议显式调用 evolve」指引):`last_evolve_at` 距今 > 60 天,或该时刻之后新增 ≥ 5 个带 `§9` 的归档 change。未达阈值**不输出**(零噪音);`last_evolve_at` 缺席(从未沉淀过)同样不提示——需要时手动跑本命令即可。
|
|
15
|
+
|
|
16
|
+
## 时间戳载体:引擎 state(不使用 STATE.md)
|
|
17
|
+
|
|
18
|
+
- **唯一真相** = `.flow-comet/flow-comet-state.json` 的 `last_evolve_at`,形态为**本地时间 + 显式偏移**(`YYYY-MM-DDTHH:mm:ss±HH:mm`;历史 `Z` 形态仍可解析,比较一律按解析后的时刻差值)
|
|
19
|
+
- **写入通道唯一** = `node .claude/skills/flow-comet/scripts/workflow-state.mjs config set last_evolve_at <值>`(脚本不直写 state 文件)
|
|
20
|
+
- **双落点**:同批更新 `.specs/CONTEXT.md` 的 `## evolve 元数据` 段(`last_evolve_at` / `scanner` / `下次建议` 三字段,对齐 `## intel-scan 元数据` 的字段语义)。两处取值必须一致,**冲突以 state 为准**
|
|
21
|
+
- 旧项目若在 `STATE.md` 维护过该字段:以引擎 state 为准;首次运行按「无基线」全量扫描并建立新基线
|
|
13
22
|
|
|
14
23
|
## 流程
|
|
15
24
|
|
|
16
|
-
1.
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
25
|
+
### 1. 扫描(只读,工作区零改动)
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
node .claude/skills/flow-comet/scripts/evolve.mjs scan --root .
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
- 扫描范围 = `last_evolve_at` **之后归档**的 change(无基线 → 全部归档 change);归档时刻取归档目录名的日期前缀(随提交固化,跨 clone / 检出稳定)
|
|
32
|
+
- **只读**每个 `.specs/archive/<日期>-<change-id>/DESIGN.md` 的架构沉淀段(第 9 节)——**不读该文档的其它段**,防 change 级冻结决策被错误升级为项目级
|
|
33
|
+
- 输出候选清单:`<归档目录名>#<序号>` + 条目 + 目标文档;并列出本次已扫的 change(含无沉淀段、无 `DESIGN.md` 的目录),扫描范围对用户完全可见
|
|
34
|
+
- 候选落点按沉淀子段归类:可复用抽象 / 禁动清单 → `CONTEXT.md`「既有抽象索引」;项目级技术决策 → `CONTEXT.md`「已锁决策」;依赖 → `CONTEXT.md`「技术栈」;跨模块契约 → `ARCHITECTURE.md`「跨模块契约」(该文档不在场时需先建立,否则应用会被拒绝且零改动)
|
|
35
|
+
|
|
36
|
+
### 2. 逐项 review(用户参与,不可跳过)
|
|
37
|
+
|
|
38
|
+
把候选清单贴给用户,**逐条**确认:接受 / 跳过(记理由)/ 编辑后接受。**严禁**一次性把整批直接写入。与 `CONTEXT.md` 现有条目重叠的冲突项必须显式提问,不允许默默接受。
|
|
39
|
+
|
|
40
|
+
### 3. 应用(只写批准的项)
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
node .claude/skills/flow-comet/scripts/evolve.mjs apply <候选 id> [<候选 id> ...] --root . --scanner "<执行工具>"
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
- 只 patch 批准的条目:写入前先备份目标文档(`.specs/CONTEXT.md.bak-<日期>`),只追加不删除既有内容,条目带来源标注(`来源 @.specs/archive/<目录>/DESIGN.md`)
|
|
47
|
+
- 重复应用同一条目按**幂等**处理(目标段已在场则不重复写入)
|
|
48
|
+
- 同批写双落点时间戳(`config set` 通道 + `## evolve 元数据` 段,取值一致)
|
|
49
|
+
- 落 `.specs/evolve/<日期>-EVOLVE.md` 报告:扫描范围 + 已扫 change 清单 + 候选处置 + 未应用项 + 双落点取值 + 下次建议
|
|
50
|
+
- 输出 `EVOLVE-OK` 才算应用成功;失败输出 `BLOCKED:` 原因且不留下半成品(文档写入与 state 写入同一命令内完成,失败可幂等重跑)
|
|
51
|
+
|
|
52
|
+
### 4. 收尾
|
|
53
|
+
|
|
54
|
+
把报告路径与写入清单交给用户复核;**未应用的候选**保留在报告里,可凭候选 id 继续 `apply`。下次建议时间 = 约 60 天后,或新增 ≥ 5 个带沉淀内容的 change 之后。
|
|
21
55
|
|
|
22
56
|
## 边界
|
|
23
57
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
58
|
+
- 不写业务代码;写入面只有项目级文档、`.specs/evolve/` 报告与 `last_evolve_at`
|
|
59
|
+
- **只读沉淀段**:扫描与解析都不触碰设计文档的其它段
|
|
60
|
+
- 只追加 / 更新,**不删除**既有内容;发现需要改架构(决策推翻 / ADR 弃用 / 依赖规则变更)→ 停下来提示用户走架构重审
|
|
61
|
+
- `CONTEXT.md` 的更新统一走本命令或 `context-scan`,不在 change 内直接改
|
|
@@ -1,31 +1,72 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: flow-comet-health
|
|
3
|
-
description: "Use only when explicitly invoked as /flow-comet-health; periodic codebase health check
|
|
3
|
+
description: "Use only when explicitly invoked as /flow-comet-health; periodic codebase health check driven by a deterministic collector (CONTEXT consistency, LESSONS numbering continuity, tech-debt count, redundancy tool probe, git history) plus an optional brooks-lint supplement layer with explicit degradation notes. Not part of the 8-node flow."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# flow-comet-health(横向命令 · 巡检)
|
|
7
7
|
|
|
8
8
|
## 触发
|
|
9
9
|
|
|
10
|
-
用户说「健康检查 / health / 体检 / 技术债扫描 /
|
|
10
|
+
用户说「健康检查 / health / 体检 / 技术债扫描 / 巡检 / 代码库健康度」。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
**只按显式调用触发**:本命令不属于 8 节点流程,不被节点路由进入,也不在流程里自动跑(路由里的到期提示指向的是架构沉淀命令,不是本命令)。
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
14
|
+
**覆盖声明(上游 vendored 只读)**:上游对应物 = `flow-kit/prompts/M-health.md`(只读基准,不修改)。
|
|
15
|
+
|
|
16
|
+
**沿用上游**:① 不属于任何 change、不写 `CHANGE.md` / `REQUIREMENT.md`,直接产出健康报告;② 角色边界 = 只产报告 + 改造建议清单,不直接改代码;③ 报告落点 `.specs/health/<YYYY-MM-DD>-HEALTH.md`;④ 装了 `brooks-lint` 时走其体检并把结果并入报告(本仓作为**可选增补层**并入**同一份**报告并标注来源);⑤ 冗余巡检**优先用工具**(`jscpd` / `knip` / `vulture` 等)并在报告里记明工具落点;⑥ 报告含**技术债优先级(Pain × Spread)**维度。
|
|
17
|
+
|
|
18
|
+
**以下上游语义不采用**:① 由 agent 现场巡检产出定性结论 → 本仓改为**确定性收集器**(脚本采集可复现项,每项带计数与复现命令);② 自动改写 `.specs/CONTEXT.md` 技术债段 / 自动开 change → 本仓**只读**(仅写体检报告,不改 CONTEXT、不开 change);③ 无可选工具时以主观评分填空 → 本仓**显式降级声明**,不产出替代性评分;④ 未装工具时走「现场 grep 抓样」的低精度回退 → 本仓**直接记降级原因**,不产出替代性读数。
|
|
19
|
+
|
|
20
|
+
本命令语义与报告形态**以本节为准**。
|
|
21
|
+
|
|
22
|
+
## 分层结构(防「绿报告」)
|
|
23
|
+
|
|
24
|
+
一份报告三层,落在同一个文件 `.specs/health/<日期>-HEALTH.md`:
|
|
25
|
+
|
|
26
|
+
| 层 | 内容 | 产出者 |
|
|
27
|
+
|---|---|---|
|
|
28
|
+
| 确定性层 | 项目上下文一致性 · 经验条目编号连续性 · 技术债表项数 · 冗余工具在场判定 · 版本历史统计 | `health.mjs`(逐项带计数与判据) |
|
|
29
|
+
| 增补层 | 代码体检工具的 4 维结果(代码质量 / 架构 / 技术债 / 测试质量) | agent:工具在场时执行体检技能,结果**并入同一份报告**并标注来源 |
|
|
30
|
+
| 降级声明 | 可选工具不在场的原因 + 判据说明 | `health.mjs`(每份报告都有) |
|
|
31
|
+
|
|
32
|
+
判据只锚「**确定性层完整 + 降级声明可见**」:可选工具缺席不构成失败,但**不能**用主观评分去填它的空位。
|
|
16
33
|
|
|
17
34
|
## 流程
|
|
18
35
|
|
|
19
|
-
1.
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
36
|
+
1. 跑确定性收集器(命令路径以安装平台为准,下同):
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
node .claude/skills/flow-comet/scripts/health.mjs --root . --stdout
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
落盘 `.specs/health/<日期>-HEALTH.md`;`--stdout` 打印与落盘**逐字节相同**的内容,便于两次运行对照。
|
|
43
|
+
|
|
44
|
+
2. 看报告「增补层」的在场判定:
|
|
45
|
+
- **在场**:执行代码体检技能(`brooks-health`),把 4 维结果填进增补层的四个槽位,并在来源标注行写明命中落点;
|
|
46
|
+
- **不在场**:保留降级声明,不产出替代性评分——报告以确定性层为全部内容。用户要求定性判断时另走代码审查流程,不把主观分写进这份报告。
|
|
47
|
+
|
|
48
|
+
3. 读「与上次对比」段:与最近一份**日期不同**的历史报告逐项对读数。首份报告会显式声明「无差异可比」,不是静默省略。
|
|
49
|
+
|
|
50
|
+
4. 把需要动手的发现整理成改造建议清单交给用户(按优先级分组)。本命令不改代码;要落地时另开 change。
|
|
51
|
+
|
|
52
|
+
## 复现性纪律
|
|
53
|
+
|
|
54
|
+
- 报告里每个机器可判项都带计数与判据;同一冻结树连续两次运行,除报告末尾「易变行声明」列出的差异集合(生成时刻行 / 最近 30 天统计行 / 跨日时的文件名与基线选择)外**逐字节一致**。
|
|
55
|
+
- 出现差异集合之外的差异 → 按缺陷处理:先 `git status` 确认是否有人在此期间改了树,再查收集器判据是否引入了环境依赖。
|
|
56
|
+
- 报告由脚本整份重写:agent 填进增补层的内容会在下次运行时被覆盖;需要长期留档时把报告复制到项目自己的归档位置。
|
|
57
|
+
|
|
58
|
+
## 降级纪律(可选工具)
|
|
59
|
+
|
|
60
|
+
可选工具(代码体检工具、字面重复块 / 未用导出 / 未用依赖 / 死代码扫描器)**不在依赖面**:缺席、不可用、版本不符,一律走「显式声明原因 + 只出确定性子集」。
|
|
61
|
+
|
|
62
|
+
- 报告「降级声明」段逐项写明缺席工具与探面(扫描器:`node_modules/.bin/` 与 `PATH`;代码体检工具另含用户级缓存 / 用户技能目录与项目内三平台技能目录)。
|
|
63
|
+
- 工具在场但运行未完成(版本差异 / 平台包装器限制 / 超时)同样记进该段——**不静默降级**,也不让命令失败。
|
|
64
|
+
- 要让某个维度从「未采集」变成「有读数」,装工具后重跑本命令即可:不需要改流程,也不需要改运行状态。
|
|
27
65
|
|
|
28
|
-
##
|
|
66
|
+
## 只读边界
|
|
29
67
|
|
|
30
|
-
-
|
|
31
|
-
-
|
|
68
|
+
- **读**:`.specs/CONTEXT.md`、`.specs/LESSONS.md`、`.specs/health/*.md`(基线)、版本历史、可选工具的在场探测。
|
|
69
|
+
- **写**:只写 `.specs/health/<日期>-HEALTH.md` 一份报告。
|
|
70
|
+
- **不写运行状态**:不触碰 `.flow-comet/flow-comet-state.json`,本命令不新增任何状态字段(横向命令不进 change 生命周期)。
|
|
71
|
+
- **不改业务代码**,也不自动改写 `.specs/CONTEXT.md` / `.specs/LESSONS.md`:发现项只进报告与建议清单——就地改写会让「巡检」变成隐式写入通道。
|
|
72
|
+
- **不自动开 change**:是否立项由用户决定。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: flow-comet-ui-design
|
|
3
|
-
description: "flow-kit 2a UI-DESIGN 阶段协议:美学方向 + design tokens + 反 AI-slop
|
|
3
|
+
description: "flow-kit 2a UI-DESIGN 阶段协议:美学方向 + design tokens + 反 AI-slop 自检。前端 change 触发(结构级判据见内文),非前端 change 显式跳过。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# flow-kit UI-DESIGN Protocol
|
|
@@ -21,6 +21,31 @@ description: "flow-kit 2a UI-DESIGN 阶段协议:美学方向 + design tokens
|
|
|
21
21
|
|
|
22
22
|
- `.specs/<change-id>/UI-DESIGN.md`(含 design tokens frontmatter)
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## 触发与跳过(前端判据 · 结构级)
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
判据只看 `.specs/<change-id>/CHANGE.md` 的 `## 视觉调性` 段(段名基准取自 `flow-kit/templates/CHANGE.md`),不做语义判断——判据的实现方是 design 出口的适用性门控,本表只描述契约:
|
|
27
|
+
|
|
28
|
+
| `## 视觉调性` 段 | 判定 | 本技能动作 |
|
|
29
|
+
|---|---|---|
|
|
30
|
+
| 段在场,段内出现**结构形态**的「不适用」标记 | 非前端 change | **显式跳过**:不加载、不产出;design 出口打印 `UI-DESIGN: skipped(非前端)` 与命中片段后放行 |
|
|
31
|
+
| 段在场,无**结构形态**的「不适用」标记 | 前端 change | 必须加载本技能并产出 `.specs/<change-id>/UI-DESIGN.md` |
|
|
32
|
+
| 段缺席 | 非前端 change | 同上按非前端处理——但缺席不留可读证据,故约定保留段并以结构形态标注「不适用」(见 `flow-comet-change` 的标记约定) |
|
|
33
|
+
|
|
34
|
+
**「结构形态」的三种任一**(与引擎判据同口径):标记**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签(`适用性` / `适用范围` / `是否前端` / `视觉调性` / `前端` / `界面` / `适用`)的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」(例如句子里写「不适用于暗色主题」)不关闸,仍判前端。
|
|
35
|
+
|
|
36
|
+
上游的语义信号(`flow-kit/prompts/2a-ui-design.md` 与 `4-dev` 的判定):任务触碰 `.css` / `.scss` / `.tsx` / `.vue` / `.jsx` / `.html` / `.svelte` / 设计 token / 用户可见文案,或 `action` 含 button / 颜色 / 字体 / 卡片 / 布局 / 动画 / 主题 等关键词。
|
|
37
|
+
|
|
38
|
+
语义上判为前端、而 `## 视觉调性` 段已按结构形态标注「不适用」时:**回 open 阶段改段**再走本阶段——判据输入只有这一个段,不在 design / execute 里就地绕开它。反向同理:非前端 change 不要为了「保险」产出 UI-DESIGN.md。
|
|
39
|
+
|
|
40
|
+
## 强制等级(design 节点 · guarded)
|
|
41
|
+
|
|
42
|
+
`design` 节点对本技能的绑定等级 = **guarded**(见 `reference/workflow-protocol.json` 的 `requiredSkillCalls`)。前端 change 的完整动作是**先加载、再声明、后干活**:
|
|
43
|
+
|
|
44
|
+
1. 用 Skill 工具加载本技能(只读取 SKILL.md 文件不叫加载);
|
|
45
|
+
2. 立即声明已加载:`node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load design flow-comet-ui-design --prompt flow-kit/prompts/2a-ui-design.md`;
|
|
46
|
+
3. 把 `required-skill:design.flow-comet-ui-design` 记进 design 节点的 evidence(`record` / handoff 载荷)。
|
|
47
|
+
|
|
48
|
+
design 出口的核对口径:
|
|
49
|
+
|
|
50
|
+
- **前端 change**:evidence 缺 `required-skill:design.flow-comet-ui-design` → 出口**不再自动补写**该条目,直接拦截(加载并声明后重试);缺 `.specs/<change-id>/UI-DESIGN.md` → 新 change **BLOCKED**,恢复两条路——补齐工件,或按结构形态在 `## 视觉调性` 段标注「不适用」改判非前端;旧 change 仅 **WARN** 渐进,不阻断。
|
|
51
|
+
- **非前端 change**:不要求 UI-DESIGN.md,也不要求上述声明,出口打印可见的 `UI-DESIGN: skipped(非前端)` 后放行——**显式跳过,不是静默省略**。
|
package/README.md
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
<p align="center">
|
|
29
29
|
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js_%E2%89%A518-339933?style=flat&logo=node.js&logoColor=white" alt="Node.js 18+" /></a>
|
|
30
30
|
<a href="https://github.com/baobaolaodie/flow-comet/actions"><img src="https://img.shields.io/github/actions/workflow/status/baobaolaodie/flow-comet/ci.yml?style=flat" alt="CI" /></a>
|
|
31
|
-
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-1.6.
|
|
31
|
+
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-1.6.2-blue.svg" alt="Version" /></a>
|
|
32
32
|
</p>
|
|
33
33
|
|
|
34
34
|
---
|
|
@@ -173,7 +173,7 @@ Full guide in [CONTRIBUTING.md](CONTRIBUTING.md) — branch model (`feature →
|
|
|
173
173
|
|
|
174
174
|
1. Branch from `dev`: `git checkout dev && git checkout -b feat/<description>`
|
|
175
175
|
2. Edit skills/scripts under `.flow-comet/skills/` (authoritative source); TDD with RED scenario first
|
|
176
|
-
3. Run regression: `node .flow-comet/skills/flow-comet/scripts/guard-self-test.mjs` → `ALL
|
|
176
|
+
3. Run regression: `node .flow-comet/skills/flow-comet/scripts/guard-self-test.mjs` → `ALL 309 SCENARIOS PASSED`
|
|
177
177
|
4. Open a PR into `dev` (squash — one change-level commit); release PR `dev → main` (merge — dev's change-level commits enter main, and dev stops leading after each release)
|
|
178
178
|
|
|
179
179
|
CI enforces the repository conventions automatically on every PR and push (regression, PR discipline, version consistency, dead links). Local hooks (commit/push message checks) install with `node scripts/install-commit-hook.mjs` — see [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "flow-comet",
|
|
3
|
-
"version": "1.6.
|
|
3
|
+
"version": "1.6.2",
|
|
4
4
|
"description": "An automated execution engine that turns AI coding discipline into a verifiable state machine for the flow-kit 9-stage workflow, built for Claude Code, Codex, and DeepSeek Harness.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
package/scripts/dsh-bridge.mjs
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
// 纯 ESM、零第三方依赖,仅使用 Node.js 内置模块。dsh 官方插件形态:
|
|
29
29
|
// ESM 模块导出 { name, apply },ctx 由 dsh 注入。
|
|
30
30
|
//
|
|
31
|
-
// BRIDGE_VERSION: 1.6.
|
|
31
|
+
// BRIDGE_VERSION: 1.6.2
|
|
32
32
|
|
|
33
33
|
import { spawn } from 'node:child_process';
|
|
34
34
|
import { existsSync, readFileSync, realpathSync } from 'node:fs';
|
|
@@ -40,7 +40,7 @@ import path from 'node:path';
|
|
|
40
40
|
// 值语义 = 当前发布版本(随发布同步更新,与技能包 INSTALLED_VERSION 同值——
|
|
41
41
|
// bridge-check 的版本一致性检查据此判定 loader 与项目副本同版)。
|
|
42
42
|
export const name = 'dsh-flow-comet-bridge';
|
|
43
|
-
export const version = '1.6.
|
|
43
|
+
export const version = '1.6.2';
|
|
44
44
|
|
|
45
45
|
// guard 在项目内的相对路径常量(随 skill 包分发)。
|
|
46
46
|
const HOOK_GUARD_REL = '.dsh/skills/flow-comet/scripts/comet-hook-guard.mjs';
|