cc-devflow 4.1.4 → 4.1.6

package/.claude/scripts/flow-workspace-start.sh

@@ -1,217 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 .current-req 和 journal-*.md
-# [OUTPUT]: 显示上下文恢复信息
-# [POS]: scripts 的 workspace 启动脚本，被 /flow-workspace start 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Configuration
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-WORKSPACE_DIR="$PROJECT_ROOT/devflow/workspace"
-COMMON_SH="$SCRIPT_DIR/common.sh"
-
-if [[ -f "$COMMON_SH" ]]; then
-    source "$COMMON_SH"
-fi
-
-# ============================================================================
-# Parse Arguments
-# ============================================================================
-
-usage() {
-    cat << 'EOF'
-Usage: flow-workspace-start.sh [REQ_ID|DEVELOPER] [OPTIONS]
-
-Start a workspace session and recover context.
-
-Arguments:
-  REQ_ID               Optional requirement ID to activate (REQ-XXX / BUG-XXX)
-  DEVELOPER            Optional developer name (legacy positional style)
-
-Options:
-  --developer NAME     Explicit developer name
-  --req REQ_ID         Activate a specific requirement before recovery
-  --switch             Show switch recommendation to the target worktree
-  --cd                 Try to execute cd (effective only when script is sourced)
-  --help, -h           Show help
-
-Examples:
-  flow-workspace-start.sh
-  flow-workspace-start.sh REQ-123 --switch
-  source flow-workspace-start.sh REQ-123 --switch --cd
-EOF
-}
-
-DEVELOPER="${DEVFLOW_DEVELOPER:-$(whoami)}"
-REQ_OVERRIDE=""
-SHOW_SWITCH=false
-DO_CD=false
-POSITIONAL=()
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --developer)
-            DEVELOPER="$2"
-            shift 2
-            ;;
-        --req)
-            REQ_OVERRIDE="$2"
-            shift 2
-            ;;
-        --switch)
-            SHOW_SWITCH=true
-            shift
-            ;;
-        --cd)
-            DO_CD=true
-            shift
-            ;;
-        --help|-h)
-            usage
-            exit 0
-            ;;
-        -*)
-            echo "ERROR: Unknown option '$1'. Use --help for usage." >&2
-            exit 1
-            ;;
-        *)
-            POSITIONAL+=("$1")
-            shift
-            ;;
-    esac
-done
-
-# Backward compatible positional parsing:
-# - if token looks like REQ/BUG -> requirement override
-# - else treat as developer
-for token in "${POSITIONAL[@]}"; do
-    if [[ "$token" =~ ^(REQ|BUG)-[0-9]+(-[0-9]+)?$ ]]; then
-        REQ_OVERRIDE=$(echo "$token" | tr '[:lower:]' '[:upper:]')
-    else
-        DEVELOPER="$token"
-    fi
-done
-
-DEV_WORKSPACE="$WORKSPACE_DIR/$DEVELOPER"
-
-if [[ ! -d "$DEV_WORKSPACE" ]]; then
-    echo "Workspace not found for $DEVELOPER"
-    echo "Run '/flow-workspace init $DEVELOPER' first."
-    exit 1
-fi
-
-# ============================================================================
-# Main Logic
-# ============================================================================
-
-echo "🔄 Session Recovery for $DEVELOPER"
-echo "=================================="
-echo ""
-
-if [[ -n "$REQ_OVERRIDE" ]]; then
-    if declare -f validate_req_id >/dev/null 2>&1; then
-        validate_req_id "$REQ_OVERRIDE" || exit 1
-    fi
-    echo "$REQ_OVERRIDE" > "$DEV_WORKSPACE/.current-req"
-    echo "📌 Requirement override: $REQ_OVERRIDE"
-fi
-
-# Read current requirement
-if [[ -f "$DEV_WORKSPACE/.current-req" ]]; then
-    CURRENT_REQ=$(cat "$DEV_WORKSPACE/.current-req")
-    echo "📋 Current Requirement: $CURRENT_REQ"
-
-    # Resolve requirement/bug directory by ID prefix
-    if [[ "$CURRENT_REQ" =~ ^BUG- ]]; then
-        REQ_DIR="$PROJECT_ROOT/devflow/bugs/$CURRENT_REQ"
-        STATUS_BASENAME="status.json"
-    else
-        REQ_DIR="$PROJECT_ROOT/devflow/requirements/$CURRENT_REQ"
-        STATUS_BASENAME="orchestration_status.json"
-    fi
-
-    if [[ -d "$REQ_DIR" ]]; then
-        # Read orchestration status
-        STATUS_FILE="$REQ_DIR/$STATUS_BASENAME"
-        if [[ -f "$STATUS_FILE" ]]; then
-            STATUS=$(jq -r '.status' "$STATUS_FILE" 2>/dev/null || echo "unknown")
-            echo "   Status: $STATUS"
-        fi
-
-        # Check TASKS.md for progress
-        TASKS_FILE="$REQ_DIR/TASKS.md"
-        if [[ -f "$TASKS_FILE" ]]; then
-            TOTAL=$(grep -c '^\- \[' "$TASKS_FILE" 2>/dev/null || echo "0")
-            DONE=$(grep -c '^\- \[x\]' "$TASKS_FILE" 2>/dev/null || echo "0")
-            echo "   Tasks: $DONE/$TOTAL completed"
-        fi
-
-        # Show expected worktree path and whether current session matches.
-        if declare -f get_worktree_dir_for_req >/dev/null 2>&1; then
-            EXPECTED_WORKTREE=$(get_worktree_dir_for_req "$CURRENT_REQ" 2>/dev/null || echo "")
-            CURRENT_GIT_ROOT=$(git -C "$PROJECT_ROOT" rev-parse --show-toplevel 2>/dev/null || echo "")
-
-            if [[ -n "$EXPECTED_WORKTREE" ]]; then
-                echo "   Expected Worktree: $EXPECTED_WORKTREE"
-                if [[ -d "$EXPECTED_WORKTREE" ]]; then
-                    if [[ "$CURRENT_GIT_ROOT" == "$EXPECTED_WORKTREE" ]]; then
-                        echo "   Worktree Match: yes"
-                    else
-                        echo "   Worktree Match: no"
-                        echo "   Action: cd $EXPECTED_WORKTREE"
-                    fi
-                else
-                    echo "   Worktree Match: missing"
-                fi
-
-                if $SHOW_SWITCH; then
-                    if [[ -d "$EXPECTED_WORKTREE" ]]; then
-                        if $DO_CD; then
-                            if [[ "${BASH_SOURCE[0]}" != "$0" ]]; then
-                                cd "$EXPECTED_WORKTREE"
-                                echo "   Auto Switched: yes ($PWD)"
-                            else
-                                echo "   Auto Switched: no (requires sourced execution)"
-                                echo "   Run: source .claude/scripts/flow-workspace-start.sh $CURRENT_REQ --switch --cd"
-                            fi
-                        else
-                            echo "   Switch Command: cd \"$EXPECTED_WORKTREE\""
-                        fi
-                    fi
-                fi
-            fi
-        fi
-    else
-        echo "   ⚠️  Requirement directory not found"
-    fi
-else
-    echo "📋 Current Requirement: None"
-fi
-
-echo ""
-
-# Read latest journal entries
-LATEST_JOURNAL=$(ls -1 "$DEV_WORKSPACE"/journal-*.md 2>/dev/null | sort -V | tail -1)
-
-if [[ -n "$LATEST_JOURNAL" && -f "$LATEST_JOURNAL" ]]; then
-    echo "📓 Latest Journal: $(basename "$LATEST_JOURNAL")"
-    echo ""
-    echo "Recent entries:"
-    echo "---------------"
-
-    # Show last 20 lines of journal (excluding frontmatter)
-    tail -30 "$LATEST_JOURNAL" | head -20
-
-    echo ""
-    echo "---------------"
-fi
-
-echo ""
-echo "Ready to continue. Use:"
-echo "  /flow-workspace record \"message\"  - Record progress"
-echo "  /flow-workspace switch REQ-XXX|BUG-XXX - Switch requirement"

package/.claude/scripts/flow-workspace-switch.sh

@@ -1,234 +0,0 @@
-#!/bin/bash
-# [INPUT]: 依赖 common.sh、workspace/.current-req、journal-*.md
-# [OUTPUT]: 更新当前开发者的 REQ 指针，并输出/执行 worktree 切换动作
-# [POS]: scripts 的 workspace 切换脚本，被 /flow-workspace switch 与 start --switch 调用
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# ============================================================================
-# Configuration
-# ============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-WORKSPACE_DIR="$PROJECT_ROOT/devflow/workspace"
-COMMON_SH="$SCRIPT_DIR/common.sh"
-
-if [[ -f "$COMMON_SH" ]]; then
-    source "$COMMON_SH"
-fi
-
-# ============================================================================
-# Usage
-# ============================================================================
-
-usage() {
-    cat << 'EOF'
-Usage: flow-workspace-switch.sh REQ_ID [OPTIONS]
-
-Switch workspace context to a target requirement.
-
-Arguments:
-  REQ_ID                 Requirement ID (REQ-XXX or BUG-XXX)
-
-Options:
-  --developer NAME       Developer name (default: DEVFLOW_DEVELOPER or current user)
-  --print-cd             Print `cd "<worktree>"` for eval-style switching
-  --cd                   Try to execute cd (effective only when script is sourced)
-  --json                 Output in JSON format
-  --help, -h             Show help
-
-Examples:
-  flow-workspace-switch.sh REQ-123
-  flow-workspace-switch.sh REQ-123 --print-cd
-  eval "$(flow-workspace-switch.sh REQ-123 --print-cd)"
-  source flow-workspace-switch.sh REQ-123 --cd
-EOF
-}
-
-# ============================================================================
-# Parse Arguments
-# ============================================================================
-
-REQ_ID=""
-DEVELOPER="${DEVFLOW_DEVELOPER:-$(whoami)}"
-PRINT_CD=false
-DO_CD=false
-JSON_MODE=false
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --developer)
-            DEVELOPER="$2"
-            shift 2
-            ;;
-        --print-cd)
-            PRINT_CD=true
-            shift
-            ;;
-        --cd)
-            DO_CD=true
-            shift
-            ;;
-        --json)
-            JSON_MODE=true
-            shift
-            ;;
-        --help|-h)
-            usage
-            exit 0
-            ;;
-        -*)
-            echo "ERROR: Unknown option '$1'. Use --help for usage." >&2
-            exit 1
-            ;;
-        *)
-            if [[ -z "$REQ_ID" ]]; then
-                REQ_ID="$1"
-            else
-                echo "ERROR: Too many arguments. Use --help for usage." >&2
-                exit 1
-            fi
-            shift
-            ;;
-    esac
-done
-
-if [[ -z "$REQ_ID" ]]; then
-    echo "ERROR: REQ_ID is required. Use --help for usage." >&2
-    exit 1
-fi
-
-# Normalize and validate REQ_ID
-REQ_ID=$(echo "$REQ_ID" | tr '[:lower:]' '[:upper:]')
-if declare -f validate_req_id >/dev/null 2>&1; then
-    validate_req_id "$REQ_ID" || exit 1
-fi
-
-# ============================================================================
-# Resolve Workspace
-# ============================================================================
-
-DEV_WORKSPACE="$WORKSPACE_DIR/$DEVELOPER"
-if [[ ! -d "$DEV_WORKSPACE" ]]; then
-    echo "ERROR: Workspace not found for '$DEVELOPER': $DEV_WORKSPACE" >&2
-    echo "Run '/flow-workspace init $DEVELOPER' first." >&2
-    exit 1
-fi
-
-# Update current requirement pointer
-echo "$REQ_ID" > "$DEV_WORKSPACE/.current-req"
-
-# Append a lightweight journal entry
-LATEST_JOURNAL=$(ls -1 "$DEV_WORKSPACE"/journal-*.md 2>/dev/null | sort -V | tail -1)
-if [[ -z "$LATEST_JOURNAL" ]]; then
-    LATEST_JOURNAL="$DEV_WORKSPACE/journal-1.md"
-    cat > "$LATEST_JOURNAL" << EOF
----
-developer: "$DEVELOPER"
-journal_number: 1
-created_at: "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
----
-
-# Developer Journal: $DEVELOPER
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
----
-EOF
-fi
-
-TIMESTAMP=$(date +"%Y-%m-%d %H:%M")
-cat >> "$LATEST_JOURNAL" << EOF
-## [$TIMESTAMP] Requirement Switch
-
-**REQ**: $REQ_ID
-
-Switched workspace pointer to \`$REQ_ID\`.
-
----
-EOF
-
-# Resolve worktree path
-WORKTREE_DIR=""
-WORKTREE_EXISTS=false
-if declare -f get_worktree_dir_for_req >/dev/null 2>&1; then
-    WORKTREE_DIR=$(get_worktree_dir_for_req "$REQ_ID" 2>/dev/null || echo "")
-fi
-if [[ -n "$WORKTREE_DIR" && -d "$WORKTREE_DIR" ]]; then
-    WORKTREE_EXISTS=true
-fi
-
-# Source detection: cd can only affect caller shell when sourced
-IS_SOURCED=false
-if [[ "${BASH_SOURCE[0]}" != "$0" ]]; then
-    IS_SOURCED=true
-fi
-
-CD_EXECUTED=false
-if $DO_CD; then
-    if ! $WORKTREE_EXISTS; then
-        echo "ERROR: Worktree not found for $REQ_ID: $WORKTREE_DIR" >&2
-        exit 1
-    fi
-
-    if $IS_SOURCED; then
-        cd "$WORKTREE_DIR"
-        CD_EXECUTED=true
-    fi
-fi
-
-# ============================================================================
-# Output
-# ============================================================================
-
-if $JSON_MODE; then
-    printf '{"developer":"%s","req_id":"%s","workspace":"%s","worktree_dir":"%s","worktree_exists":%s,"cd_executed":%s}\n' \
-        "$DEVELOPER" \
-        "$REQ_ID" \
-        "$DEV_WORKSPACE" \
-        "$WORKTREE_DIR" \
-        "$WORKTREE_EXISTS" \
-        "$CD_EXECUTED"
-    return 0 2>/dev/null || exit 0
-fi
-
-if $PRINT_CD; then
-    if $WORKTREE_EXISTS; then
-        printf 'cd "%s"\n' "$WORKTREE_DIR"
-        return 0 2>/dev/null || exit 0
-    fi
-    echo "ERROR: Worktree not found for $REQ_ID: $WORKTREE_DIR" >&2
-    exit 1
-fi
-
-echo "✅ Workspace switched"
-echo "Developer:         $DEVELOPER"
-echo "Current REQ:       $REQ_ID"
-echo "Workspace:         $DEV_WORKSPACE"
-if [[ -n "$WORKTREE_DIR" ]]; then
-    echo "Expected Worktree: $WORKTREE_DIR"
-fi
-echo "Worktree Exists:   $WORKTREE_EXISTS"
-
-if $DO_CD; then
-    if $CD_EXECUTED; then
-        echo "Directory switched to: $PWD"
-    else
-        echo ""
-        echo "⚠️  --cd 未生效（脚本以子进程运行，无法修改父 Shell 目录）"
-        echo "Use one of:"
-        echo "  source .claude/scripts/flow-workspace-switch.sh $REQ_ID --cd"
-        echo "  eval \"\$(.claude/scripts/flow-workspace-switch.sh $REQ_ID --print-cd)\""
-    fi
-elif $WORKTREE_EXISTS; then
-    echo ""
-    echo "Next:"
-    echo "  cd \"$WORKTREE_DIR\""
-else
-    echo ""
-    echo "Worktree is missing. Create it with flow-init (default mode) or worktree-create script."
-fi
-
-return 0 2>/dev/null || exit 0

package/.claude/skills/domain/using-git-worktrees/SKILL.md

@@ -1,252 +0,0 @@
----
-name: using-git-worktrees
-description: 'Git Worktree management for parallel development. Enables multiple Claude Code sessions working on different requirements simultaneously.'
----
-
-# Using Git Worktrees Skill
-
-> [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-## Purpose
-
-支持多需求并行开发，每个 worktree 独立的 Claude 会话，互不干扰。
-
-## When to Use
-
-- 多需求并行开发
-- 代码审查时需要隔离环境
-- 紧急修复时不丢失当前工作
-- 需要在不同分支间快速切换
-
-## Core Concepts
-
-### Worktree vs Branch
-
-| 传统分支 | Git Worktree |
-|---------|--------------|
-| `git checkout` 切换 | `cd` 切换目录 |
-| 需要 stash 当前工作 | 工作区完全隔离 |
-| 单一 Claude 会话 | 每个 worktree 独立会话 |
-| 切换耗时 ~30s | 切换耗时 ~1s |
-
-### 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 (可选)
-```
-
-### Naming Convention
-
-```
-Worktree 目录: {repo-name}-{REQ_ID}
-对应分支: feature/{REQ_ID}-{slug}
-```
-
-## Commands
-
-### Create Worktree
-
-```bash
-# 创建新 worktree + 分支
-bash scripts/worktree-create.sh "REQ-123" "Feature Title"
-
-# 仅创建 worktree (分支已存在)
-bash scripts/worktree-create.sh "REQ-123" --existing-branch
-```
-
-### List Worktrees
-
-```bash
-# 列出所有 worktree
-bash scripts/worktree-list.sh
-
-# JSON 格式输出
-bash scripts/worktree-list.sh --json
-```
-
-### Switch Worktree
-
-```bash
-# 切换到指定 worktree
-bash scripts/worktree-switch.sh "REQ-123"
-
-# 或直接 cd
-cd ../cc-devflow-REQ-123
-```
-
-### Cleanup Worktree
-
-```bash
-# 清理单个 worktree
-bash scripts/worktree-cleanup.sh "REQ-123"
-
-# 清理所有已合并的 worktree
-bash scripts/worktree-cleanup.sh --merged
-```
-
-### Status Check
-
-```bash
-# 检查当前 worktree 状态
-bash scripts/worktree-status.sh
-```
-
-## Shell Aliases (Recommended)
-
-将以下内容添加到 `~/.zshrc` 或 `~/.bashrc`:
-
-```bash
-# 快速导航
-alias za='cd $(git rev-parse --show-toplevel 2>/dev/null || echo .)'  # 当前 worktree 根目录
-alias zl='git worktree list'                                           # 列出所有 worktree
-alias zm='cd ~/projects/cc-devflow'                                    # 主仓库
-
-# 快速切换函数
-zw() {
-  local req_id="${1:-}"
-  if [[ -z "$req_id" ]]; then
-    echo "Usage: zw REQ-123"
-    return 1
-  fi
-  local repo_name=$(basename $(git -C ~/projects/cc-devflow rev-parse --show-toplevel 2>/dev/null))
-  local target_dir=~/projects/${repo_name}-${req_id}
-  if [[ -d "$target_dir" ]]; then
-    cd "$target_dir"
-  else
-    echo "Worktree not found: $target_dir"
-    return 1
-  fi
-}
-```
-
-## Integration with CC-DevFlow
-
-### flow-init
-
-默认使用 worktree 模式:
-
-```bash
-/flow-init "REQ-123|Feature Title"
-# 创建: ../cc-devflow-REQ-123/
-# 分支: feature/REQ-123-feature-title
-```
-
-兼容模式 (传统分支):
-
-```bash
-/flow-init "REQ-123|Feature Title" --branch-only
-```
-
-### flow-release
-
-自动清理 worktree:
-
-```bash
-/flow-release "REQ-123"
-# 1. 合并分支
-# 2. 删除 worktree
-# 3. 删除分支
-```
-
-### flow-restart
-
-切换到已有 worktree:
-
-```bash
-/flow-restart "REQ-123"
-# cd ../cc-devflow-REQ-123
-```
-
-## Session Management
-
-每个 worktree 可以运行独立的 Claude Code 会话:
-
-```bash
-# 终端 1: REQ-001
-cd ~/projects/cc-devflow-REQ-001
-claude
-
-# 终端 2: REQ-002
-cd ~/projects/cc-devflow-REQ-002
-claude
-
-# 终端 3: 主仓库 (代码审查)
-cd ~/projects/cc-devflow
-claude
-```
-
-## Best Practices
-
-### 1. 保持主仓库干净
-
-主仓库 (`cc-devflow/`) 应始终在 `main` 分支，用于:
-- 创建新 worktree
-- 代码审查
-- 合并操作
-
-### 2. 定期清理
-
-```bash
-# 清理已合并的 worktree
-bash scripts/worktree-cleanup.sh --merged
-```
-
-### 3. 命名一致性
-
-- Worktree 目录: `{repo}-{REQ_ID}`
-- 分支名: `feature/{REQ_ID}-{slug}`
-
-### 4. 紧急修复流程
-
-```bash
-# 1. 在主仓库创建 hotfix worktree
-cd ~/projects/cc-devflow
-git worktree add ../cc-devflow-hotfix -b hotfix/critical-fix
-
-# 2. 修复并合并
-cd ../cc-devflow-hotfix
-# ... 修复代码 ...
-git push origin hotfix/critical-fix
-
-# 3. 清理
-cd ~/projects/cc-devflow
-git worktree remove ../cc-devflow-hotfix
-git branch -d hotfix/critical-fix
-```
-
-## Error Handling
-
-| 错误 | 解决方案 |
-|------|----------|
-| Worktree 目录已存在 | 使用 `--force` 或手动删除 |
-| 分支已被其他 worktree 使用 | 先删除旧 worktree |
-| 主仓库不在 main 分支 | `git checkout main` |
-| 磁盘空间不足 | 清理已合并的 worktree |
-
-## Scripts Reference
-
-| Script | Purpose |
-|--------|---------|
-| `scripts/worktree-create.sh` | 创建 worktree |
-| `scripts/worktree-list.sh` | 列出 worktree |
-| `scripts/worktree-switch.sh` | 切换 worktree |
-| `scripts/worktree-cleanup.sh` | 清理 worktree |
-| `scripts/worktree-status.sh` | 状态检查 |
-
-## Assets Reference
-
-| Asset | Purpose |
-|-------|---------|
-| `assets/SHELL_ALIASES.md` | Shell 别名模板 |
-
----
-
-**Related Skills**:
-- `flow-init` - 需求初始化 (worktree 创建)
-- `flow-release` - 发布管理 (worktree 清理)
-- `finishing-branch` - 分支完成决策