cc-devflow 2.5.0 → 4.1.1

package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md

@@ -1,77 +1,50 @@
 # Flow-New Orchestration Template
 
-> Execution flow for `/flow-new` one-shot requirement development
+> Execution flow for `/flow-new` one-shot requirement development (v4.1)
 
 ---
 
 ## Stage Execution Skeleton
 
-### [1/8] /flow-init
+### [1/6] /flow-init
 - 创建需求目录 + Git 分支
-- MCP 研究材料收集 (mandatory)
-- Exit Gate: 5-level quality check (research.md 完整性)
-
-### [2/8] /flow-prd
-- 生成 PRD.md (用户故事 + GWT 验收标准)
-- Constitution 符合性检查
-
-### [2.3/8] /flow-checklist (可选, 80% 门禁)
-- 触发条件: `quality-rules.yml` 中 `checklist_gate_enabled: true`
-- 生成 checklists/*.md (5 维度质量验证)
-- 闸门: 完成度 ≥ 80%
-
-### [2.5/8] /flow-ui (条件触发)
-**UI Detection Logic** (JavaScript):
-```javascript
-function detectUIRequirement(prdContent, projectRoot) {
-  const uiKeywords = ['用户界面', '前端', 'Web页面', 'UI', '界面设计', '交互',
-                      '页面', '表单', '按钮', '导航', '布局', '组件'];
-  const hasUIKeywords = uiKeywords.some(kw => prdContent.includes(kw));
-  const hasFrontendStack = fs.existsSync(`${projectRoot}/package.json`);
-  const isBackendOnly = prdContent.includes('纯后端');
-  return (hasUIKeywords || hasFrontendStack) && !isBackendOnly;
-}
-```
-- 输出: UI_PROTOTYPE.html + research/ui_design_strategy.md
-- 跳过: orchestration_status.json.ui_skipped = true
+- 研究材料收集 + `BRAINSTORM.md` 初始化
+- Exit Gate: `orchestration_status.status == initialized`
 
-### [2.7/8] /flow-tech (必需)
-- 生成 TECH_DESIGN.md (7 sections: 架构/技术栈/数据模型/API/安全/性能/部署)
-- 输出: data-model.md + contracts/openapi.yaml + quickstart.md
-- Exit Gate: 所有 Section 1-7 完整
+### [2/6] /flow-clarify (可选)
+- 触发条件: 需求歧义、边界冲突、验收标准不明确
+- 输出: `clarifications/*.md`
+- 若跳过: 标记 `clarify_skipped: true`
 
-### [3/8] /flow-epic
-- Entry Gate: Checklist 完成度 ≥ 80% (如果启用)
-- 生成 EPIC.md + TASKS.md
-- 验证: TASKS 覆盖 TECH_DESIGN.md 所有技术层
+### [3/6] /flow-spec
+- 统一规格阶段: PRD → Tech+UI(并行) → Epic/TASKS
+- 支持模式: `--skip-tech` / `--skip-ui`
+- Exit Gate: 规格产物完整，`status = spec_complete`
 
-### [4/8] /flow-dev
+### [4/6] /flow-dev
 **TDD 执行模式**:
 ```
 Phase 1: 分析现有代码
 Phase 2: 编写测试 (Tests First)
   ↓
-TEST VERIFICATION CHECKPOINT → 测试必须先失败
+TDD CHECKPOINT → 测试必须先失败
   ↓
 Phase 3: 实现代码
 Phase 4: 测试验证 → 测试必须通过
-Phase 5: Git 提交并标记完成
 ```
-- 输出: 实现代码 + 测试代码 + TASKS.md 更新 (checkbox 标记)
-
-### [5/8] /flow-qa --full
-**Exit Gate 检查**:
-- ✅ 所有测试通过
-- ✅ 代码覆盖率 ≥ 80%
-- ✅ 无高危安全问题
-- ✅ TypeScript 类型检查通过
-- 输出: TEST_REPORT.md + SECURITY_REPORT.md
-
-### [6/8] /flow-release
-- 生成 RELEASE_PLAN.md
-- 更新 CLAUDE.md (如有架构变更)
-- 最终构建
-- 创建 GitHub Pull Request
+- 输出: 实现代码 + 测试代码 + `TASKS.md` 勾选更新
+
+### [5/6] /flow-quality --full
+**统一质量验证**:
+- 规格合规审查
+- 代码质量审查
+- 安全扫描与测试门禁
+- 输出: `SPEC_REVIEW.md`, `CODE_QUALITY_REVIEW.md`, `SECURITY_REPORT.md`
+
+### [6/6] /flow-release
+- 生成 `RELEASE_PLAN.md`
+- 执行发布分支策略（PR/merge/squash 等）
+- 必要时更新 `CLAUDE.md`
 
 ---
 
@@ -83,65 +56,52 @@ Phase 5: Git 提交并标记完成
 
 需求: REQ-123 | 支持用户下单
 
-[1/8] ✅ 初始化完成
-[2/8] ✅ PRD生成完成
-[2.5/8] ✅ UI原型生成完成 ⚡️
-[2.7/8] ✅ 技术方案设计完成 🔧
-[3/8] ✅ Epic规划完成
-[4/8] 🔄 开发执行中... (8/18 已完成)
-[5/8] ⏳ 等待质量保证...
-[6/8] ⏳ 等待发布管理...
+[1/6] ✅ 初始化完成
+[2/6] ✅ 澄清完成 (可选)
+[3/6] ✅ 统一规格完成
+[4/6] 🔄 开发执行中... (8/18 已完成)
+[5/6] ⏳ 等待质量验证...
+[6/6] ⏳ 等待发布管理...
 ```
 
-**状态图标**:
-- ✅ 已完成
-- 🔄 执行中
-- ⏳ 等待执行
-- ⚡️ 条件触发已执行
-- 🔧 必需步骤已完成
-
 ---
 
 ## Output Structure
 
 ```
 devflow/requirements/${REQ_ID}/
-├── research/                     # [1/8]
-├── PRD.md                        # [2/8]
-├── checklists/*.md               # [2.3/8] (可选)
-├── UI_PROTOTYPE.html             # [2.5/8] (条件)
-├── TECH_DESIGN.md                # [2.7/8]
-├── data-model.md
-├── contracts/openapi.yaml
-├── quickstart.md
-├── EPIC.md                       # [3/8]
-├── TASKS.md                      # [4/8] (checkbox 标记任务完成状态)
-├── TEST_REPORT.md                # [5/8]
-├── SECURITY_REPORT.md
-└── RELEASE_PLAN.md               # [6/8]
+├── BRAINSTORM.md
+├── research/
+├── clarifications/                # 可选
+├── PRD.md
+├── TECH_DESIGN.md                 # 若未跳过 tech
+├── UI_PROTOTYPE.html              # 若未跳过 ui 且识别到 UI 需求
+├── EPIC.md
+├── TASKS.md
+├── SPEC_REVIEW.md                 # flow-quality --full
+├── CODE_QUALITY_REVIEW.md         # flow-quality --full
+├── SECURITY_REPORT.md             # flow-quality --full
+└── RELEASE_PLAN.md
 ```
 
 ---
 
 ## Status Tracking
 
-**orchestration_status.json 关键字段**:
+**orchestration_status.json 推荐字段**:
 ```json
 {
   "status": "dev_complete",
   "phase": "execution",
-  "phase0_complete": true,
-  "prd_complete": true,
-  "checklist_complete": true,    // 如果启用
-  "ui_skipped": false,            // 或 ui_complete: true
-  "tech_design_complete": true,
-  "epic_complete": true,
+  "initialized": true,
+  "clarify_complete": true,
+  "spec_complete": true,
   "dev_complete": true,
-  "qa_complete": false,
+  "quality_complete": false,
   "release_complete": false
 }
 ```
 
 ---
 
-**Last Updated**: 2025-12-19
+**Last Updated**: 2026-02-07

package/.claude/docs/templates/_shared/CLAUDE.md

@@ -0,0 +1,36 @@
+# _shared/ - Shared Template Components
+
+> L2 | 父级: `.claude/docs/templates/CLAUDE.md`
+
+## Purpose
+
+Reusable template components extracted from PRD/EPIC/TECH_DESIGN/UI_PROTOTYPE templates to reduce duplication and ensure consistency.
+
+## Members
+
+| File | Purpose | Lines | Used By |
+|------|---------|-------|---------|
+| `CONSTITUTION_CHECK.md` | Constitution compliance check section | ~150 | PRD, EPIC, TECH_DESIGN |
+| `VALIDATION_CHECKLIST.md` | Validation checklist patterns | ~100 | All templates |
+| `YAML_FRONTMATTER.md` | YAML frontmatter patterns | ~50 | All templates |
+
+## Usage Pattern
+
+Templates reference these components via include syntax:
+```markdown
+{{INCLUDE: _shared/CONSTITUTION_CHECK.md}}
+{{INCLUDE: _shared/VALIDATION_CHECKLIST.md#prd}}
+```
+
+Or copy relevant sections based on document type.
+
+## Design Principles
+
+1. **DRY**: Extract repeated content once, reference everywhere
+2. **Consistency**: Single source of truth for Constitution checks
+3. **Modularity**: Each component is self-contained
+4. **Versioned**: Components track Constitution version
+
+---
+
+[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md

@@ -0,0 +1,125 @@
+# Constitution Check Template Component
+
+> **Purpose**: Shared Constitution compliance check section for PRD/EPIC/TECH_DESIGN templates
+> **Version**: 1.0.0
+> **Reference**: `.claude/rules/project-constitution.md` (v2.1.0)
+
+---
+
+## Usage
+
+Include this component in templates via reference:
+```markdown
+{{INCLUDE: _shared/CONSTITUTION_CHECK.md}}
+```
+
+Or copy relevant sections based on document type.
+
+---
+
+## Constitution Check (宪法符合性检查)
+
+*GATE: 必须在下一阶段前通过*
+
+### Article I: Quality First (质量至上)
+
+- [ ] **I.1 - NO PARTIAL IMPLEMENTATION**: 内容完整且明确？无占位符和模糊表述？
+- [ ] **I.2 - Testing Mandate**: 测试策略明确？覆盖率目标 ≥80%？
+- [ ] **I.3 - No Simplification**: 避免"暂时简化，后续完善"的描述？
+- [ ] **I.4 - Quality Gates**: 验收标准具体、可测试、可衡量？
+
+### Article II: Architectural Consistency (架构一致性)
+
+- [ ] **II.1 - NO CODE DUPLICATION**: 识别可复用的现有系统和组件？
+- [ ] **II.2 - Consistent Naming**: 命名约定遵循现有代码库模式？
+- [ ] **II.3 - Anti-Over-Engineering**: 解决方案适合问题规模？无过度设计？
+- [ ] **II.4 - Single Responsibility**: 清晰的边界和职责划分？
+
+### Article III: Security First (安全优先)
+
+- [ ] **III.1 - NO HARDCODED SECRETS**: 定义了密钥管理策略（环境变量/密钥服务）？
+- [ ] **III.2 - Input Validation**: 输入验证需求明确？
+- [ ] **III.3 - Least Privilege**: 身份验证/授权机制清晰？
+- [ ] **III.4 - Secure by Default**: 数据加密策略定义？
+
+### Article IV: Performance Accountability (性能责任)
+
+- [ ] **IV.1 - NO RESOURCE LEAKS**: 考虑了资源管理（连接、文件句柄等）？
+- [ ] **IV.2 - Algorithm Efficiency**: 性能目标现实且可测量？
+- [ ] **IV.3 - Lazy Loading**: 按需加载策略规划？
+- [ ] **IV.4 - Caching Strategy**: 规划了监控和缓存策略？
+
+### Article V: Maintainability (可维护性)
+
+- [ ] **V.1 - NO DEAD CODE**: 避免不必要的功能？仅实现明确需求？
+- [ ] **V.2 - Separation of Concerns**: 代码易于理解和修改？
+- [ ] **V.3 - Documentation**: 文档完整（架构、API、配置）？
+- [ ] **V.4 - File Size Limits**: 遵循单一职责原则？单文件 ≤500行？
+
+### Article VI: Test-First Development (测试优先开发)
+
+- [ ] **VI.1 - TDD Mandate**: TDD 流程明确定义？
+- [ ] **VI.2 - Test Independence**: 测试隔离策略定义？
+- [ ] **VI.3 - Meaningful Tests**: 测试质量标准明确？
+
+### Article X: Requirement Boundary (需求边界)
+
+- [ ] **X.1 - Forced Clarification**: 所有不明确之处标记 `[NEEDS CLARIFICATION]`？
+- [ ] **X.2 - No Speculative Features**: 无"可能需要"、"未来会"、"建议添加"的功能？
+- [ ] **X.3 - User Story Independence**: 每个故事有明确优先级和独立测试标准？
+
+---
+
+## Phase -1 Gates (前置闸门)
+
+*仅适用于 EPIC/TECH_DESIGN*
+
+### Simplicity Gate (Article VII)
+
+- [ ] **项目数量**: 使用 ≤3 个项目/模块？
+- [ ] **NO FUTURE-PROOFING**: 没有为"未来可能需要"的功能做准备？
+- [ ] **Minimal Dependencies**: 只使用必需的依赖库？
+
+### Anti-Abstraction Gate (Article VIII)
+
+- [ ] **Framework Trust**: 直接使用框架功能，没有封装？
+- [ ] **Single Model Representation**: 实体只有一种数据表示？
+- [ ] **No Unnecessary Interfaces**: 没有单一实现的接口？
+
+### Integration-First Gate (Article IX)
+
+- [ ] **Contracts Defined First**: API contracts 在实现前定义？
+- [ ] **Contract Tests Planned**: Contract tests 在 Phase 2 计划？
+- [ ] **Real Environment**: 使用真实数据库而非 mocks？
+
+---
+
+## Constitutional Violations (宪法违规记录)
+
+*仅在有需要说明的宪法违规时填写*
+
+**重要**: 任何违规都必须有充分理由，否则文档不通过
+
+| 违规的 Article | 具体违规内容 | 为何需要 | 缓解措施 |
+|----------------|-------------|----------|----------|
+| {{ARTICLE_NUM}} | {{VIOLATION_DETAIL}} | {{JUSTIFICATION}} | {{MITIGATION}} |
+
+---
+
+## Gate Status Summary
+
+| Gate | Status | Notes |
+|------|--------|-------|
+| Article I-V Core | {{PASS/FAIL}} | {{NOTES}} |
+| Article VI TDD | {{PASS/FAIL}} | {{NOTES}} |
+| Article VII Simplicity | {{PASS/FAIL}} | {{NOTES}} |
+| Article VIII Anti-Abstraction | {{PASS/FAIL}} | {{NOTES}} |
+| Article IX Integration-First | {{PASS/FAIL}} | {{NOTES}} |
+| Article X Boundary | {{PASS/FAIL}} | {{NOTES}} |
+
+**Overall Status**: {{PASS/FAIL}}
+**Ready for Next Phase**: {{YES/NO}}
+
+---
+
+[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md

@@ -0,0 +1,187 @@
+# Validation Checklist Template Component
+
+> **Purpose**: Shared validation checklist section for all spec templates
+> **Version**: 1.0.0
+> **Usage**: Include relevant sections based on document type
+
+---
+
+## Usage
+
+Include this component in templates via reference:
+```markdown
+{{INCLUDE: _shared/VALIDATION_CHECKLIST.md#prd}}
+{{INCLUDE: _shared/VALIDATION_CHECKLIST.md#epic}}
+{{INCLUDE: _shared/VALIDATION_CHECKLIST.md#tech}}
+{{INCLUDE: _shared/VALIDATION_CHECKLIST.md#ui}}
+```
+
+---
+
+## Common Validation Items
+
+### Content Completeness
+
+- [ ] 所有必需章节已填写
+- [ ] 没有 {{PLACEHOLDER}} 未替换
+- [ ] 没有 TODO 或 TBD 标记
+- [ ] 所有引用的文件存在
+
+### Quality Standards
+
+- [ ] 语言清晰、无歧义
+- [ ] 格式一致、结构清晰
+- [ ] 无重复内容
+- [ ] 无矛盾描述
+
+### Constitution Compliance
+
+- [ ] 通过所有宪法检查
+- [ ] 违规已文档化并说明理由
+- [ ] 安全要求符合 NO HARDCODED SECRETS
+- [ ] 质量要求符合 NO PARTIAL IMPLEMENTATION
+
+---
+
+## PRD-Specific Validation {#prd}
+
+### 需求不扩散验证
+
+- [ ] **NO SPECULATION**: 所有功能都由用户明确提出或必需
+- [ ] **ALL CLARIFIED**: 没有未解决的 [NEEDS CLARIFICATION] 标记
+- [ ] **NO TECH DETAILS**: 没有技术实现细节（API, 数据库, 框架等）
+- [ ] **STORY INDEPENDENCE**: 每个故事都有 Independent Test 标准
+- [ ] **PRIORITY ASSIGNED**: 所有故事都有明确优先级 (P1, P2, P3...)
+- [ ] **MVP IDENTIFIED**: P1 故事能够作为独立 MVP 交付
+
+### 用户故事质量 (INVEST 原则)
+
+- [ ] **Independent**: 每个故事可独立交付和测试
+- [ ] **Negotiable**: 细节可以讨论，实现方式灵活
+- [ ] **Valuable**: 有明确的用户/业务价值
+- [ ] **Estimable**: 可以估算工作量
+- [ ] **Small**: 可在一个迭代内完成
+- [ ] **Testable**: 有明确的验收标准和测试方法
+
+### 验收标准质量
+
+- [ ] 使用 Given-When-Then 格式
+- [ ] 包含正常流程（Happy Path）
+- [ ] 包含边界情况（Edge Cases）
+- [ ] 包含错误场景（Error Handling）
+- [ ] 具体且可测试（非模糊描述）
+
+---
+
+## EPIC-Specific Validation {#epic}
+
+### PRD 对齐
+
+- [ ] 所有用户故事已映射到 Epic
+- [ ] 所有验收标准已包含
+- [ ] 成功指标与 PRD 一致
+- [ ] 技术约束已考虑
+
+### 技术方案完整性
+
+- [ ] 架构设计清晰
+- [ ] 数据模型完整
+- [ ] API 契约定义
+- [ ] 技术栈选型合理
+
+### TDD 准备
+
+- [ ] Phase 2 明确定义为"Tests First"
+- [ ] TEST VERIFICATION CHECKPOINT 已标记
+- [ ] 测试策略明确
+- [ ] Phase 3 依赖 Phase 2 完成
+
+### 可执行性
+
+- [ ] 实施阶段清晰
+- [ ] 依赖已识别
+- [ ] 资源需求明确
+- [ ] 风险已评估
+
+---
+
+## TECH_DESIGN-Specific Validation {#tech}
+
+### 技术完整性
+
+- [ ] **Section 1**: System Architecture - Complete
+- [ ] **Section 2**: Technology Stack - Complete with versions
+- [ ] **Section 3**: Data Model Design - Complete
+- [ ] **Section 4**: API Design - Complete
+- [ ] **Section 5**: Security Design - Complete
+- [ ] **Section 6**: Performance Design - Complete
+- [ ] **Section 7**: Constitution Check - Complete
+
+### 技术规范
+
+- [ ] 所有技术都有具体版本号
+- [ ] 所有表都有主键和关系定义
+- [ ] 所有 API 端点都有请求/响应 schema
+- [ ] 所有密钥使用环境变量
+
+### Baseline Adherence
+
+- [ ] 所有 baseline 技术已复用
+- [ ] 所有新技术都有 PRD 需求支撑
+- [ ] 无不必要的重构
+
+---
+
+## UI_PROTOTYPE-Specific Validation {#ui}
+
+### Anti-Generic-Design
+
+- [ ] 无占位图片（所有图片使用 Picsum URL）
+- [ ] 无常见 AI 紫色/蓝色配色
+- [ ] 无 Emoji 图标（使用 SVG 或图标库）
+- [ ] 无 Lorem Ipsum 占位文本
+
+### 设计系统
+
+- [ ] 色彩系统完整（主/辅/中性/状态）
+- [ ] 字体系统支持中英文混排
+- [ ] 间距系统基于统一基准
+- [ ] 响应式断点定义（至少 3 个）
+
+### 交互完整性
+
+- [ ] SPA 路由系统正常工作
+- [ ] 所有按钮/链接有点击交互
+- [ ] 表单有验证逻辑
+- [ ] 模态框可打开/关闭
+
+### 响应式
+
+- [ ] 在 320px 宽度下页面可用
+- [ ] 在 768px 宽度下页面可用
+- [ ] 在 1280px 宽度下页面可用
+- [ ] 所有 Touch Targets ≥ 44px
+
+---
+
+## Progress Tracking
+
+### 完成状态
+
+- [ ] 所有必需章节完成
+- [ ] Constitution Check 通过
+- [ ] 质量检查通过
+
+### 闸门状态
+
+| Gate | Status |
+|------|--------|
+| Constitution Check | {{PASS/FAIL}} |
+| Completeness | {{PASS/FAIL}} |
+| Quality | {{PASS/FAIL}} |
+
+**Ready for Next Phase**: {{YES/NO}}
+
+---
+
+[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md