cc-devflow 1.0.1

package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md

@@ -0,0 +1,213 @@
+# Flow-Init Execution Flow Template
+
+> Detailed stages for `/flow-init` requirement initialization
+
+<!-- ============================================================
+     调用上下文声明 (Invocation Context Declaration)
+     ============================================================
+
+本模板由 `/flow-init` 命令通过 {TEMPLATE:flow} 引用加载。
+
+模板中的 {SCRIPT:xxx} 占位符引用 flow-init.md 头文件中的 scripts 定义：
+```yaml
+# 来源: .claude/commands/flow-init.md 头文件
+scripts:
+  create: .claude/scripts/create-requirement.sh
+  prereq: .claude/scripts/check-prerequisites.sh
+  research_tasks: .claude/scripts/generate-research-tasks.sh
+  populate_tasks: .claude/scripts/populate-research-tasks.sh
+  consolidate: .claude/scripts/consolidate-research.sh
+  validate_research: .claude/scripts/validate-research.sh
+```
+
+占位符解析:
+- {SCRIPT:prereq}           → bash .claude/scripts/check-prerequisites.sh
+- {SCRIPT:create}           → bash .claude/scripts/create-requirement.sh
+- {SCRIPT:research_tasks}   → bash .claude/scripts/generate-research-tasks.sh
+- {SCRIPT:populate_tasks}   → bash .claude/scripts/populate-research-tasks.sh
+- {SCRIPT:consolidate}      → bash .claude/scripts/consolidate-research.sh
+- {SCRIPT:validate_research} → bash .claude/scripts/validate-research.sh
+============================================================ -->
+
+---
+
+## Stage 1: Entry Gate (参数验证)
+
+```bash
+# 1. 解析参数
+REQ_ID|TITLE|PLAN_URLS → 验证 REQ_ID 格式: ^(REQ|BUG)-[0-9]+$
+
+# 2. 前置条件检查
+bash {SCRIPT:prereq} --json --paths-only
+→ Git 状态干净 + devflow/ 目录存在
+
+# 3. 目录唯一性检查
+→ 确认 devflow/requirements/${REQ_ID}/ 不存在
+```
+
+---
+
+## Stage 1.5: Context Loading (路线图与架构)
+
+**目标**: 理解需求在项目中的位置
+
+```bash
+# 检查 ROADMAP.md 和 ARCHITECTURE.md
+→ 如果存在: 加载上下文，展示需求位置
+→ 如果不存在: 提示可选运行 /core-roadmap (不阻塞执行)
+```
+
+---
+
+## Stage 2: Directory Initialization
+
+```bash
+# 创建需求目录
+bash {SCRIPT:create} "${REQ_ID}" --title "${TITLE}" --json
+
+# 生成文件
+devflow/requirements/${REQ_ID}/
+├── README.md
+├── EXECUTION_LOG.md
+├── orchestration_status.json
+└── research/ (空目录)
+```
+
+---
+
+## Stage 2.5: Research (MCP Mandatory Flow)
+
+**目标**: 收集"真实材料"，所有步骤 **MANDATORY**
+
+### S0: Internal Codebase Research (必需)
+```bash
+→ 分析现有代码库
+→ 生成 research/internal/codebase-overview.md
+```
+
+### Task 1-5: External Learning Materials (MCP)
+```
+1. Official Documentation (Context7)
+   → research/mcp/$(date +%Y%m%d)/official/
+
+2. Domain Tutorials (Web Search)
+   → research/mcp/$(date +%Y%m%d)/guides/
+
+3. Core Materials (WebFetch)
+   → research/mcp/$(date +%Y%m%d)/tutorials/
+
+4. Case Studies/Examples (Web Search + WebFetch)
+   → research/mcp/$(date +%Y%m%d)/examples/
+
+5. Summary & Recommendations
+   → research/research-summary.md
+```
+
+---
+
+## Stage 2.6: Research Consolidation
+
+```bash
+# 1. Generate research tasks
+bash {SCRIPT:research_tasks} "${REQ_DIR}"
+→ Output: research/tasks.json
+
+# 2. Populate task decisions
+bash {SCRIPT:populate_tasks} "${REQ_DIR}"
+→ Fill decision/rationale/alternatives from research
+
+# 3. Consolidate research
+bash {SCRIPT:consolidate} "${REQ_DIR}"
+→ Output: research/research.md
+→ Format: Decision/Rationale/Alternatives/Source
+
+# 4. Update status
+orchestration_status.json.phase0_complete = true
+```
+
+---
+
+## Stage 3: Git Branch Creation
+
+```bash
+# 创建功能分支
+Requirements: feature/${REQ_ID}-${slug(title)}
+Bug Fixes:    bugfix/${BUG_ID}-${slug(title)}
+
+# slug() = lowercase, replace spaces/special chars with hyphens
+```
+
+---
+
+## Stage 4: README Generation
+
+```bash
+# 生成工作流指南
+→ devflow/requirements/${REQ_ID}/README.md
+→ 包含: 需求概述、工作流步骤、检查清单
+```
+
+---
+
+## Stage 5: Exit Gate (5-Level Quality Check)
+
+### Level 1: File Existence Check
+```bash
+→ 验证所有必需文件已创建
+```
+
+### Level 2: Research.md Structure Validation
+```bash
+bash {SCRIPT:validate_research} "${REQ_DIR}"
+→ 检查 research.md 结构
+```
+
+### Level 3: Research.md Content Quality
+```bash
+→ 无 TODO/FIXME/{{PLACEHOLDER}} 标记
+→ 每个 Decision block 完整
+```
+
+### Level 4: Research Tasks Validation
+```bash
+→ 验证 tasks.json 格式和内容
+```
+
+### Level 5: Git & Status & Constitution
+```bash
+→ Git 分支创建成功
+→ orchestration_status.json 正确
+→ Constitution 符合性检查
+```
+
+---
+
+## Output Structure
+
+```
+devflow/requirements/${REQ_ID}/
+├── README.md
+├── research/
+│   ├── internal/
+│   │   └── codebase-overview.md
+│   ├── mcp/
+│   │   └── $(date +%Y%m%d)/
+│   │       ├── official/
+│   │       ├── guides/
+│   │       ├── tutorials/
+│   │       └── examples/
+│   ├── research.md
+│   ├── research-summary.md
+│   └── tasks.json
+├── EXECUTION_LOG.md
+└── orchestration_status.json
+```
+
+**Git**:
+- Branch: `feature/${REQ_ID}-${slug(title)}`
+- Status: orchestration_status.json.status = "initialized"
+- Phase: orchestration_status.json.phase = "planning"
+
+---
+
+**Last Updated**: 2025-12-19

package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md

@@ -0,0 +1,57 @@
+# Requirement Clarification for {{INTENT_SUMMARY}}
+
+> **Session ID**: {{SESSION_ID}}
+> **Timestamp**: {{TIMESTAMP}}
+> **Round**: {{CLARIFICATION_ROUND}}/{{MAX_ROUNDS}}
+
+---
+
+## Current Understanding:
+
+### 📊 Analysis Summary
+- **Domain**: {{IDENTIFIED_DOMAIN}}
+- **Target Users**: {{TARGET_USERS}}
+- **Core Function**: {{MAIN_PURPOSE}}
+- **Complexity**: {{COMPLEXITY_LEVEL}}
+- **Confidence**: {{CONFIDENCE_PERCENTAGE}}%
+
+### 🎯 Key Information Collected
+{{COLLECTED_INFORMATION}}
+
+### ❓ Information Gaps
+{{MISSING_INFORMATION}}
+
+---
+
+## Critical Questions (Please answer to proceed):
+
+{{#QUESTIONS}}
+### {{QUESTION_NUMBER}}. {{QUESTION_TEXT}}
+
+**Why this matters**: {{EXPLANATION}}
+
+**Examples**: {{HELPFUL_EXAMPLES}}
+
+**Your answer**: _[Please provide your response here]_
+
+---
+{{/QUESTIONS}}
+
+## Next Steps:
+
+{{NEXT_ACTION_DESCRIPTION}}
+
+### Progress Indicator:
+```text
+[{{PROGRESS_BAR}}] {{PROGRESS_PERCENTAGE}}% complete
+```
+
+### Estimated Information Completeness:
+- ✅ **Core Definition**: {{CORE_COMPLETENESS}}%
+- {{#FUNCTIONAL_SCOPE_STATUS}}{{FUNCTIONAL_SCOPE_STATUS}}{{/FUNCTIONAL_SCOPE_STATUS}} **Functional Scope**: {{FUNCTIONAL_COMPLETENESS}}%
+- {{#TECHNICAL_CONTEXT_STATUS}}{{TECHNICAL_CONTEXT_STATUS}}{{/TECHNICAL_CONTEXT_STATUS}} **Technical Context**: {{TECHNICAL_COMPLETENESS}}%
+- {{#VALIDATION_STATUS}}{{VALIDATION_STATUS}}{{/VALIDATION_STATUS}} **Validation Criteria**: {{VALIDATION_COMPLETENESS}}%
+
+---
+
+**Tip**: The more specific your answers, the better I can help create a comprehensive PRD that meets your needs.

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

@@ -0,0 +1,148 @@
+# Flow-New Orchestration Template
+
+> Execution flow for `/flow-new` one-shot requirement development
+
+---
+
+## Stage Execution Skeleton
+
+### [1/8] /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
+
+### [2.7/8] /flow-tech (必需)
+- 生成 TECH_DESIGN.md (7 sections: 架构/技术栈/数据模型/API/安全/性能/部署)
+- 输出: data-model.md + contracts/openapi.yaml + quickstart.md
+- Exit Gate: 所有 Section 1-7 完整
+
+### [3/8] /flow-epic
+- Entry Gate: Checklist 完成度 ≥ 80% (如果启用)
+- 生成 EPIC.md + TASKS.md
+- 验证: TASKS 覆盖 TECH_DESIGN.md 所有技术层
+
+### [4/8] /flow-dev
+**TDD 执行模式**:
+```
+Phase 1: 分析现有代码
+Phase 2: 编写测试 (Tests First)
+  ↓
+TEST VERIFICATION CHECKPOINT → 测试必须先失败
+  ↓
+Phase 3: 实现代码
+Phase 4: 测试验证 → 测试必须通过
+Phase 5: Git 提交并标记完成
+```
+- 输出: 实现代码 + 测试代码 + tasks/*.completed
+
+### [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
+
+---
+
+## Progress Display Format
+
+```
+🎯 CC-DevFlow 完整需求开发流程
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+需求: 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] ⏳ 等待发布管理...
+```
+
+**状态图标**:
+- ✅ 已完成
+- 🔄 执行中
+- ⏳ 等待执行
+- ⚡️ 条件触发已执行
+- 🔧 必需步骤已完成
+
+---
+
+## 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
+├── tasks/*.completed             # [4/8]
+├── TEST_REPORT.md                # [5/8]
+├── SECURITY_REPORT.md
+└── RELEASE_PLAN.md               # [6/8]
+```
+
+---
+
+## Status Tracking
+
+**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,
+  "dev_complete": true,
+  "qa_complete": false,
+  "release_complete": false
+}
+```
+
+---
+
+**Last Updated**: 2025-12-19