cc-devflow 2.5.0 → 4.1.1

package/.claude/commands/flow-new.md

@@ -1,442 +0,0 @@
----
-name: flow-new
-description: 'One-shot requirement flow. Usage: /flow-new "REQ-123|支持用户下单|https://plan.example.com/Q1"'
-templates:
-  orchestration: .claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md
-guides:
-  troubleshoot: .claude/docs/guides/NEW_TROUBLESHOOTING.md
----
-
-<!-- ============================================================
-     头文件引用语法规范 (Header File Reference Syntax)
-     ============================================================
-
-命令头文件格式:
-```yaml
-templates:
-  orchestration: .claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md
-guides:
-  troubleshoot: .claude/docs/guides/NEW_TROUBLESHOOTING.md
-```
-
-引用语法:
-- {TEMPLATE:orchestration} → 加载 .claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md
-- {GUIDE:troubleshoot}     → 参考 .claude/docs/guides/NEW_TROUBLESHOOTING.md
-
-使用案例:
-```markdown
-# 正文中遇到:
-→ 详见 {TEMPLATE:orchestration} Stage 4
-# 解释为:
-→ 打开并阅读 .claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md 中的 Stage 4 章节
-
-# 正文中遇到:
-→ 常见错误参见 {GUIDE:troubleshoot} Error 3
-# 解释为:
-→ 打开并阅读 .claude/docs/guides/NEW_TROUBLESHOOTING.md 中的 Error 3 章节
-```
-
-规则: 遇到 {TYPE:key} 占位符时，去头文件 YAML 中找对应类型的 key，获取文件路径并加载。
-============================================================ -->
-
-# Flow-New - 一键需求开发流
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID|TITLE|PLAN_URLS?"
-```
-
-**格式**:
-- REQ_ID: 需求编号 (例如: REQ-123)
-- TITLE: 需求标题
-- PLAN_URLS: 计划文档URL，多个用逗号分隔 (可选)
-
-**示例**:
-```
-/flow-new "REQ-123|支持用户下单|https://plan.example.com/Q1"
-/flow-new "REQ-124|用户权限管理"
-```
-
----
-
-## 执行前加载
-
-**详细编排流程**:
-→ 参见 `{TEMPLATE:orchestration}` 获取完整编排逻辑
-
-**故障排查**:
-→ 遇到问题参考 `{GUIDE:troubleshoot}`
-
----
-
-## 架构说明
-
-**设计理念**: flow-new 是**编排器**（Orchestrator），串行调用 7-8 个阶段化命令
-
-**调用链** (v2.1.0 更新):
-```
-/flow-new "REQ-123|Title|URLs"
-  ↓
-[1/9] /flow-init "REQ-123|Title|URLs"
-      → 包含 Brainstorming，生成 BRAINSTORM.md ⭐ v2.1.0
-  ↓
-[2/9] /flow-prd "REQ-123"
-      → 需要 BRAINSTORM.md 对齐检查 ⭐ v2.1.0
-  ↓
-[2.3/9] /flow-checklist "REQ-123" (可选, 80%门禁)
-  ↓
-[2.5/9] /flow-ui "REQ-123" (条件触发)
-  ↓
-[2.7/9] /flow-tech "REQ-123" (必需)
-  ↓
-[3/9] /flow-epic "REQ-123"
-      → bite-sized tasks (2-5分钟/任务) ⭐ v2.1.0
-  ↓
-[4/9] /flow-dev "REQ-123"
-      → TDD Checkpoint (测试必须先 FAIL) ⭐ v2.1.0
-  ↓
-[5/9] /flow-review "REQ-123" ⭐ v2.1.0 新增
-      → Two-Stage Review (Spec → Quality)
-  ↓
-[6/9] /flow-qa "REQ-123" --full
-  ↓
-[7/9] /flow-release "REQ-123"
-      → 分支完成决策 ⭐ v2.1.0
-```
-
----
-
-## 执行流程骨架
-
-### [1/9] 初始化 → /flow-init
-
-```
-调用: /flow-init "${REQ_ID}|${TITLE}|${PLAN_URLS}"
-
-检查: orchestration_status.json.status === "initialized"
-
-→ 详见 {TEMPLATE:orchestration} Stage 1
-```
-
-**输出**:
-- Git分支: `feature/${REQ_ID}-${slug(BRANCH_TITLE_EN)}`
-- 需求目录已创建
-- 研究材料已抓取
-- **BRAINSTORM.md** (需求北极星) ⭐ v2.1.0 新增
-
-> BRANCH_TITLE_EN 为 TITLE 的英文意译 (语义为准，非拼音，使用模型意译)
-
----
-
-### [2/9] PRD生成 → /flow-prd
-
-```
-调用: /flow-prd "${REQ_ID}"
-
-检查:
-  - BRAINSTORM.md 存在 ⭐ v2.1.0 新增
-  - PRD.md 存在且完整
-  - BRAINSTORM 对齐检查通过 ⭐ v2.1.0 新增
-
-→ 详见 {TEMPLATE:orchestration} Stage 2
-```
-
-**输出**:
-- PRD.md (用户故事 + GWT验收标准)
-- Constitution检查通过
-
----
-
-### [2.3/9] 需求质量检查 → /flow-checklist (可选)
-
-```
-触发条件: quality-rules.yml 中 checklist_gate_enabled: true
-
-调用: /flow-checklist "${REQ_ID}"
-
-闸门: 完成度 ≥ 80%
-
-→ 详见 {TEMPLATE:orchestration} Stage 2.3
-```
-
----
-
-### [2.5/9] UI原型生成 → /flow-ui (条件触发)
-
-```
-触发条件 (任一满足):
-  - PRD包含UI关键词 ("页面"/"表单"/"按钮" etc.)
-  - 项目包含 package.json 或 src/components/
-  - 用户显式请求
-
-调用: /flow-ui "${REQ_ID}"
-
-→ 详见 {TEMPLATE:orchestration} Stage 2.5 (包含 UI Detection Logic)
-```
-
-**输出** (如有UI需求):
-- UI_PROTOTYPE.html (响应式单文件原型)
-- research/ui_design_strategy.md
-
-**跳过** (无UI需求):
-- orchestration_status.json.ui_skipped = true
-
----
-
-### [2.7/9] 技术方案设计 → /flow-tech (必需)
-
-```
-调用: /flow-tech "${REQ_ID}"
-
-检查: TECH_DESIGN.md 完整 (所有 Section 1-7)
-
-→ 详见 {TEMPLATE:orchestration} Stage 2.7
-```
-
-**输出**:
-- TECH_DESIGN.md (完整技术方案)
-- data-model.md (数据模型)
-- contracts/openapi.yaml (API契约)
-- quickstart.md (快速开始)
-
----
-
-### [3/9] Epic规划 → /flow-epic
-
-```
-调用: /flow-epic "${REQ_ID}"
-
-检查:
-  - EPIC.md + TASKS.md 存在
-  - TASKS 覆盖 TECH_DESIGN.md 所有技术层
-  - 任务粒度: 2-5分钟/任务 (bite-sized) ⭐ v2.1.0
-
-→ 详见 {TEMPLATE:orchestration} Stage 3
-```
-
-**输出**:
-- EPIC.md (Epic描述)
-- TASKS.md (单文件管理所有任务，bite-sized)
-
----
-
-### [4/9] 开发执行 → /flow-dev
-
-```
-调用: /flow-dev "${REQ_ID}"
-
-执行模式: TDD (Tests First)
-  Phase 1: 分析现有代码
-  Phase 2: 编写测试 (Tests First)
-  ⚠️ TDD CHECKPOINT (测试必须先 FAIL) ⭐ v2.1.0
-  Phase 3: 实现代码
-  Phase 4: 测试验证 (测试必须通过)
-  Phase 5: Git提交并标记完成
-
-→ 详见 {TEMPLATE:orchestration} Stage 4
-```
-
-**输出**:
-- 实现代码
-- 测试代码
-- TASKS.md 更新 (checkbox 标记)
-- Git commits (每个任务一个)
-
----
-
-### [5/9] 代码审查 → /flow-review ⭐ v2.1.0 新增
-
-```
-调用: /flow-review "${REQ_ID}"
-
-Two-Stage Review:
-  Stage 1: Spec Compliance (规格合规)
-    → 不信任实现者报告，读代码验证
-    → 检查 scope creep
-    → BRAINSTORM 对齐检查
-  Stage 2: Code Quality (代码质量)
-    → 仅在 Stage 1 通过后执行
-    → 测试质量、Constitution 合规
-
-→ 详见 flow-review.md
-```
-
-**输出**:
-- SPEC_REVIEW.md (Stage 1)
-- CODE_QUALITY_REVIEW.md (Stage 2)
-
----
-
-### [6/9] 质量保证 → /flow-qa
-
-```
-调用: /flow-qa "${REQ_ID}" --full
-
-Exit Gate检查:
-  - ✅ 所有测试通过
-  - ✅ 代码覆盖率 ≥ 80%
-  - ✅ 无高危安全问题
-  - ✅ TypeScript类型检查通过
-
-→ 详见 {TEMPLATE:orchestration} Stage 5
-```
-
-**输出**:
-- TEST_PLAN.md
-- TEST_REPORT.md
-- SECURITY_PLAN.md
-- SECURITY_REPORT.md
-
----
-
-### [7/9] 发布管理 → /flow-release
-
-```
-调用: /flow-release "${REQ_ID}"
-
-执行:
-  - 分支完成决策 (FF merge / PR / Squash / Cleanup) ⭐ v2.1.0
-  - 生成发布计划
-  - 更新 CLAUDE.md (如有重要架构变更)
-  - 最终构建
-  - 创建 GitHub Pull Request
-
-→ 详见 {TEMPLATE:orchestration} Stage 6
-```
-
-**输出**:
-- RELEASE_PLAN.md
-- CLAUDE.md (更新技术架构，如有)
-- GitHub Pull Request
-
----
-
-## 进度展示
-
-**实时进度** (详见 `{TEMPLATE:orchestration}` Progress Display Format):
-
-```
-🎯 CC-DevFlow 完整需求开发流程 (v2.1.0)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-需求: REQ-123 | 支持用户下单
-
-[1/9] ✅ 初始化完成 (含 Brainstorming)
-[2/9] ✅ PRD生成完成 (BRAINSTORM 对齐)
-[2.5/9] ✅ UI原型生成完成 ⚡️
-[2.7/9] ✅ 技术方案设计完成 🔧
-[3/9] ✅ Epic规划完成 (bite-sized tasks)
-[4/9] 🔄 开发执行中... (8/18 已完成)
-[5/9] ⏳ 等待代码审查... ⭐ 新增
-[6/9] ⏳ 等待质量保证...
-[7/9] ⏳ 等待发布管理...
-```
-
----
-
-## 输出产物
-
-**完整目录结构** (详见 `{TEMPLATE:orchestration}` Output Structure):
-
-```
-devflow/requirements/${REQ_ID}/
-├── BRAINSTORM.md ⭐ v2.1.0 新增
-├── research/ (初始化时生成)
-├── PRD.md
-├── UI_PROTOTYPE.html (条件)
-├── TECH_DESIGN.md
-├── data-model.md
-├── contracts/openapi.yaml
-├── quickstart.md
-├── EPIC.md
-├── TASKS.md (bite-sized, checkbox 标记)
-├── SPEC_REVIEW.md ⭐ v2.1.0 新增
-├── CODE_QUALITY_REVIEW.md ⭐ v2.1.0 新增
-├── TEST_PLAN.md + TEST_REPORT.md
-├── SECURITY_PLAN.md + SECURITY_REPORT.md
-└── RELEASE_PLAN.md
-```
-
----
-
-## 中断与恢复
-
-```bash
-# 查看当前状态
-/flow-status REQ-123
-
-# 从中断点恢复
-/flow-restart "REQ-123"
-
-# 或手动执行特定阶段
-/flow-tech "REQ-123"
-/flow-epic "REQ-123"
-/flow-dev "REQ-123" --resume
-```
-
----
-
-## 错误处理
-
-**常见错误**:
-→ 详见 `{GUIDE:troubleshoot}`
-
-**主要错误场景**:
-1. Stage command not found → 检查命令文件
-2. Status file corrupted → 重建或修复
-3. 中途中断无法恢复 → 使用 /flow-restart
-4. UI detection false positive → 在PRD明确标注
-5. Epic 未覆盖所有技术层 → 重新生成或手动补充
-6. QA gate failure → 补充测试/修复安全问题
-7. Build failure → 修复类型错误
-8. PR creation failed → 认证 gh CLI 或手动创建
-
-**恢复步骤**:
-→ 详见 `{GUIDE:troubleshoot}` Recovery Procedures
-
----
-
-## 使用建议
-
-### ✅ 适合使用 flow-new
-
-- 简单明确的需求
-- 演示和学习工作流程
-- 快速原型开发
-- 熟悉的需求类型
-
-### ❌ 建议使用阶段化命令
-
-- 复杂需求，需要每个阶段审查
-- 需要在PRD阶段与需求方确认
-- 需要在Epic阶段调整任务分解
-- 开发过程中可能需要暂停调整
-
----
-
-## Next Step
-
-```
-# 查看PR状态
-cat devflow/requirements/${REQ_ID}/RELEASE_PLAN.md | grep "PR URL"
-
-# 审查PR
-gh pr view <PR_NUMBER>
-
-# 合并PR
-gh pr merge <PR_NUMBER>
-```
-
----
-
-**Related Documentation**:
-- [NEW_ORCHESTRATION_TEMPLATE.md](../.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md) - 详细编排流程
-- [NEW_TROUBLESHOOTING.md](../.claude/docs/guides/NEW_TROUBLESHOOTING.md) - 故障排查指南
-- [flow-init.md](./flow-init.md) - 初始化阶段 (含 Brainstorming)
-- [flow-review.md](./flow-review.md) - 代码审查阶段 ⭐ v2.1.0 新增
-- [flow-dev.md](./flow-dev.md) - 开发阶段 (TDD Checkpoint)
-- [flow-fix.md](./flow-fix.md) - Bug 修复流程 ⭐ v2.1.0 增强
-
----
-
-**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/commands/flow-prd.md

@@ -1,144 +0,0 @@
----
-name: flow-prd
-description: 'Generate Product Requirements Document. Usage: /flow-prd "REQ-123" or /flow-prd'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  validate_research: .claude/scripts/validate-research.sh
-  validate_constitution: .claude/scripts/validate-constitution.sh
-  verify_gate: .claude/scripts/verify-gate.sh
----
-
-# Flow-PRD - PRD 生成命令
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID?"
-```
-若未提供则根据当前分支或 `DEVFLOW_REQ_ID` 自动解析。
-
-## 命令格式
-```text
-/flow-prd "REQ_ID"
-/flow-prd             # Auto-detect from current branch
-```
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. 解析 REQ_ID
-   → If argument provided: use it
-   → Else: run {SCRIPT:prereq} --json --paths-only
-   → If仍为空: ERROR "No requirement ID found."
-
-2. Brainstorm Alignment Check (新增)
-   → 读取 devflow/requirements/${REQ_ID}/BRAINSTORM.md
-   → 验证存在且包含必需章节:
-      • 原始需求
-      • 核心问题定义
-      • 成功标准
-      • 方案探索
-      • 最终决策
-   → 缺少 BRAINSTORM.md → ERROR "BRAINSTORM.md missing. Run /flow-init brainstorming."
-   → 加载「原始意图」作为 PRD 生成的北极星
-
-3. 校验目录
-   → 使用 {SCRIPT:prereq} --json 获取路径
-   → 必须存在:
-      • devflow/requirements/${REQ_ID}/
-      • BRAINSTORM.md 
-      • EXECUTION_LOG.md
-      • orchestration_status.json (phase0_complete == true)
-      • research/research.md
-      • research/tasks.json
-   → 缺少任何研究产物 → ERROR "Research artifacts missing. Run /flow-init consolidation."
-
-   **研究材料质量验证** (新增 - 2025-01-26):
-   → Run: {SCRIPT:validate_research} "${REQ_DIR}" --strict
-   → 验证 research.md 质量（5-Level 检查）:
-      • LEVEL 1: research.md 文件存在
-      • LEVEL 2: 必需章节完整 (Research Summary, Decisions)
-      • LEVEL 3: 无 TODO/PLACEHOLDER 占位符
-      • LEVEL 4: tasks.json 格式有效
-      • LEVEL 5: Constitution 合规
-   → 验证失败 → ERROR "research.md quality check failed. Fix issues before /flow-prd."
-
-   **CRITICAL**: 如果 research.md 包含 "TODO - fill decision outcome"，
-   说明 /flow-init 的研究任务未完成。prd-writer 无法使用不完整的研究材料。
-
-   **Fix Options**:
-     1. 手动填充 research/tasks.json 的 decision/rationale/alternatives 字段
-     2. 重新运行 consolidate-research.sh
-     3. 直接编辑 research/research.md 补充决策内容
-     4. 参考 .claude/docs/templates/RESEARCH_TEMPLATE.md 模板
-
-4. PRD 覆盖提示
-   → 若 PRD.md 已存在 → WARN 并确认是否覆盖
-
-5. 状态校验
-   → orchestration_status.status ∈ {"initialized", "prd_generation_failed"}
-   → 否则提示按流程顺序执行
-```
-
-### 阶段 2: 生成准备
-```
-1. Load PRD 模板 (.claude/docs/templates/PRD_TEMPLATE.md)
-2. 汇总上下文:
-   → research/research.md（Decision/Rationale/Alternatives）
-   → research/internal/codebase-overview.md
-   → research/mcp/*.md（如有）
-3. 更新 orchestration_status:
-   → status = "prd_generation_in_progress"
-   → phase = "planning"
-4. EXECUTION_LOG.md 记录启动条目
-```
-
-### 阶段 3: 调用 prd-writer Agent
-```
-Prompt 关键要点:
-  - 输入: REQ_ID, Title, research 集合, PRD 模板
-  - 要求:
-      • 按模板 Execution Flow 输出背景、目标、用户故事 (GWT)、NFR、技术约束、成功指标
-      • 记录 Constitution Check，确保无硬编码密钥、无部分实现
-      • 验证清单必须填写
-  - 输出: 完整 PRD.md
-  - 日志: log_event "${REQ_ID}" "PRD generation completed"
-```
-
-### 阶段 4: Exit Gate
-```
-1. 文件存在
-   → PRD.md 必须生成
-
-2. 结构检查
-   → 无 {{PLACEHOLDER}}
-   → 包含: 背景/目标、用户故事+GWT、NFR、技术约束、成功指标、Constitution Check、验证清单
-
-3. 宪法校验
-   → Run: {SCRIPT:validate_constitution} --type prd --severity warning
-   → 出现 ERROR 级违规时终止
-
-4. 状态更新
-   → orchestration_status:
-        status = "prd_complete"
-        phase = "epic_planning"
-        completedSteps append "prd"
-   → EXECUTION_LOG.md 记录完成
-```
-
-## 输出
-```
-✅ PRD.md (≥100 行、完整模板)
-✅ orchestration_status.json 更新 (prd_complete)
-✅ EXECUTION_LOG.md 记录
-```
-
-## 错误处理
-- 缺少研究产物 → 返回指令让用户重复 `/flow-init` consolidation。
-- PRD 生成失败 → 将 status 设为 `prd_generation_failed`，方便重试。
-- 宪法检查失败 → 显示违规列表并终止，待修复后重跑。
-
-## 下一步
-1. 审阅 PRD.md，确认需求准确。
-2. 运行 `/flow-tech` 生成技术方案及 data-model/contracts/quickstart。
-3. 使用 `/flow-epic` 做 Epic/TASKS 规划。

package/.claude/commands/flow-qa.md

@@ -1,93 +0,0 @@
----
-name: flow-qa
-description: 'Execute quality assurance and security review. Usage: /flow-qa "REQ-123" or /flow-qa'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  check_tasks: .claude/scripts/check-task-status.sh
-  validate_constitution: .claude/scripts/validate-constitution.sh
----
-
-# Flow-QA - 质量保证命令
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID?"
-```
-未提供则根据当前分支或 `DEVFLOW_REQ_ID` 自动解析。
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. 解析 REQ_ID
-2. {SCRIPT:prereq} --json 验证:
-   → 存在 PRD.md、TECH_DESIGN.md、data-model.md、contracts/、quickstart.md、EPIC.md、TASKS.md
-   → orchestration_status.status ∈ {"development_complete", "qa_failed"}
-   → phase1_complete == true
-3. {SCRIPT:check_tasks} --json 确认 remaining == 0
-4. quickstart.md 中的测试命令必须全部通过（先 dry-run）
-5. TEST_REPORT.md / SECURITY_REPORT.md 已存在时提示是否覆盖
-```
-
-### 阶段 2: QA 准备
-```
-1. 执行 quickstart 中的覆盖率命令（如有）
-2. 收集上下文:
-   → PRD 用户故事、验收标准
-   → TECH_DESIGN 决策（安全、性能）
-   → data-model / contracts
-   → TASKS DoD、提交记录
-3. 更新 orchestration_status:
-   → status = "qa_in_progress"
-   → phase = "quality_assurance"
-4. EXECUTION_LOG.md 记录 QA 启动（含测试覆盖率）
-```
-
-### 阶段 3: Agents
-```
-1. qa-tester
-   → 输入: PRD, TECH_DESIGN, TASKS, test results, coverage
-   → 产出: TEST_PLAN.md (如缺失) / TEST_REPORT.md
-   → 覆盖内容: 覆盖率、TDD 合规、AC 覆盖、DoD 复核、缺失测试建议
-
-2. security-reviewer
-   → 输入: TECH_DESIGN 安全节、contracts、实现 diff、ENV/secret 配置
-   → 产出: SECURITY_PLAN.md (如缺失) / SECURITY_REPORT.md
-   → 检查: 认证/授权、输入验证、敏感信息、依赖风险、基础设施配置
-
-3. 可选: performance-reviewer（若 TECH_DESIGN 有性能方案）
-```
-
-### 阶段 4: Exit Gate
-```
-1. 验证报告存在:
-   → TEST_REPORT.md、SECURITY_REPORT.md
-2. 质量结论:
-   → 所有 gate (Coverage、TDD、Security) 均为 PASS；否则状态设为 qa_failed
-3. 宪法检查:
-   → {SCRIPT:validate_constitution} --type qa --severity warning
-4. 状态更新:
-   → orchestration_status.status = "qa_complete"
-   → completedSteps append "qa"
-   → lastQaAt = timestamp
-5. EXECUTION_LOG 记录完成
-```
-
-## 输出
-```
-✅ TEST_REPORT.md
-✅ SECURITY_REPORT.md
-✅ （可选）PERFORMANCE_REPORT.md
-✅ orchestration_status.json 更新 (qa_complete)
-✅ EXECUTION_LOG.md QA 记录
-```
-
-## 错误处理
-- quickstart 测试失败 → 返回错误并保持 qa_failed。
-- 报告中存在 BLOCKER → 阶段终止，需返回 `/flow-dev` 修复。
-- Constitution 违规 → 将问题标记为阻断项。
-
-## 下一步
-1. 处理 QA 报告中的问题（若有）。
-2. 确认验证通过后运行 `/flow-release`。
-3. 将报告随 PR 一并提交，供代码审阅与发布审批使用。