cc-devflow 4.1.6 → 4.3.0

package/.claude/commands/core/architecture.md

@@ -29,6 +29,36 @@ architecture-designer (research, no dialogue)
 ARCHITECTURE.md (4 diagrams)
 ```
 
+## Harness Engineering 增强（Long-running Session Protocol）
+
+为防止跨上下文窗口后出现“图表半生成、ADR 丢失、误判已完成”，执行分为 Initializer 与 Worker 两类会话。
+
+### Phase 0: Initializer Session（首次或 --force）
+
+先建立/刷新架构任务工件（不要一次性生成整份文档）：
+- `devflow/.core-harness/architecture/checklist.json`
+  - 列出 4 张图、ADR、NFR、演进路径等验收项，默认 `passes=false`
+- `devflow/.core-harness/architecture/progress.md`
+  - 记录本次修改、风险、下一步
+- `devflow/.core-harness/architecture/init.md`
+  - 固定启动流程（读取 ROADMAP、读取最近进展、执行 Mermaid 冒烟验证）
+
+### Worker Session（增量交付）
+
+每个窗口只处理一个子目标，例如：
+- 只完成一张 Mermaid 图并自检语法
+- 只补齐 ADR 与对应图表映射
+- 只修复依赖图节点/边一致性问题
+
+会话收尾要求：
+1. 运行当前文档校验（占位符、图表数量、语法）
+2. 更新 checklist 的 `passes` 字段
+3. 写入 progress/handoff，明确下一窗口优先任务
+
+### Done Gate
+
+`checklist.json` 全绿 + Phase 4 校验通过，才可输出成功报告。
+
 ## 执行流程
 
 ### Phase 1: Prerequisites Check

package/.claude/commands/core/guidelines.md

@@ -35,6 +35,31 @@ description: 'Generate project-specific development guidelines skills (frontend/
 /core-guidelines --dry-run
 ```
 
+## Harness Engineering 增强（Eval-Driven + Incremental）
+
+`/core-guidelines` 容易出现两类失败：一次生成过大导致中断、未验证触发规则就标记完成。为此引入双阶段协议。
+
+### Step 0: Initializer Session
+
+创建会话工件：
+- `devflow/.core-harness/guidelines/skill-checklist.json`
+  - Frontend/Backend 分别列出验收项：触发规则、关键资源文件、示例质量、约束合规，默认 `passes=false`
+- `devflow/.core-harness/guidelines/progress.md`
+- `devflow/.core-harness/guidelines/session-handoff.md`
+
+### Worker Session
+
+- 一次只处理一个 skill（frontend 或 backend），禁止同窗口双线并发重写
+- 每次只完成一个最小闭环：`生成/更新 → 触发验证 → 示例验证 → 勾选 passes`
+- 结束前必须写 handoff，明确下一窗口要做的单一目标
+
+### Eval Gate（禁止“看起来差不多”）
+
+只有当以下检查全部通过才标记对应 skill 完成：
+1. `skill-rules.json` 触发范围正确，且前后端互不污染
+2. SKILL + resources 无占位符/虚构路径
+3. 至少 1 个真实文件路径触发测试通过（frontend 与 backend 各自独立）
+
 ---
 
 ## Process

package/.claude/commands/core/roadmap.md

@@ -102,6 +102,35 @@ guides:
 - **roadmap-planner (Agent)**: 根据上下文生成文档，无对话
 - **architecture-designer (Agent)**: 生成架构图，无对话
 
+## Harness Engineering 增强（OpenAI + Anthropic 实践融合）
+
+为避免长会话中的“半成品漂移 / 提前宣布完成 / 上下文断片”，`/core-roadmap` 强制采用双阶段执行。
+
+### Stage -1: Initializer Session（只做地基，不做全量生成）
+
+在首次运行或 `--regenerate` 时先建立可恢复工件：
+- `devflow/.core-harness/roadmap/feature-checklist.json`
+  - 结构化列出路线图必须产物（愿景、里程碑、依赖图、容量评估、季度分配等），默认 `passes=false`
+- `devflow/.core-harness/roadmap/progress.md`
+  - 记录每次会话完成内容、未决问题、下一步
+- `devflow/.core-harness/roadmap/session-handoff.md`
+  - 给下一窗口的启动指令（从哪个 Stage 继续、先做什么验证）
+
+### Worker Session（增量推进，每次只完成一个最小目标）
+
+每个窗口必须遵守：
+1. 启动先读状态：`pwd` → `progress.md` → `feature-checklist.json` → 最近 git log（若仓库可用）
+2. 先做冒烟检查：确认现有 `ROADMAP.md/BACKLOG.md/ARCHITECTURE.md` 不是损坏状态
+3. 只推进一个最小单元：
+   - 一个 Stage 的信息收集，或
+   - 一个 RM 依赖簇的整理，或
+   - 一次时间线冲突修复
+4. 结束前必须更新工件：勾选 `passes`、写入 progress/handoff、明确下一步
+
+### 完成判定（禁止“口头完成”）
+
+只有 `feature-checklist.json` 全部 `passes=true`，且 Stage 8 输出文件全部存在并通过校验，才允许宣告完成。
+
 ---
 
 ## 执行流程骨架

package/.claude/commands/core/style.md

@@ -21,6 +21,24 @@ $ARGUMENTS = "[--update]"
 /core-style --update   # 更新已有风格指南
 ```
 
+## Harness Engineering 增强（多窗口稳定执行）
+
+为避免风格文档在多轮会话中变成“补丁堆”，执行采用 initializer + incremental worker。
+
+### 0. Initializer Session
+- 建立 `devflow/.core-harness/style/` 工件：
+  - `checklist.json`: token 体系、组件约束、可访问性、响应式、动效、禁用项等验收项（默认 `passes=false`）
+  - `progress.md`: 本轮修改与未决项
+  - `session-handoff.md`: 下一轮优先任务与验证命令
+
+### 1. Worker Session
+- 每轮只处理一个最小块（例如颜色 token、排版 token、某一类组件约束）
+- 修改后立即做局部验证，不通过则回滚该块后重试
+- 收尾必须同步 checklist/progress/handoff，保持可恢复
+
+### 2. Done Gate
+- 只有 checklist 全部 `passes=true` 且第 4 步校验通过，才允许输出“STYLE 生成完成”
+
 ## 执行步骤
 
 ### 1. 入口检查

package/.claude/commands/flow/CLAUDE.md

@@ -3,8 +3,6 @@
 
 成员清单
 archive.md: 归档需求命令。
-checklist.md: 已废弃命令，统一迁移到 /flow:verify。
-clarify.md: 已废弃命令，默认主链移除独立澄清阶段。
 constitution.md: 宪法规则管理命令。
 context.md: 上下文资产管理命令。
 delta.md: 需求增量变更命令。
@@ -12,8 +10,6 @@ dev.md: 主链开发阶段命令，触发 harness dispatch/resume。
 fix.md: Bug 修复命令。
 ideate.md: 想法到需求命令。
 init.md: 主链初始化命令，触发 harness init/pack。
-new.md: 已废弃命令，迁移到 /flow:init -> /flow:spec -> /flow:dev -> /flow:verify -> /flow:release。
-quality.md: 已废弃命令，统一迁移到 /flow:verify。
 release.md: 主链发布命令，触发 harness release/janitor。
 restart.md: 旧中断恢复命令（迁移过渡保留）。
 spec.md: 主链规格命令，触发 harness plan。

package/.claude/docs/examples/design-inspiration-pool.md

@@ -0,0 +1,59 @@
+# Design Inspiration Pool
+
+> 80+ 位艺术家/设计师/建筑师灵感来源池
+> 用于 UI_PROTOTYPE_TEMPLATE.md Phase 2: Design Inspiration Sampling
+
+---
+
+## 使用方法
+
+从不同类别中随机采样 2 位大师，生成风格转译说明。
+
+**采样策略**:
+- 从不同类别中选择（避免风格过于相似）
+- 优先组合：现代主义 + 生成艺术，建筑 + 平面设计
+- 避免组合：同类别内的大师（如两位都是建筑师）
+
+**转译模板**:
+```
+**灵感来源X**: {艺术家姓名} ({类别})
+**核心特质**: {艺术家代表性特点,1-2句话}
+**网页转译**:
+  - 色彩: {具体色值} → {应用场景}
+  - 版式: {布局策略} → {CSS实现方式}
+  - 形态: {视觉元素} → {HTML/CSS实现}
+  - 动效: {动态特征} → {CSS/JS实现}
+**禁止模仿**: 不复刻{具体作品名称}的{具体元素}
+```
+
+---
+
+## 灵感来源池 (8 类别, 80+ 位大师)
+
+### 类别1: 影视片头 / 动态叙事
+Saul Bass, Maurice Binder, Pablo Ferro, Dan Perri, Kyle Cooper
+
+### 类别2: 平面 / 字体 / 后现代图形
+Paula Scher, Neville Brody, April Greiman, David Carson, Jamie Reid, Push Pin Studios (Seymour Chwast)
+
+### 类别3: 现代主义信息设计 / 网格系统
+Massimo Vignelli, Josef Müller-Brockmann, Otl Aicher, Armin Hofmann, Karl Gerstner, Muriel Cooper
+
+### 类别4: 几何与抽象艺术 / 光学艺术
+Piet Mondrian, Sonia Delaunay, Josef Albers, Victor Vasarely, Bridget Riley, M. C. Escher, Paul Klee, Kazimir Malevich, Joan Miró, Henri Matisse, Mark Rothko, René Magritte, Salvador Dalí
+
+### 类别5: 亚洲与当代艺术
+Yayoi Kusama, Takashi Murakami, Katsushika Hokusai(葛饰北斋), Xu Bing(徐冰), Zao Wou-Ki(赵无极)
+
+### 类别6: 建筑 / 空间设计
+Zaha Hadid, Frank Gehry, Le Corbusier, Mies van der Rohe, Tadao Ando(安藤忠雄), Oscar Niemeyer, Santiago Calatrava, Norman Foster, Rem Koolhaas
+
+### 类别7: 生成艺术 / 算法设计 / 数据可视化
+Casey Reas, Ben Fry (Processing), Joshua Davis, Jared Tarbell, Robert Hodgin, Jer Thorp, Nadieh Bremer, Shirley Wu, Stefanie Posavec, Giorgia Lupi
+
+### 类别8: 工业设计 / 产品设计
+Dieter Rams, Charles & Ray Eames, Naoto Fukasawa(深泽直人), Jasper Morrison, Marc Newson, Philippe Starck, Karim Rashid, Jonathan Ive
+
+---
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/docs/examples/ui-prototype-constitution-checklist.md

@@ -0,0 +1,75 @@
+# UI Prototype Constitution Checklist
+
+> UI 原型宪法合规检查清单
+> 用于 UI_PROTOTYPE_TEMPLATE.md Phase 10: Constitution & Quality Check
+
+---
+
+## Constitution 检查
+
+### Article I - Quality First (质量至上)
+- [ ] I.1 Complete Implementation: HTML 无占位符，所有页面完整
+- [ ] I.2 No Simplification: 交互逻辑完整，非简化版本
+- [ ] I.4 Quality Gates: 通过 HTML 验证，无 console 错误
+
+### Article III - Security First (安全优先)
+- [ ] III.1 No Hardcoded Secrets: 无 API 密钥硬编码
+- [ ] III.2 Input Validation: 表单有验证逻辑
+- [ ] III.4 Secure by Default: 使用 HTTPS CDN 资源
+
+### Article V - Maintainability (可维护性)
+- [ ] V.3 Documentation: HTML 注释包含设计文档
+- [ ] V.4 File Size Limits: 单文件 HTML ≤ 2000 行（可接受）
+
+### Article X - Requirement Boundary (需求边界)
+- [ ] X.1 No Speculation: 仅实现 PRD 明确的功能
+- [ ] X.2 No Speculative Features: 无"未来可能需要"的功能
+
+---
+
+## 质量检查清单
+
+### HTML 质量
+- [ ] 使用 HTML5 语义化标签
+- [ ] 无未闭合标签
+- [ ] ARIA 标签完整
+- [ ] 无重复 ID
+
+### CSS 质量
+- [ ] 使用 CSS 变量（Design System）
+- [ ] 响应式媒体查询正常
+- [ ] 无 !important 滥用
+- [ ] 命名规范（BEM 或一致的命名）
+
+### JavaScript 质量
+- [ ] 无全局变量污染
+- [ ] 事件监听器正确绑定
+- [ ] 无内存泄漏（事件监听器移除）
+- [ ] Console 无错误
+
+### 可访问性
+- [ ] 色彩对比度 ≥ 4.5:1
+- [ ] 键盘导航可用
+- [ ] 屏幕阅读器友好
+- [ ] focus 状态可见
+
+### 性能
+- [ ] CDN 资源加载 <1s
+- [ ] 首屏渲染 <2s
+- [ ] 交互响应 <100ms
+- [ ] 无不必要的重绘/回流
+
+---
+
+## Anti-Generic-Design 验证
+- [ ] 无占位图片（Picsum 图片正常加载）
+- [ ] 无常见 AI 紫/蓝配色
+- [ ] 无 Emoji 图标（使用 SVG/图标库）
+- [ ] 无 Lorem Ipsum 文本
+- [ ] 所有交互元素有完整状态（hover/active/disabled/error）
+
+---
+
+**完整 Constitution 文档**: `.claude/rules/project-constitution.md`
+
+**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md