cc-devflow 4.1.3 → 4.1.5

package/.claude/CLAUDE.md

@@ -11,7 +11,7 @@ This directory contains Claude Code CLI extensions for the CC-DevFlow developmen
 │   ├── workflow.yaml          # 工作流依赖图定义 [NEW: v4.0]
 │   │
 │   ├── workflow/              # 工作流 Skills [NEW: v4.0]
-│   │   ├── flow-init/         # 需求初始化 (支持 worktree)
+│   │   ├── flow-init/         # 需求初始化
 │   │   │   ├── SKILL.md       # 核心指令 (<500 行)
 │   │   │   ├── context.jsonl  # 上下文定义 (借鉴 Trellis)
 │   │   │   ├── scripts/       # 内嵌脚本
@@ -23,13 +23,12 @@ This directory contains Claude Code CLI extensions for the CC-DevFlow developmen
 │   │   ├── flow-ui/           # UI 原型 (deprecated, use flow-spec)
 │   │   ├── flow-epic/         # Epic/Tasks (deprecated, use flow-spec)
 │   │   ├── flow-dev/          # 开发执行
-│   │   └── flow-release/      # 发布管理 (支持 worktree 清理)
+│   │   └── flow-release/      # 发布管理
 │   │
 │   ├── domain/                # 领域 Skills
 │   │   ├── tdd/               # TDD Iron Law
 │   │   ├── debugging/         # 系统化调试
-│   │   ├── brainstorming/     # 头脑风暴
-│   │   └── using-git-worktrees/  # Git Worktree 管理 [NEW: v4.3] ⭐
+│   │   └── brainstorming/     # 头脑风暴
 │   │
 │   ├── guardrail/             # 守护 Skills
 │   │   ├── constitution-guardian/
@@ -52,7 +51,8 @@ This directory contains Claude Code CLI extensions for the CC-DevFlow developmen
 │   └── types/
 │       └── team-types.d.ts      # Team 状态类型定义 [NEW: v4.7]
 ├── scripts/                   # 共享脚本
-│   └── common.sh              # 通用函数 (含 worktree 辅助函数)
+│   ├── CLAUDE.md              # scripts 子目录地图（成员清单与职责边界）
+│   └── common.sh              # 通用函数
 └── docs/templates/            # 共享模板
     └── _shared/               # 共享模板组件 [NEW: v4.1]
         ├── CONSTITUTION_CHECK.md
@@ -530,95 +530,6 @@ T2          └─────────┬──────────┘
 **Last Updated**: 2026-02-07
 **v4.1.0 Module**: Unified Specification Phase
 
----
-
-## v4.3.0 Module: Git Worktree Integration
-
-### Purpose
-
-将所有 Git 分支操作改为 Git Worktree 方式，支持 3-5 个并行 Claude Code 会话，借鉴官方最佳实践。
-
-### Key Changes
-
-| Before (v4.2) | After (v4.3) | Improvement |
-|---------------|--------------|-------------|
-| 传统分支切换 | Worktree 隔离 | 并行开发 |
-| stash/checkout | cd 切换 | 切换时间 -97% |
-| 单一 Claude 会话 | 多会话并行 | 效率 +200% |
-
-### Worktree Directory Layout
-
-```
-~/projects/
-├── cc-devflow/                    # 主仓库 (main 分支)
-├── cc-devflow-REQ-001/            # REQ-001 worktree
-├── cc-devflow-REQ-002/            # REQ-002 worktree
-├── cc-devflow-analysis/           # 只读分析 worktree (可选)
-└── cc-devflow-hotfix/             # 紧急修复 worktree (可选)
-```
-
-### New Skill: using-git-worktrees
-
-```
-.claude/skills/domain/using-git-worktrees/
-├── SKILL.md                    # 核心指令 (~200 行)
-├── context.jsonl               # 上下文定义
-├── scripts/
-│   ├── worktree-create.sh      # 创建 worktree
-│   ├── worktree-list.sh        # 列出 worktree
-│   ├── worktree-switch.sh      # 切换 worktree
-│   ├── worktree-cleanup.sh     # 清理 worktree
-│   └── worktree-status.sh      # 状态检查
-└── assets/
-    └── SHELL_ALIASES.md        # Shell 别名模板
-```
-
-### Modified Commands
-
-| Command | Change |
-|---------|--------|
-| `/flow-init` | 默认使用 worktree 模式，`--branch-only` 兼容旧模式 |
-| `/flow-release` | 自动清理 worktree |
-
-### Shell Aliases (Recommended)
-
-```bash
-alias za='cd $(git rev-parse --show-toplevel 2>/dev/null || echo .)'
-alias zl='git worktree list'
-alias zm='cd ~/projects/cc-devflow'
-
-zw() {
-  local req_id="${1:-}"
-  local repo_name=$(basename $(git rev-parse --show-toplevel 2>/dev/null))
-  cd ~/projects/${repo_name}-${req_id}
-}
-```
-
-### New common.sh Functions
-
-| Function | Purpose |
-|----------|---------|
-| `is_in_worktree()` | 检测是否在 worktree 中 |
-| `get_main_repo_path()` | 获取主仓库路径 |
-| `get_worktree_path()` | 获取当前 worktree 路径 |
-| `get_worktree_dir_for_req()` | 获取指定 REQ 的 worktree 目录 |
-| `worktree_exists_for_req()` | 检查 worktree 是否存在 |
-| `get_req_id_from_worktree()` | 从 worktree 路径提取 REQ-ID |
-| `list_worktrees_with_req()` | 列出所有 worktree 及其 REQ-ID |
-
-### Expected Improvements
-
-| Metric | Before | After | Improvement |
-|--------|--------|-------|-------------|
-| 并行需求数 | 1 | 3-5 | +400% |
-| 上下文切换时间 | 30s | 1s | -97% |
-| 紧急修复响应 | 需要 stash | 直接新建 | 即时 |
-| Claude 会话隔离 | 无 | 完全隔离 | 100% |
-
----
-
-**Last Updated**: 2026-02-07
-**v4.3.0 Module**: Git Worktree Integration
 
 ---
 
@@ -1100,7 +1011,6 @@ TaskCompleted Event
 | `.claude/hooks/types/team-types.d.ts` | Team 状态 TypeScript 类型 |
 | `.claude/scripts/parse-task-dependencies.js` | TASKS.md 任务依赖解析器 |
 | `.claude/scripts/detect-file-conflicts.sh` | 并行任务文件冲突检测 |
-| `.claude/scripts/team-dev-init.sh` | flow-dev Team 模式初始化 |
 | `.claude/skills/workflow/flow-spec/scripts/team-init.sh` | flow-spec Team 模式初始化 |
 | `.claude/skills/workflow/flow-spec/scripts/team-communication.sh` | Teammate 通信协议 |
 | `.claude/skills/workflow/flow-spec/team-config.json` | spec-design-team 配置 |
@@ -1217,4 +1127,3 @@ ralph_loop:
 
 **Last Updated**: 2026-02-07
 **v4.7.0 Module**: Claude Team Integration
-

package/.claude/commands/flow/fix.md

@@ -73,14 +73,9 @@ Bug 修复不是猜测游戏。系统化调试 = 更快修复 + 更少回归。
 ### 阶段 0: Entry Gate
 ```
 1. 解析 BUG_ID、TITLE
-   → 若 TITLE 含中文/非ASCII，使用模型意译生成 BRANCH_TITLE_EN（英文语义翻译，禁止拼音/音译）
-   → 若意译不确定或未生成 ASCII 结果，向用户确认英文分支标题
 2. {SCRIPT:prereq} --json 验证:
    → devflow/bugs/${BUG_ID}/ 是否存在（首次执行将创建）
-   → Git 工作区干净
-3. 创建目录与分支:
-   → git checkout -b "bugfix/${BUG_ID}-${slug(BRANCH_TITLE_EN)}"
-   → 初始化 devflow/bugs/${BUG_ID}/ 结构与 orchestration_status.json
+3. 初始化 devflow/bugs/${BUG_ID}/ 结构与 orchestration_status.json
 4. 检查 quickstart.md
    → 若需求目录已有 quickstart.md，复制引用用于测试执行
 ```

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

@@ -21,7 +21,6 @@ skill: workflow/flow-init
 | Stage | Purpose | Output |
 |-------|---------|--------|
 | 1 | Entry Gate | 参数验证 |
-| 1.2 | Git Branch | feature/REQ-xxx-title |
 | 1.5 | Context Loading | ROADMAP/ARCHITECTURE |
 | 2 | Directory Init | 目录结构 |
 | 2.3 | Brainstorming | BRAINSTORM.md |
@@ -29,6 +28,11 @@ skill: workflow/flow-init
 | 3 | README | README.md |
 | 4 | Exit Gate | 5-Level 验证 |
 
+## Session Continuity
+
+- 需求上下文由 `devflow/requirements/${REQ_ID}/` 下的文档和 `orchestration_status.json` 持久化。
+- REQ 识别优先级：`DEVFLOW_REQ_ID` → `devflow/workspace/.current-req` → 最新需求目录。
+
 ## Skill Location
 
 **Full Implementation**: `.claude/skills/workflow/flow-init/SKILL.md`
@@ -41,5 +45,5 @@ skill: workflow/flow-init
 ## Next Step
 
 ```
-/flow-prd "${REQ_ID}"
+/flow-spec "${REQ_ID}"
 ```

package/.claude/commands/flow/release.md

@@ -1,6 +1,6 @@
 ---
 name: flow-release
-description: 'Create PR and manage release. Usage: /flow-release "REQ-123" or /flow-release'
+description: 'Complete requirement and update progress. Usage: /flow-release "REQ-123" or /flow-release'
 scripts:
   prereq: .claude/scripts/check-prerequisites.sh
   check_tasks: .claude/scripts/check-task-status.sh
@@ -8,46 +8,18 @@ scripts:
   generate_status: .claude/scripts/generate-status-report.sh
   verify_gate: .claude/scripts/verify-gate.sh
 skills:
-  finishing: .claude/skills/flow-finishing-branch/SKILL.md
   verification: .claude/skills/verification-before-completion/SKILL.md
 ---
 
 # Flow-Release - 发布管理命令
 
-## 分支完成决策 (新增)
-
-参考 `{SKILL:finishing}` 原则，发布前需要决定分支处理方式：
-
-```yaml
-决策选项:
-  A) Fast-forward merge
-     → 适用: 小改动，单人开发，无需审查记录
-     → 命令: git checkout main && git merge --ff-only feature/xxx
-
-  B) Create PR (推荐)
-     → 适用: 需要记录，团队审查，CI 验证
-     → 命令: gh pr create
-
-  C) Squash and merge
-     → 适用: 多个提交需合并为一个
-     → 命令: gh pr merge --squash
-
-  D) Cleanup only
-     → 适用: 工作被废弃，只需清理分支
-     → 命令: git checkout main && git branch -D feature/xxx
-
-决策依据:
-  - 改动大小 (>10 files → PR)
-  - 是否需要审查 (团队项目 → PR)
-  - 提交历史是否清晰 (混乱 → Squash)
-  - 是否需要 CI 验证 (生产代码 → PR)
-```
+> Git 分支/PR/合并由用户自行管理，DevFlow 仅负责进度更新和提交。
 
 ## User Input
 ```text
 $ARGUMENTS = "REQ_ID?"
 ```
-未提供则根据当前分支或 `DEVFLOW_REQ_ID` 自动解析。
+未提供则根据 `DEVFLOW_REQ_ID` 或 `.current-req` 自动解析。
 
 ## 执行流程
 
@@ -55,22 +27,23 @@ $ARGUMENTS = "REQ_ID?"
 ```
 1. 解析 REQ_ID
 2. {SCRIPT:prereq} --json 校验:
-   → 存在 PRD.md、TECH_DESIGN.md、data-model.md、contracts/、quickstart.md、EPIC.md、TASKS.md、TEST_REPORT.md、SECURITY_REPORT.md
+   → 存在 PRD.md、EPIC.md、TASKS.md、TEST_REPORT.md、SECURITY_REPORT.md
    → orchestration_status.status ∈ {"quality_complete", "qa_complete", "release_failed"}
 3. {SCRIPT:check_tasks} --json 确认 remaining == 0
 4. 验证 Quality gate:
    → TEST_REPORT.md / SECURITY_REPORT.md 中的 Gate 均为 PASS
-5. Git 环境:
-   → 工作区干净、当前在 feature/bugfix 分支
-   → 分支已推送，若无 upstream 提示 push
+5. Commit 规范门禁（工作区不干净时）:
+   → 必须先执行 `/util/git-commit`（规则见 `.claude/commands/util/git-commit.md`）
+   → Commit message 必须遵循 Conventional Commits；多文件按同类变更拆分提交
+   → 提交完成后重新执行 Entry Gate，直到工作区干净
 ```
 
 ### 阶段 2: 发布上下文准备
 ```
 1. 收集元数据:
-   → TITLE, branch, commits, changed files, coverage, security 状态
+   → REQ_ID, TITLE, commits, changed files, coverage, security 状态
 2. 汇总文档:
-   → PRD 成功指标、EPIC 范围、TASKS DoD、quickstart 验证命令
+   → PRD 成功指标、EPIC 范围、TASKS DoD
 3. 更新 orchestration_status:
    → status = "release_in_progress"
    → phase = "release"
@@ -83,43 +56,44 @@ Prompt 核心要求:
   - 确认 Constitution 校验无 ERROR:
       {SCRIPT:validate_constitution} --type all --severity error
   - 生成 RELEASE_PLAN.md:
-      • 范围概览、风险评估、回滚策略、监控计划、依赖项
-      • 列出 data-model / contracts / quickstart 的变更摘要
-  - 生成 PR 描述草稿:
-      • 摘要、实现亮点、测试结果（引用 quickstart 命令）、安全结论、验证报告链接
+      • 范围概览、风险评估、回滚策略、监控计划
   - 建议标签、检查清单
 ```
 
-### 阶段 4: PR 创建与完结
+### 阶段 4: Progress Update
 ```
-1. 使用 gh CLI 创建或更新 PR
-   → 标题: "${REQ_ID}: ${TITLE}"
-   → 正文采用 agent 输出
-2. 检查 CLAUDE.md：
-   → 若 TECH_DESIGN 引入新基础设施/重大变更，更新 "## Technical Architecture"（≤15 行）
-3. 状态更新:
-   → orchestration_status.status = "release_complete"
+1. 更新 BACKLOG.md:
+   → 找到对应 REQ 条目，更新状态为 completed/released
+2. 更新 ROADMAP.md:
+   → 找到对应 REQ 条目，更新进度
+3. 更新 orchestration_status:
+   → status = "release_complete"
    → completedSteps append "release"
-   → prUrl 记录到状态文件
-4. EXECUTION_LOG 记录 PR 链接与发布时间
-5. 可选: {SCRIPT:generate_status} 生成状态报告
+4. EXECUTION_LOG.md 记录发布完成
+```
+
+### 阶段 5: Commit Gate
+```
+1. 若 `git status --porcelain` 非空:
+   → 按 `/util/git-commit` 规范提交
+   → 格式: chore(release): complete ${REQ_ID} - ${TITLE}
+2. 可选: {SCRIPT:generate_status} 生成状态报告
 ```
 
 ## 输出
 ```
 ✅ RELEASE_PLAN.md
-✅ CLAUDE.md（如需更新）
-✅ GitHub PR (gh)
+✅ BACKLOG.md (进度更新)
+✅ ROADMAP.md (进度更新)
 ✅ orchestration_status.json 更新 (release_complete)
 ✅ EXECUTION_LOG.md 发布记录
+✅ Changes committed (用户自行处理分支/PR/合并)
 ```
 
 ## 错误处理
 - Quality Gate 失败或 Constitution ERROR → 立即终止，标记 status="release_failed"。
-- Git push/PR 创建失败 → 输出命令和日志，保持可重试状态。
-- CLAUDE.md 更新遗漏 → 阻断发布并提示补写。
+- 工作区存在未提交改动且未按 `/util/git-commit` 规则处理 → 阻断发布。
 
 ## 下一步
-1. 等待代码评审与 CI 通过。
-2. 合并后更新主分支标签或发布记录。
-3. 反馈验证结果，必要时触发 `/flow-verify` 复检。
+1. 用户自行处理分支合并 / PR 创建。
+2. 反馈验证结果，必要时触发 `/flow-verify` 复检。

package/.claude/commands/flow/workspace.md

@@ -20,13 +20,16 @@ Enables context recovery across sessions and tracks development progress.
 /flow-workspace init [developer]
 
 # Start session (recover context)
-/flow-workspace start
+/flow-workspace start [REQ-XXX|BUG-XXX]
+/flow-workspace start REQ-XXX --switch
+/flow-workspace start BUG-XXX --switch --cd  # 需 source/eval 场景
 
 # Record progress to journal
 /flow-workspace record "message"
 
 # Switch to different requirement
 /flow-workspace switch REQ-XXX
+/flow-workspace switch BUG-XXX --cd            # 需 source/eval 场景
 ```
 
 ## Subcommands
@@ -53,6 +56,8 @@ Start a new session, recovering context from previous session.
 
 ```bash
 /flow-workspace start
+/flow-workspace start REQ-008 --switch
+/flow-workspace start BUG-008 --switch
 ```
 
 Process:
@@ -61,6 +66,10 @@ Process:
 3. Display context summary
 4. Ready to continue work
 
+可选行为:
+- 传入 `REQ-XXX/BUG-XXX` 会先更新 `.current-req` 再恢复上下文
+- `--switch` 输出切换建议；`--cd` 在脚本被 `source` 时可直接切换目录
+
 ### record
 
 Record progress to the journal.
@@ -77,6 +86,7 @@ Switch to a different requirement.
 
 ```bash
 /flow-workspace switch REQ-008
+/flow-workspace switch REQ-008 --cd
 ```
 
 Updates `.current-req` and creates a new journal entry.
@@ -116,7 +126,7 @@ devflow/workspace/
 
 ### With flow-init
 
-When `/flow-init` creates a new requirement:
+When `/flow-init` creates a new requirement (and workspace already initialized):
 ```bash
 # Auto-update workspace
 echo "REQ-XXX" > devflow/workspace/{developer}/.current-req
@@ -136,7 +146,6 @@ Journal is read at Protocol 3 (Ralph iteration start) to maintain context.
 ## Scripts
 
 - `.claude/scripts/flow-workspace-init.sh` - Initialize workspace
-- `.claude/scripts/flow-workspace-start.sh` - Start session
 - `.claude/scripts/flow-workspace-record.sh` - Record progress
 
 ## Related

package/.claude/docs/guides/TEAM_MODE_GUIDE.md

@@ -162,7 +162,6 @@ T2          └─────────┬──────────┘
 |------|------|
 | **same_agent** | 冲突任务分配给同一 Agent 串行执行 |
 | **sequential** | 所有冲突任务按顺序执行 |
-| **worktree** | 使用 Git Worktree 隔离 (未来支持) |
 
 ---
 

package/.claude/hooks/teammate-idle-hook.ts

@@ -117,7 +117,7 @@ function findRepoRoot(startPath: string): string | null {
 }
 
 /**
- * 从 worktree 目录名或分支名提取 REQ-ID
+ * 从环境变量、.current-req 文件或目录扫描提取 REQ-ID
  */
 function extractReqId(repoRoot: string): string | null {
   // 尝试从目录名提取 (e.g., cc-devflow-REQ-123)

package/.claude/rules/devflow-conventions.md

@@ -61,100 +61,9 @@ devflow/requirements/${reqId}/
 
 ---
 
-## 🌿 Git Worktree 约定 (v4.3)
+## 🌿 Git 约定
 
-### Worktree vs Branch 模式
-
-| 模式 | 命令 | 适用场景 |
-|------|------|----------|
-| **Worktree (默认)** | `/flow-init "REQ-123\|Title"` | 多需求并行、需要隔离环境 |
-| **Branch** | `/flow-init "REQ-123\|Title" --branch-only` | 单需求开发、简单修改 |
-
-### Worktree 目录布局
-
-```
-~/projects/
-├── cc-devflow/                    # 主仓库 (main 分支)
-├── cc-devflow-REQ-001/            # REQ-001 worktree
-├── cc-devflow-REQ-002/            # REQ-002 worktree
-├── cc-devflow-analysis/           # 只读分析 worktree (可选)
-└── cc-devflow-hotfix/             # 紧急修复 worktree (可选)
-```
-
-### 命名规范
-
-```bash
-# Worktree 目录
-{repo-name}-{REQ_ID}
-# 示例: cc-devflow-REQ-123
-
-# 对应分支 (不变)
-feature/${reqId}-${slug(BRANCH_TITLE_EN)}
-# 示例: feature/REQ-123-user-order-support
-```
-
-### Worktree 操作流程
-
-1. **创建** (flow-init 自动执行)
-   ```bash
-   git worktree add -b feature/REQ-123-title ../cc-devflow-REQ-123
-   ```
-
-2. **切换**
-   ```bash
-   cd ../cc-devflow-REQ-123
-   # 或使用 shell 别名
-   zw REQ-123
-   ```
-
-3. **开发**
-   - 每个 worktree 独立的 Claude Code 会话
-   - 互不干扰，保持上下文
-
-4. **清理** (flow-release 自动执行)
-   ```bash
-   git worktree remove ../cc-devflow-REQ-123
-   git branch -d feature/REQ-123-title
-   ```
-
-### Shell 别名推荐
-
-```bash
-# 添加到 ~/.zshrc 或 ~/.bashrc
-alias za='cd $(git rev-parse --show-toplevel 2>/dev/null || echo .)'
-alias zl='git worktree list'
-alias zm='cd ~/projects/cc-devflow'
-
-zw() {
-  local req_id="${1:-}"
-  local repo_name=$(basename $(git rev-parse --show-toplevel 2>/dev/null))
-  cd ~/projects/${repo_name}-${req_id}
-}
-```
-
-### 分支命名 (保持不变)
-
-```bash
-# 标准格式
-feature/${reqId}-${slug(BRANCH_TITLE_EN)}
-
-# 示例
-feature/REQ-123-user-order-support
-feature/REQ-124-permission-management
-```
-
-> BRANCH_TITLE_EN 为 TITLE 的英文意译 (语义为准，非拼音，使用模型意译)
-
-### 分支操作流程 (Worktree 模式)
-
-1. 确保主仓库在 main 分支且状态干净
-2. 执行 `/flow-init` 创建 worktree + 分支
-3. 切换到 worktree 目录
-4. 启动新的 Claude Code 会话
-5. 实施开发 (TDD方式)
-6. 质量闸检查
-7. 创建 PR
-8. 合并后清理 worktree 和分支
+> Git 分支、worktree、PR、合并由用户自行管理，DevFlow 不参与 Git 拓扑管理。
 
 ---
 

package/.claude/scripts/CLAUDE.md

@@ -0,0 +1,76 @@
+# scripts/
+> L2 | 父级: .claude/CLAUDE.md
+>
+> [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+
+## 目录定位
+
+`.claude/scripts/` 是命令层与 Skill 层共享的执行脚本库，负责状态检测、质量门禁、需求目录操作与会话恢复。
+
+## 成员清单
+
+analyze-upgrade-impact.sh: 升级影响分析脚本。
+archive-requirement.sh: 需求归档与清理脚本。
+calculate-checklist-completion.sh: Checklist 完成度统计脚本。
+calculate-quarter.sh: 时间季度计算脚本。
+check-dependencies.sh: 依赖关系检查脚本。
+check-prerequisites.sh: 流程前置条件统一校验脚本。
+check-task-status.sh: TASKS 完成状态统计脚本。
+checklist-errors.sh: Checklist 错误码与诊断脚本。
+common.sh: 脚本公共函数库（REQ 识别、日志工具等）。
+consolidate-research.sh: research 结果汇总脚本。
+create-requirement.sh: 创建需求目录与初始状态；同步 workspace 的 `.current-req`。
+delta-parser.ts: Delta 解析器。
+detect-file-conflicts.sh: 并行开发文件冲突检测脚本。
+export-contracts.sh: 合同文档导出脚本。
+extract-data-model.sh: 数据模型抽取脚本。
+flow-context-add.sh: context JSONL 条目追加脚本。
+flow-context-init.sh: context 目录初始化脚本。
+flow-context-validate.sh: context 路径验证脚本。
+flow-delta-apply.sh: Delta 应用脚本。
+flow-delta-archive.sh: Delta 归档脚本。
+flow-delta-create.sh: Delta 创建脚本。
+flow-delta-list.sh: Delta 列表脚本。
+flow-delta-status.sh: Delta 状态脚本。
+flow-quality-full.sh: 全量质量检查脚本。
+flow-quality-quick.sh: 快速质量检查脚本。
+flow-workspace-init.sh: 开发者 workspace 初始化脚本。
+flow-workspace-record.sh: workspace journal 追加记录脚本。
+generate-clarification-questions.sh: Clarify 问题生成脚本。
+generate-clarification-report.sh: Clarify 报告生成脚本。
+generate-quickstart.sh: quickstart 文档生成脚本。
+generate-research-tasks.sh: research 任务生成脚本。
+generate-status-report.sh: 状态报告聚合脚本。
+generate-tech-analysis.sh: 技术分析生成脚本。
+get-workflow-status.sh: 工作流状态读取脚本。
+locate-requirement-in-roadmap.sh: roadmap 需求定位脚本。
+manage-constitution.sh: Constitution 管理脚本。
+mark-task-complete.sh: 任务完成标记脚本。
+parse-task-dependencies.js: 任务依赖解析器。
+populate-research-tasks.sh: research 任务填充脚本。
+record-quality-error.sh: 质量错误记录脚本。
+recover-workflow.sh: 中断恢复脚本。
+run-clarify-scan.sh: Clarify 扫描执行脚本。
+run-high-review.sh: 高强度 review 执行脚本。
+run-problem-analysis.sh: 问题分析执行脚本。
+run-quality-gates.sh: 质量门禁执行脚本。
+setup-epic.sh: Epic 初始化脚本。
+setup-ralph-loop.sh: Ralph Loop 初始化脚本。
+sync-roadmap-progress.sh: roadmap 进度同步脚本。
+sync-task-marks.sh: TASKS 勾选同步脚本。
+team-dev-init.sh: Team 开发并行初始化脚本。
+team-state-recovery.sh: Team 状态恢复脚本。
+test-clarify-scan.sh: Clarify 扫描测试脚本。
+update-agent-context.sh: Agent 上下文更新脚本。
+validate-constitution.sh: Constitution 校验脚本。
+validate-hooks.sh: Hooks 校验脚本。
+validate-research.sh: research 质量校验脚本。
+validate-scope-boundary.sh: scope 边界校验脚本。
+verify-gate.sh: Gate 校验脚本。
+verify-setup.sh: 环境/安装验证脚本。
+workflow-status.ts: 工作流状态类型化读取器。
+
+## 设计约束
+
+- 需求识别统一复用 `common.sh`，避免多处正则分叉。
+- 新增脚本优先保持幂等与可重入，便于中断恢复。