cc-devflow 2.5.0 → 4.1.1

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

@@ -1,183 +0,0 @@
----
-name: flow-epic
-description: 'Generate Epic and Tasks breakdown. Usage: /flow-epic "REQ-123" or /flow-epic'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  setup: .claude/scripts/setup-epic.sh
-  validate_constitution: .claude/scripts/validate-constitution.sh
-agent_scripts:
-  sh: .claude/scripts/update-agent-context.sh __AGENT__
-  ps: scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__
-skills:
-  tdd: .claude/skills/flow-tdd/SKILL.md
----
-
-# Flow-Epic - Epic 和任务规划命令
-
-## Bite-Sized Tasks 原则
-
-任务必须足够小：
-
-```yaml
-Task 粒度规范:
-  - 每个 step 2-5 分钟可完成
-  - "Write the failing test" = 1 step
-  - "Run it to make sure it fails" = 1 step
-  - "Implement minimal code to pass" = 1 step
-  - "Run tests and verify" = 1 step
-  - "Commit" = 1 step
-
-Task 内容规范:
-  - 精确的文件路径 (不是 "update the config")
-  - 完整的代码片段 (不是 "add validation")
-  - 精确的命令 + 期望输出
-  - 明确的验收标准
-
-Bad Task Examples:
-  ❌ "Implement user authentication"
-  ❌ "Add validation"
-  ❌ "Update the API"
-
-Good Task Examples:
-  ✅ "Create src/auth/login.ts with LoginRequest interface"
-  ✅ "Write failing test: POST /api/login returns 401 for invalid credentials"
-  ✅ "Run npm test -- --grep 'login' and verify test fails"
-  ✅ "Implement login handler to pass the test"
-```
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID?"
-```
-空输入时根据当前分支或 `DEVFLOW_REQ_ID` 自动解析；如果无法解析必须直接报错。
-
-## 命令格式
-```text
-/flow-epic "REQ_ID"
-/flow-epic             # Auto-detect from current branch
-```
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. Requirement ID
-   → Provided: use argument
-   → Else: run {SCRIPT:prereq} --json --paths-only
-   → Missing: ERROR "No requirement ID found."
-
-2. 结构校验
-   → 需求目录、EXECUTION_LOG.md、orchestration_status.json 必须存在
-   → PRD.md 完整且无 {{PLACEHOLDER}}
-   → 研究产物（/flow-init 输出）：
-      • research/research.md (研究摘要，Decision/Rationale/Alternatives 格式)
-      • research/tasks.json (研究任务列表)
-   → 技术产物（/flow-tech 输出）：
-      • TECH_DESIGN.md (技术方案总纲) ⭐ planner 必读
-      • research/codebase-tech-analysis.md (代码库技术分析)
-      • data-model.md (数据模型定义)
-      • contracts/ (API 契约目录，至少 1 个文件)
-      • quickstart.md (快速启动指南)
-   → 状态校验：
-      • orchestration_status.phase0_complete == true (研究阶段完成)
-      • orchestration_status.phase1_complete == true (技术设计完成)
-
-3. 状态检查
-   → status ∈ {tech_design_complete, epic_generation_failed}
-   → 已存在 EPIC.md 或 TASKS.md → WARN 并询问是否覆盖
-
-4. Constitution Gate
-   → Run: {SCRIPT:validate_constitution} --type prd --severity error --json
-   → 若有 ERROR 级违规 → 停止
-
-5. Checklist Gate (如果 checklists/ 存在)
-   → Run: node .claude/hooks/checklist-gate.js --req-id {REQ_ID} --json
-   → 若 status == "FAIL" 且无 --skip-gate:
-      • ERROR: 显示完成度不足提示
-      • 建议: "Run /flow-checklist --status to review incomplete items"
-   → 若 --skip-gate 提供:
-      • 验证 --reason 参数存在
-      • Run: node .claude/hooks/checklist-gate.js --req-id {REQ_ID} --skip --reason "{reason}"
-      • 审计日志记录到 EXECUTION_LOG.md
-   → 若 status == "PASS" 或 "SKIPPED": 继续
-   → 若 checklists/ 不存在: 跳过此检查 (Checklist 可选)
-```
-
-### 阶段 2: Epic/TASKS 初始化
-```
-1. 执行 {SCRIPT:setup} --json
-   → 返回 EPIC_FILE, TASKS_FILE, reqId, title
-2. 加载模板
-   → EPIC_TEMPLATE.md、TASKS_TEMPLATE.md
-3. 写入 orchestration_status
-   → status = "epic_generation_in_progress"
-   → phase = "planning"
-4. EXECUTION_LOG.md 追加启动记录
-```
-
-### 阶段 3: Planner Agent
-```
-Agent Prompt 要点：
-- Inputs:
-   • PRD.md
-   • TECH_DESIGN.md
-   • research/research.md (决策)
-   • data-model.md
-   • contracts/ (OpenAPI/GraphQL)
-   • quickstart.md (测试环境/命令)
-   • research/codebase-tech-analysis.md
-   • UI_PROTOTYPE.html (若存在)
-- Must:
-   • 执行 Phase -1 Gates (Simplicity / Anti-Abstraction / Integration-First)
-   • 按模板输出 EPIC.md (含 Success Metrics、Phase 2 Tests First、Complexity Tracking)
-   • 生成单一 TASKS.md：
-       - Phase 1 Setup → Phase 2 Foundational → Phase 3+ User Stories → Final Polish
-       - Phase 2 列出所有 contract/integration tests（引用 contracts/ 路径）
-       - Phase 3+ 依据 data-model 分配实体、依据 contracts 分配端点
-       - 引用 quickstart 中的命令作为测试/验证步骤
-       - 使用 `[US#]`、`[P]` 标签，包含精确文件路径
-       - 插入 “⚠️ TEST VERIFICATION CHECKPOINT” 于 Phase 2 与 Phase 3 之间
-   • Dependencies、Parallel Execution、Implementation Strategy 必须填写
-   • Constitution Check per phase
-```
-
-### 阶段 4: Exit Gate
-```
-1. 文件存在
-   → EPIC_FILE, TASKS_FILE
-
-2. EPIC.md 结构
-   → 包含 Technical Approach、Phase 2 Tests First、Complexity Tracking、Constitution Check
-   → 无 {{PLACEHOLDER}}
-
-3. TASKS.md 结构
-   → Phase 顺序正确 (Setup → Foundational → US… → Polish)
-   → Phase 2 在 Phase 3 前且包含 contract tests
-   → “⚠️ TEST VERIFICATION CHECKPOINT” 位于 Phase 2 与 Phase 3 之间
-   → 任务格式 `- [ ] T### [P?] [US#?] Description with file path`
-
-4. 依赖覆盖
-   → 数据模型任务与 data-model.md 一致
-   → API 任务覆盖 contracts/
-   → Tests 引用 quickstart 与 contracts
-
-5. 状态更新
-   → orchestration_status:
-        status = "epic_complete"
-        completedSteps append "epic"
-   → EXECUTION_LOG.md 记录完成时间
-```
-
-## 错误处理
-- 缺少任一必需产物 → 直接返回 ERROR 提示回到 `/flow-tech`。
-- Planner 生成失败 → 标记 `epic_generation_failed`，用户可修正后重试。
-- Constitution 校验不通过 → 输出违规项并终止。
-
-## 输出
-- `EPIC.md`: 包含范围、成功指标、TDD 阶段、复杂度跟踪。
-- `TASKS.md`: 单文件任务清单，按 user story 独立测试，引用 data-model、contracts、quickstart。
-
-## 后续建议
-1. 审阅任务依赖和并行策略。
-2. 立即运行 `/flow-dev` 进入实现，确保 Phase 2 Tests 先落地。
-3. 若新增技术栈，回到 `research/tasks.json` 更新研究状态并同步 agent context。

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

@@ -1,370 +0,0 @@
----
-name: flow-init
-description: 'Initialize requirement structure. Usage: /flow-init "REQ-123|Title|URLs"'
-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
-templates:
-  flow: .claude/docs/templates/INIT_FLOW_TEMPLATE.md
-  research: .claude/docs/templates/RESEARCH_TEMPLATE.md
-  brainstorm: .claude/docs/templates/BRAINSTORM_TEMPLATE.md
-guides:
-  troubleshoot: .claude/docs/guides/INIT_TROUBLESHOOTING.md
-skills:
-  brainstorming: .claude/skills/flow-brainstorming/SKILL.md
----
-
-<!-- ============================================================
-     头文件引用语法规范 (Header File Reference Syntax)
-     ============================================================
-
-命令头文件格式:
-```yaml
-scripts:
-  create: .claude/scripts/create-requirement.sh
-templates:
-  flow: .claude/docs/templates/INIT_FLOW_TEMPLATE.md
-guides:
-  troubleshoot: .claude/docs/guides/INIT_TROUBLESHOOTING.md
-```
-
-引用语法:
-- {SCRIPT:create}      → 执行 .claude/scripts/create-requirement.sh
-- {TEMPLATE:flow}      → 加载 .claude/docs/templates/INIT_FLOW_TEMPLATE.md
-- {GUIDE:troubleshoot} → 参考 .claude/docs/guides/INIT_TROUBLESHOOTING.md
-
-使用案例:
-```markdown
-# 正文中遇到:
-→ Run: {SCRIPT:create} "REQ-123" --title "User Auth"
-# 解释为:
-→ 执行命令: bash .claude/scripts/create-requirement.sh "REQ-123" --title "User Auth"
-
-# 正文中遇到:
-→ 详见 {TEMPLATE:flow} Stage 2.5
-# 解释为:
-→ 打开并阅读 .claude/docs/templates/INIT_FLOW_TEMPLATE.md 中的 Stage 2.5 章节
-
-# 正文中遇到:
-→ 遇到问题参考 {GUIDE:troubleshoot}
-# 解释为:
-→ 打开并阅读 .claude/docs/guides/INIT_TROUBLESHOOTING.md
-```
-
-规则: 遇到 {TYPE:key} 占位符时，去头文件 YAML 中找对应类型的 key，获取文件路径并执行/加载。
-============================================================ -->
-
-# Flow-Init - 需求初始化命令
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID|TITLE|PLAN_URLS?" 或 --interactive
-```
-
-**格式**:
-- REQ_ID: `^(REQ|BUG)-[0-9]+$` (例如: REQ-123, BUG-456)
-- TITLE: 需求简短标题
-- PLAN_URLS: 计划文档URL，多个用逗号分隔 (可选)
-
-**示例**:
-```
-/flow-init "REQ-123|User Authentication"
-/flow-init "REQ-124|数据导出|https://docs.example.com/export-spec.md"
-/flow-init --interactive
-```
-
----
-
-## 执行前加载
-
-**详细流程**:
-→ 参见 `{TEMPLATE:flow}` 获取完整执行流程
-
-**研究模板**:
-→ 参见 `{TEMPLATE:research}` 了解研究文档格式
-
-**故障排查**:
-→ 遇到问题参考 `{GUIDE:troubleshoot}`
-
----
-
-## 执行流程
-
-### Stage 1: Entry Gate (参数验证)
-
-```
-1. 解析参数: REQ_ID|TITLE|PLAN_URLS
-   → 验证 REQ_ID 格式: ^(REQ|BUG)-[0-9]+$
-   → 提取 TITLE 和 PLAN_URLS
-   → 若 TITLE 含中文/非ASCII，使用模型意译生成 BRANCH_TITLE_EN（英文语义翻译，禁止拼音/音译）
-   → BRANCH_TITLE_EN 仅用于分支名，文档标题仍使用原始 TITLE
-   → 若意译不确定或未生成 ASCII 结果，向用户确认英文分支标题
-
-2. 前置条件检查
-   → Run: {SCRIPT:prereq} --json --paths-only
-   → 检查 Git 状态是否干净
-   → 验证 devflow/ 目录存在
-
-3. 目录唯一性检查
-   → 确认 devflow/requirements/${REQ_ID}/ 不存在
-   → 如果存在 → ERROR (使用 --force 强制覆盖)
-
-4. 验证通过 → 继续 Stage 1.5
-```
-
----
-
-### Stage 1.2: Git Branch Creation
-
-```
-创建功能分支:
-→ Requirements: feature/${REQ_ID}-${slug(BRANCH_TITLE_EN)}
-→ Bug Fixes:    bugfix/${BUG_ID}-${slug(BRANCH_TITLE_EN)}
-
-Where BRANCH_TITLE_EN = TITLE 的英文意译 (语义为准，非拼音，使用模型意译)
-      slug() = lowercase, replace spaces/special chars with hyphens
-```
-
----
-
-### Stage 1.5: Context Loading (路线图与架构)
-
-**目标**: 理解需求在项目中的位置
-
-```
-检查 ROADMAP.md 和 ARCHITECTURE.md:
-→ 如果存在: 加载上下文，展示需求位置
-→ 如果不存在: 提示可选运行 /core-roadmap
-
-→ 详见 {TEMPLATE:flow} Stage 1.5
-```
-
-**输出**: 显示需求在路线图和架构中的位置 (如果可用)
-
----
-
-### Stage 2: Directory Initialization
-
-```
-创建需求目录结构:
-→ Run: {SCRIPT:create} "${REQ_ID}" --title "${TITLE}" --branch-title "${BRANCH_TITLE_EN}" --json (如有)
-
-生成文件:
-- devflow/requirements/${REQ_ID}/README.md
-- devflow/requirements/${REQ_ID}/EXECUTION_LOG.md
-- devflow/requirements/${REQ_ID}/orchestration_status.json
-- devflow/requirements/${REQ_ID}/research/ (目录)
-
-→ 详见 {TEMPLATE:flow} Stage 2
-```
-
----
-
-### Stage 2.3: Brainstorming (North Star Capture)
-
-**目标**: 捕捉需求的原始意图，确保后续流程有明确的「北极星」可追溯
-
-**Iron Law**: `NO FLOW EXECUTION WITHOUT BRAINSTORM ALIGNMENT`
-
-```
-触发 flow-brainstorming skill:
-→ 参见 {SKILL:brainstorming} 了解完整流程
-
-执行步骤:
-1. Understanding the Idea
-   → 一次问一个问题，不要压垮用户
-   → 优先多选题，更容易回答
-   → 理解: 目的、约束、成功标准
-
-2. Exploring Approaches
-   → 提出 2-3 种方案及取舍
-   → 给出推荐方案和理由
-   → 让用户做最终决策
-
-3. Presenting the Design
-   → 分段呈现设计 (200-300 字/段)
-   → 每段后确认是否正确
-   → 涵盖: 架构、组件、数据流、测试
-
-4. Documentation
-   → 使用 {TEMPLATE:brainstorm} 模板
-   → 输出: devflow/requirements/${REQ_ID}/BRAINSTORM.md
-   → 必须包含: 原始需求、核心问题、成功标准、方案探索、最终决策
-
-Rationalization Prevention:
-| Excuse | Reality |
-|--------|---------|
-| "需求已经很清楚了" | Brainstorm 确保没有遗漏假设 |
-| "用户赶时间" | 头脑风暴节省后续返工时间 |
-| "这是小需求" | 小需求也有核心问题和成功标准 |
-
-Red Flags - STOP:
-→ 跳过问问题直接开始做
-→ 没有记录方案取舍就选定
-→ 没有写 BRAINSTORM.md 就进入下一阶段
-```
-
-**输出**: `devflow/requirements/${REQ_ID}/BRAINSTORM.md`
-
-**验证**:
-- [ ] BRAINSTORM.md 存在
-- [ ] 包含「原始需求」章节 (用户原话)
-- [ ] 包含「成功标准」章节
-- [ ] 包含「方案探索」章节 (2-3种)
-- [ ] 包含「最终决策」章节
-
----
-
-### Stage 2.5: Research (Subagent Mandatory)
-
-**目标**: 研究默认必跑，但将“研究型内容”隔离到 subagent，避免主会话上下文耗尽。
-
-**Iron Law**: 大内容落盘，主会话只返回「决策摘要 + 文件路径」。
-
-#### ✅ Mandatory: Call `flow-researcher` Subagent
-
-> subagent 负责内部/外部研究、落盘、任务回填、研究整合与质量验证；主 agent 只做编排与最终 Gate。
-
-```
-Task tool call:
-  description: "Run mandatory research for /flow-init (file-based memory)"
-  subagent_type: "flow-researcher"
-  model: "inherit"
-  prompt: (JSON)
-    {
-      "reqId": "${REQ_ID}",
-      "reqDir": "devflow/requirements/${REQ_ID}",
-      "title": "${TITLE}",
-      "planUrls": ["..."],
-      "contextFiles": {
-        "brainstorm": "devflow/requirements/${REQ_ID}/BRAINSTORM.md",
-        "roadmap": "devflow/ROADMAP.md",
-        "architecture": "devflow/ARCHITECTURE.md"
-      }
-    }
-```
-
-**期望输出** (由 subagent 写入):
-- `devflow/requirements/${REQ_ID}/research/internal/codebase-overview.md`
-- `devflow/requirements/${REQ_ID}/research/mcp/$(date +%Y%m%d)/**`
-- `devflow/requirements/${REQ_ID}/research/research-summary.md`
-- `devflow/requirements/${REQ_ID}/research/tasks.json` (decision/rationale/alternatives 完整)
-- `devflow/requirements/${REQ_ID}/research/research.md` (可通过 validate-research)
-
----
-
-### Stage 2.6: Research Consolidation
-
-> 该阶段由 `flow-researcher` subagent 执行（包含 tasks 生成/回填/整合/校验）。
-
-主 agent 在 Exit Gate 中只做最终验证与状态更新：
-- Run: `{SCRIPT:validate_research} "${REQ_DIR}" --strict`
-- `orchestration_status.json.phase0_complete = true`
-
----
-### Stage 3: README Generation
-
-```
-生成工作流指南:
-→ devflow/requirements/${REQ_ID}/README.md
-→ 包含: 需求概述、工作流步骤、检查清单
-```
-
----
-
-### Stage 4: Exit Gate (5-Level Quality Check)
-
-**5层验证**:
-
-```
-Level 1: File Existence Check
-→ 验证所有必需文件已创建
-
-Level 2: Research.md Structure Validation
-→ Run: {SCRIPT:validate_research} "${REQ_DIR}" --strict
-→ 检查 research.md 结构
-
-Level 3: Research.md Content Quality
-→ 无 TODO/FIXME/{{PLACEHOLDER}} 标记
-→ 每个 Decision block 完整
-
-Level 4: Research Tasks Validation
-→ 验证 tasks.json 格式和内容
-
-Level 5: Git & Status & Constitution
-→ Git 分支创建成功
-→ orchestration_status.json 正确
-→ Constitution 符合性检查
-
-→ 详见 {TEMPLATE:flow} Stage 4
-```
-
----
-
-## 输出产物
-
-### Requirements
-
-```
-devflow/requirements/${REQ_ID}/
-├── README.md
-├── BRAINSTORM.md               # 需求的北极星 (Stage 2.3)
-├── 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(BRANCH_TITLE_EN)}`
-- **Status**: orchestration_status.json.status = "initialized"
-- **Phase**: orchestration_status.json.phase = "planning"
-
----
-
-## 错误处理
-
-**常见错误**:
-→ 详见 `{GUIDE:troubleshoot}`
-
-**主要错误场景**:
-1. Invalid REQ_ID format → 检查格式
-2. REQ_ID already exists → 使用不同 ID 或 --force
-3. Git status not clean → commit/stash changes
-4. Research validation failed → 手动补充 research.md
-5. MCP fetch failed → 继续但标记待补项
-
-**恢复步骤**:
-→ 详见 `{GUIDE:troubleshoot}` Recovery Procedures
-
----
-
-## Next Step
-
-```
-/flow-prd "${REQ_ID}"
-```
-
-生成产品需求文档
-
----
-
-**Related Documentation**:
-- [INIT_FLOW_TEMPLATE.md](../.claude/docs/templates/INIT_FLOW_TEMPLATE.md) - 详细执行流程
-- [INIT_TROUBLESHOOTING.md](../.claude/docs/guides/INIT_TROUBLESHOOTING.md) - 故障排查指南
-- [RESEARCH_TEMPLATE.md](../.claude/docs/templates/RESEARCH_TEMPLATE.md) - 研究模板格式