cc-devflow 4.1.5 → 4.1.6

package/.claude/docs/guides/NEW_TROUBLESHOOTING.md

@@ -1,6 +1,6 @@
-# Flow-New Troubleshooting Guide
+# Mainline Troubleshooting Guide
 
-> Quick reference for `/flow-new` errors and recovery
+> Quick reference for canonical `/flow:*` delivery errors and recovery.
 
 ---
 
@@ -8,144 +8,92 @@
 
 ### E1: Stage Command Not Found
 ```bash
-❌ ERROR: Command /flow-init not found
+❌ ERROR: Command /flow:init not found
 ```
-**Fix**: `ls .claude/commands/flow-*.md` → 检查缺失文件 → `git checkout HEAD -- .claude/commands/`
-
----
+**Fix**: 检查 `.claude/commands/flow/` 是否完整；确认当前分支已同步最新命令目录。
 
 ### E2: Status File Corrupted
 ```bash
 ❌ ERROR: Invalid orchestration_status.json
 ```
 **Diagnose**: `jq . devflow/requirements/REQ-123/orchestration_status.json`
-**Fix**: 从模板重建或 `/flow-restart "REQ-123"`
-
----
+**Fix**: 重建状态文件后执行 `/flow:status "REQ-123"` 并从建议阶段恢复。
 
 ### E3: Interrupted, Cannot Resume
 ```bash
-❌ ERROR: Requirement REQ-123 already exists
-```
-**Diagnose**: `/flow-status REQ-123`
-**Fix**: `/flow-restart "REQ-123"` 或手动从特定阶段继续
-
----
-
-### E4: UI Detection False Positive
-```bash
-✅ UI原型生成完成 (但项目是纯后端)
+❌ ERROR: development_in_progress but checkpoint missing
 ```
-**Fix**: 在 PRD.md 开头添加 `## 项目类型声明\n**纯后端 API 项目**，无 UI 需求。`
-
----
+**Diagnose**: `/flow:status "REQ-123"`
+**Fix**: `/flow:dev "REQ-123" --resume`
 
-### E5: Epic 未覆盖所有技术层
+### E4: Task Manifest Missing
 ```bash
-⚠️ WARNING: TASKS.md 未覆盖 TECH_DESIGN.md 所有层
+❌ ERROR: TASKS.md not found
 ```
-**Diagnose**: `grep "## Section" devflow/requirements/REQ-123/TECH_DESIGN.md`
-**Fix**: 手动补充缺失任务或重新生成 `/flow-epic "REQ-123"`
-
----
+**Fix**: 重新执行 `/flow:spec "REQ-123"` 生成规划产物。
 
-### E6: QA Gate Failure
+### E5: Verify Gate Failure
 ```bash
-❌ 代码覆盖率: 65% (要求 ≥ 80%)
-❌ 安全问题: 2 个高危漏洞
+❌ Coverage below threshold
+❌ High severity security issue
 ```
 **Fix**:
-- 补充测试: `npm test -- --coverage --verbose` → 识别未覆盖模块
-- 修复漏洞: 查看 `SECURITY_REPORT.md` → 修复代码 → 重新运行 `/flow-qa "REQ-123" --full`
-
----
-
-### E7: Build Failure
-```bash
-❌ error TS2345: Argument of type 'string | undefined'...
-```
-**Fix**: `npm run typecheck` → 修复类型错误 → `npm run build`
-
----
+- 修复代码与测试后重跑 `/flow:verify "REQ-123" --strict`
+- 通过后再执行 `/flow:release "REQ-123"`
 
-### E8: PR Creation Failed
+### E6: Release Blocked
 ```bash
-❌ gh pr create: HTTP 403: Resource not accessible
+❌ Missing strict verify report-card
 ```
-**Fix**: `gh auth login` → 重新认证 → `/flow-release "REQ-123"`
+**Fix**: 先执行 `/flow:verify "REQ-123" --strict`，再执行 `/flow:release "REQ-123"`。
 
 ---
 
 ## Recovery Procedures
 
-### Complete Restart
+### Full Rebuild
 ```bash
 rm -rf devflow/requirements/REQ-123/
-git branch -D feature/REQ-123-*
-/flow-new "REQ-123|Title|URLs"
+/flow:init "REQ-123|Title|URLs"
+/flow:spec "REQ-123"
+/flow:dev "REQ-123"
+/flow:verify "REQ-123" --strict
 ```
 
-### Partial Resume (从特定任务继续)
+### Resume From Current Stage
 ```bash
-# 检查任务状态
-bash .claude/scripts/check-task-status.sh --verbose
-
-# 从特定任务继续
-/flow-dev "REQ-123" --task T008
+/flow:status "REQ-123"
+/flow:dev "REQ-123" --resume
 ```
 
-### State File Rebuild
+### State File Rebuild (Minimal)
 ```bash
 REQ_DIR="devflow/requirements/REQ-123"
-HAS_PRD=$([ -f "$REQ_DIR/PRD.md" ] && echo true || echo false)
-HAS_TECH=$([ -f "$REQ_DIR/TECH_DESIGN.md" ] && echo true || echo false)
-
-# 重建状态文件
-cat > $REQ_DIR/orchestration_status.json <<EOF
+cat > "$REQ_DIR/orchestration_status.json" <<EOF_JSON
 {
   "reqId": "REQ-123",
-  "status": "$( [ "$HAS_TECH" = "true" ] && echo "tech_complete" || echo "prd_complete" )",
-  "prd_complete": $HAS_PRD,
-  "tech_design_complete": $HAS_TECH,
-  "epic_complete": false,
-  "dev_complete": false
+  "status": "spec_complete",
+  "phase": "planning",
+  "spec_complete": true,
+  "development_complete": false,
+  "quality_complete": false,
+  "release_complete": false
 }
-EOF
-
-jq . $REQ_DIR/orchestration_status.json  # 验证
-/flow-restart "REQ-123"
-```
+EOF_JSON
 
----
-
-## Configuration
-
-### Environment Variables
-| Variable | Default | Purpose |
-|----------|---------|---------|
-| `SKIP_UI_DETECTION` | `false` | 强制跳过 UI 生成 |
-| `COVERAGE_THRESHOLD` | `80` | 代码覆盖率要求 |
-| `FLOW_DEBUG` | `false` | 启用调试日志 |
-
-### Command-Line Flags
-```bash
-/flow-new "REQ-123|..." --skip-ui         # 跳过 UI
-/flow-new "REQ-123|..." --resume          # 恢复执行
+jq . "$REQ_DIR/orchestration_status.json"
+/flow:status "REQ-123"
 ```
 
 ---
 
 ## FAQ
 
-**Q: 可以在 flow-new 执行中暂停吗？**
-A: Ctrl+C 中断 → `/flow-status REQ-123` 查看状态 → `/flow-restart "REQ-123"` 恢复
-
-**Q: 如何从特定阶段重新开始？**
-A: 使用对应阶段命令重新执行，如 `/flow-prd "REQ-123"` 或 `/flow-epic "REQ-123"`
+**Q: 如何从特定阶段重启？**  
+A: 用 `/flow:status` 先确认状态，然后执行对应阶段命令（通常是 `/flow:dev --resume` 或 `/flow:verify --strict`）。
 
-**Q: flow-new 支持 BUG 修复吗？**
-A: 不支持，BUG 使用 `/flow-fix "BUG-456|描述"`
-
----
+**Q: 什么时候需要重跑 `/flow:spec`？**  
+A: `TASKS.md` 缺失、规格有重大变更、或 manifest 与实现明显漂移时。
 
-**Last Updated**: 2025-12-19
+**Q: 可以继续使用 `/flow-new` 吗？**  
+A: 不建议。`/flow-new` 仅兼容保留，主链是 `/flow:init -> /flow:spec -> /flow:dev -> /flow:verify -> /flow:release`。

package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md

@@ -46,7 +46,7 @@
 ```bash
 ⚠️ WARNING: RM-005 依赖 REQ-008 但该需求未完成
 ```
-**Fix**: `/flow-status REQ-008` → 确认状态 → 继续但标记风险 或 移除该依赖
+**Fix**: `/flow:status REQ-008` → 确认状态 → 继续但标记风险 或 移除该依赖
 
 ---
 

package/.claude/docs/guides/TASK_COMPLETION_MARKING.md

@@ -2,7 +2,7 @@
 
 ## 问题描述
 
-在执行 `/flow-dev` 时，主代理完成了代码实现，但没有同步更新 TASKS.md 中的待办事项复选框。这导致：
+在执行 `/flow:dev` 时，主代理完成了代码实现，但没有同步更新 TASKS.md 中的待办事项复选框。这导致：
 
 - ❌ TASKS.md 显示任务未完成 `[ ]`，但代码已经实现
 - ❌ 进度追踪不准确，无法知道真实进度
@@ -13,7 +13,7 @@
 
 ### 1. 强制执行标记流程
 
-在 `/flow-dev` 命令文档中，已经强化了任务完成标记的要求：
+在 `/flow:dev` 命令文档中，已经强化了任务完成标记的要求：
 
 ```bash
 # 每完成一个任务后，必须立即执行
@@ -73,7 +73,7 @@ bash .claude/scripts/sync-task-marks.sh --dry-run
 
 ```bash
 # 1. 开始开发
-/flow-dev "REQ-123"
+/flow:dev "REQ-123"
 
 # 2. Claude 完成任务 T001
 #    (写代码、运行测试等)
@@ -223,7 +223,7 @@ bash .claude/scripts/sync-task-marks.sh --auto-mark
 2. **使用脚本**: 始终用脚本，不要手动编辑 TASKS.md
 3. **验证输出**: 检查脚本输出确认标记成功
 4. **定期检查**: 在开发过程中定期运行 `sync-task-marks.sh --dry-run`
-5. **Exit Gate**: 在 `/flow-dev` 结束前验证所有任务已标记
+5. **Exit Gate**: 在 `/flow:dev` 结束前验证所有任务已标记
 
 ### DON'T ❌
 
@@ -333,6 +333,6 @@ bash .claude/tests/scripts/test_sync_task_marks.sh
 
 - [mark-task-complete.sh 源码](.claude/scripts/mark-task-complete.sh)
 - [sync-task-marks.sh 源码](.claude/scripts/sync-task-marks.sh)
-- [/flow-dev 命令文档](.claude/commands/flow-dev.md)
+- [/flow:dev 命令文档](.claude/commands/flow/dev.md)
 - [TASKS_TEMPLATE.md 模板](.claude/docs/templates/TASKS_TEMPLATE.md)
 - [测试框架](.claude/tests/test-framework.sh)

package/.claude/docs/templates/ATTEMPT_TEMPLATE.md

@@ -146,7 +146,7 @@ LIMIT 20 OFFSET 40
 
 | | research/attempts/ | ERROR_LOG.md |
 |--|-------------------|--------------|
-| 阶段 | 研究阶段（Phase 0） | 执行阶段（flow-dev, flow-qa） |
+| 阶段 | 研究阶段（Phase 0） | 执行阶段（flow:dev, flow:verify） |
 | 内容 | 方案尝试与放弃 | 代码错误与修复 |
 | 格式 | Markdown 文件 | 结构化错误日志 |
 | 目的 | 避免重复研究 | 避免重复错误 |

package/.claude/docs/templates/BACKLOG_TEMPLATE.md

@@ -201,7 +201,7 @@ _说明: 此矩阵用于快速识别需求间的依赖关系，避免优先级
 
 ### 准入标准 (Definition of Ready)
 
-一个 backlog item 准备好进入开发 (运行 /flow-init) 的标准：
+一个 backlog item 准备好进入开发 (运行 /flow:init) 的标准：
 - [ ] Description 清晰明确
 - [ ] Business Value 已明确
 - [ ] Effort 已评估
@@ -213,9 +213,9 @@ _说明: 此矩阵用于快速识别需求间的依赖关系，避免优先级
 ### 完成标准 (Definition of Done)
 
 一个 backlog item 被认为完成的标准：
-- [ ] 通过 /flow-prd, /flow-tech, /flow-epic, /flow-dev 流程
+- [ ] 通过 /flow:init, /flow:spec, /flow:dev 流程
 - [ ] 所有 TASKS.md 中的任务完成
-- [ ] 通过 /flow-qa (测试 + 安全审查)
+- [ ] 通过 /flow:verify (测试 + 安全审查)
 - [ ] 代码已合并到主分支
 - [ ] 文档已更新
 - [ ] 用户验收通过

package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md

@@ -162,15 +162,15 @@ No outstanding items.
 {{#ALL_RESOLVED}}
 ✅ **Clarification complete**. All critical ambiguities have been resolved.
 
-Recommended next command: `/flow-prd {{REQ_ID}}`
+Recommended next command: `/flow:spec {{REQ_ID}}`
 {{/ALL_RESOLVED}}
 
 {{#HAS_OUTSTANDING}}
 ⚠️ **Clarification partially complete**. Some low-impact items remain.
 
 Options:
-1. Proceed with `/flow-prd {{REQ_ID}}` (acceptable risk)
-2. Re-run `/flow-clarify {{REQ_ID}}` after planning phase
+1. Proceed with `/flow:spec {{REQ_ID}}` (acceptable risk)
+2. Re-run `/flow:spec {{REQ_ID}} --overwrite` after planning phase
 {{/HAS_OUTSTANDING}}
 
 {{#HAS_DEFERRED}}
@@ -179,13 +179,13 @@ Options:
 - {{ITEM}}
 {{/DEFERRED_SUMMARY}}
 
-These will be addressed during `/flow-tech` or `/flow-epic`.
+These will be addressed during `/flow:spec` task planning or `/flow:dev` implementation.
 {{/HAS_DEFERRED}}
 
 {{#NO_QUESTIONS}}
 ✅ **No critical ambiguities detected**. research.md is sufficiently specified.
 
-Recommended next command: `/flow-prd {{REQ_ID}}`
+Recommended next command: `/flow:spec {{REQ_ID}}`
 {{/NO_QUESTIONS}}
 
 ---

package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md

@@ -12,7 +12,7 @@
 ```markdown
 ## [TIMESTAMP] E###: TITLE
 
-**Phase**: flow-dev / T### 或 flow-qa / 测试名
+**Phase**: flow:dev / T### 或 flow:verify / 测试名
 **Error Type**: Test Failure | Build Error | Runtime Error | Type Error | Lint Error
 **Error Message**:
 \`\`\`
@@ -30,7 +30,7 @@
 
 ## [2026-01-08T10:30:00] E001: Test Failure - Email Validation
 
-**Phase**: flow-dev / T003
+**Phase**: flow:dev / T003
 **Error Type**: Test Failure
 **Error Message**:
 ```

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

@@ -1,16 +1,16 @@
 # Flow-Init Execution Flow Template
 
-> Detailed stages for `/flow-init` requirement initialization
+> Detailed stages for `/flow:init` requirement initialization
 
 <!-- ============================================================
      调用上下文声明 (Invocation Context Declaration)
      ============================================================
 
-本模板由 `/flow-init` 命令通过 {TEMPLATE:flow} 引用加载。
+本模板由 `/flow:init` 命令通过 {TEMPLATE:flow} 引用加载。
 
 模板中的 {SCRIPT:xxx} 占位符引用 flow-init.md 头文件中的 scripts 定义：
 ```yaml
-# 来源: .claude/commands/flow-init.md 头文件
+# 来源: .claude/commands/flow/init.md 头文件
 scripts:
   create: .claude/scripts/create-requirement.sh
   prereq: .claude/scripts/check-prerequisites.sh

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

@@ -1,107 +1,76 @@
-# Flow-New Orchestration Template
+# Mainline Orchestration Template
 
-> Execution flow for `/flow-new` one-shot requirement development (v4.1)
+> Canonical execution flow for requirement delivery (`/flow:init -> /flow:spec -> /flow:dev -> /flow:verify -> /flow:release`)
 
 ---
 
 ## Stage Execution Skeleton
 
-### [1/6] /flow-init
-- 创建需求目录 + Git 分支
-- 研究材料收集 + `BRAINSTORM.md` 初始化
-- Exit Gate: `orchestration_status.status == initialized`
+### [1/5] /flow:init
+- 创建需求目录 + 运行时上下文
+- Exit Gate: `status in {initialized, context_packed}`
 
-### [2/6] /flow-clarify (可选)
-- 触发条件: 需求歧义、边界冲突、验收标准不明确
-- 输出: `clarifications/*.md`
-- 若跳过: 标记 `clarify_skipped: true`
+### [2/5] /flow:spec
+- 统一规格阶段（PRD/Tech/UI/Task Manifest）
+- Exit Gate: `status = spec_complete` 或 `phase = planning`
 
-### [3/6] /flow-spec
-- 统一规格阶段: PRD → Tech+UI(并行) → Epic/TASKS
-- 支持模式: `--skip-tech` / `--skip-ui`
-- Exit Gate: 规格产物完整，`status = spec_complete`
+### [3/5] /flow:dev
+- 按 manifest 执行开发，支持 `--resume`
+- Exit Gate: `status in {development_complete, development_in_progress}`
 
-### [4/6] /flow-dev
-**TDD 执行模式**:
-```
-Phase 1: 分析现有代码
-Phase 2: 编写测试 (Tests First)
-  ↓
-TDD CHECKPOINT → 测试必须先失败
-  ↓
-Phase 3: 实现代码
-Phase 4: 测试验证 → 测试必须通过
-```
-- 输出: 实现代码 + 测试代码 + `TASKS.md` 勾选更新
+### [4/5] /flow:verify
+- 快速/严格质量闸
+- 严格模式输出 `report-card.json` 作为发布准入依据
 
-### [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`
+### [5/5] /flow:release
+- 读取 verify 结果并完成发布收口
+- 生成发布计划并清理运行时噪音
 
 ---
 
 ## Progress Display Format
 
-```
-🎯 CC-DevFlow 完整需求开发流程
+```text
+🎯 CC-DevFlow 主链交付
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 需求: REQ-123 | 支持用户下单
 
-[1/6] ✅ 初始化完成
-[2/6] ✅ 澄清完成 (可选)
-[3/6] ✅ 统一规格完成
-[4/6] 🔄 开发执行中... (8/18 已完成)
-[5/6] ⏳ 等待质量验证...
-[6/6] ⏳ 等待发布管理...
+[1/5] ✅ 初始化完成
+[2/5] ✅ 规格完成
+[3/5] 🔄 开发执行中... (8/18 已完成)
+[4/5] ⏳ 等待质量闸...
+[5/5] ⏳ 等待发布...
 ```
 
 ---
 
 ## Output Structure
 
-```
+```text
 devflow/requirements/${REQ_ID}/
-├── BRAINSTORM.md
-├── research/
-├── clarifications/                # 可选
 ├── PRD.md
-├── TECH_DESIGN.md                 # 若未跳过 tech
-├── UI_PROTOTYPE.html              # 若未跳过 ui 且识别到 UI 需求
+├── TECH_DESIGN.md
+├── UI_PROTOTYPE.html            # 条件生成
 ├── EPIC.md
 ├── TASKS.md
-├── SPEC_REVIEW.md                 # flow-quality --full
-├── CODE_QUALITY_REVIEW.md         # flow-quality --full
-├── SECURITY_REPORT.md             # flow-quality --full
+├── report-card.json             # /flow:verify 产物
+├── SECURITY_REPORT.md
 └── RELEASE_PLAN.md
 ```
 
 ---
 
-## Status Tracking
+## Status Tracking (Suggested)
 
-**orchestration_status.json 推荐字段**:
 ```json
 {
-  "status": "dev_complete",
-  "phase": "execution",
+  "status": "development_in_progress",
+  "phase": "development",
   "initialized": true,
-  "clarify_complete": true,
   "spec_complete": true,
-  "dev_complete": true,
+  "development_complete": false,
   "quality_complete": false,
   "release_complete": false
 }
 ```
-
----
-
-**Last Updated**: 2026-02-07

package/.claude/docs/templates/RESEARCH_TEMPLATE.md

@@ -124,7 +124,7 @@ Generated: {GENERATED_AT}
 1. **Manual Research Workflow**:
    ```bash
    # 1. Run flow-init (generates tasks.json)
-   /flow-init "REQ-123|Feature Name"
+   /flow:init "REQ-123|Feature Name"
 
    # 2. Research each task
    # - Check existing codebase
@@ -145,7 +145,7 @@ Generated: {GENERATED_AT}
 2. **Direct Editing**:
    - Copy this template to `research/research.md`
    - Fill in decisions based on your research
-   - Run validation script before proceeding to /flow-prd
+   - Run validation script before proceeding to /flow:spec
 
 ---
 
@@ -271,6 +271,6 @@ Generated: {GENERATED_AT}
 **Maintained By**: CC-DevFlow Team
 **Last Updated**: 2025-01-26
 **Related Docs**:
-- [flow-init.md](../../commands/flow-init.md) - 需求初始化流程
+- [flow/init.md](../../commands/flow/init.md) - 需求初始化流程
 - [validate-research.sh](../../scripts/validate-research.sh) - 验证脚本
 - [flow-init-optimization-plan.md](../../../flow-init-optimization-plan.md) - 优化方案

package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md

@@ -177,9 +177,9 @@ Prompt: "Generate ARCHITECTURE.md with 4 diagrams..."
 
 下一步建议:
 1. 审查路线图
-2. 开始首个需求: /flow-init "REQ-XXX|{RM-title}"
+2. 开始首个需求: /flow:init "REQ-XXX|{RM-title}"
 3. 定期更新: /core-roadmap --regenerate
-4. 监控进度: /flow-status --all
+4. 监控进度: /flow:status --all
 ```
 
 ---

package/.claude/docs/templates/ROADMAP_TEMPLATE.md

@@ -234,7 +234,7 @@ _填充规则:_
 - Feature: 功能简短标题
 - Derived From: 来源需求 ID (REQ-001) 或其他来源 (Tech Stack, User Feedback)
 - Status: Planned | In Progress | Completed | Blocked | Cancelled
-- Mapped REQ: 关联的正式需求 ID（初始为 "-"，运行 /flow-init 后填充）
+- Mapped REQ: 关联的正式需求 ID（初始为 "-"，运行 /flow:init 后填充）
 - Progress: 完成百分比 (0%, 20%, 80%, 100%)
 
 _说明: 此表用于追踪路线图项到正式需求的映射，以及进度同步_
@@ -295,7 +295,7 @@ _填充规则:_
 - **RM-ID**: Roadmap Item ID，路线图意向项标识符（如 RM-001）
 - **REQ-ID**: Requirement ID，正式需求标识符（如 REQ-010）
 - **Derived From**: 来源，标注该意向项从哪个已有需求或来源延伸而来
-- **Mapped REQ**: 映射需求，当意向项通过 /flow-init 正式创建为需求后，记录其 REQ-ID
+- **Mapped REQ**: 映射需求，当意向项通过 /flow:init 正式创建为需求后，记录其 REQ-ID
 - **Feature Cluster**: 功能集群，将相关的意向项分组便于理解和管理
 - **Milestone**: 里程碑，一个季度内要完成的一组功能集群
 - **Velocity**: 速度，团队完成需求的平均速率（天数/需求）

package/.claude/docs/templates/STYLE_TEMPLATE.md

@@ -1225,17 +1225,17 @@ module.exports = {
    - 如需新增变体,确保与现有变体一致
 
 3. **生成 UI 原型时**:
-   - `/flow-ui` 命令会自动引用本指南
+   - `/flow:spec` 阶段会自动引用本指南
    - 确保原型中的所有样式符合本指南
 
 4. **前端开发时**:
-   - `/flow-dev` 命令会自动引用本指南
+   - `/flow:dev` 命令会自动引用本指南
    - 所有组件实现必须遵循本指南的样式定义
 
 ### 更新本指南
 
 - **何时更新**: 新增组件、调整设计系统、发现不一致
-- **如何更新**: 使用 `/flow-style --update` 命令
+- **如何更新**: 使用 `/core-style --update` 命令
 - **版本控制**: 每次更新增加版本号，记录变更内容
 
 ---

package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md

@@ -1254,7 +1254,7 @@ Found keywords: 0 matches for "用户界面|前端|Web页面|UI"
 Recommendation:
   1. This appears to be a backend-only requirement
   2. Skipping UI prototype generation
-  3. Continuing to /flow-epic
+  3. Continuing within /flow:spec
 
 Action: EXIT with status "ui_skipped"
 ```
@@ -1310,17 +1310,17 @@ Recovery:
 
 ### Workflow Position:
 ```text
-/flow-prd  → PRD.md 生成完成
+/flow:spec → PRD.md 生成完成
     ↓
-/flow-ui   → 检测UI需求 → 生成UI_PROTOTYPE.html ← YOU ARE HERE
+/flow:spec → 检测UI需求 → 生成UI_PROTOTYPE.html ← YOU ARE HERE
     ↓
-/flow-epic → 参考UI原型生成EPIC.md和TASKS.md
+/flow:spec → 参考UI原型生成EPIC.md和TASKS.md
     ↓
-/flow-dev  → 基于UI原型实现代码
+/flow:dev  → 基于UI原型实现代码
 ```
 
 ### Conditional Trigger Logic:
-在 `/flow-new` 或 `/flow-prd` 完成后自动执行:
+在 `/flow:spec` 执行期间自动触发:
 
 ```bash
 # 检测是否需要UI原型
@@ -1328,11 +1328,10 @@ has_ui_keywords=$(grep -iE "用户界面|前端|Web页面|UI|界面设计|交互
 has_frontend_stack=$(ls -d src/components 2>/dev/null || ls package.json 2>/dev/null)
 
 if [[ -n "$has_ui_keywords" || -n "$has_frontend_stack" ]]; then
-    echo "✅ UI requirements detected, triggering /flow-ui"
-    /flow-ui "$REQ_ID"
+    echo "✅ UI requirements detected, continue UI prototype generation in /flow:spec"
 else
     echo "ℹ️  No UI requirements detected, skipping UI prototype"
-    # 直接进入 /flow-epic
+    # 继续 /flow:spec 后续任务规划
 fi
 ```