cc-devflow 4.1.4 → 4.1.6

package/.claude/skills/domain/using-git-worktrees/assets/SHELL_ALIASES.md

@@ -1,133 +0,0 @@
-# Git Worktree Shell Aliases
-
-> 将以下内容添加到 `~/.zshrc` 或 `~/.bashrc`
-
-## Quick Navigation
-
-```bash
-# =============================================================================
-# Git Worktree Aliases for CC-DevFlow
-# =============================================================================
-
-# 快速导航到当前 worktree 根目录
-alias za='cd $(git rev-parse --show-toplevel 2>/dev/null || echo .)'
-
-# 列出所有 worktree
-alias zl='git worktree list'
-
-# 导航到主仓库 (修改为你的实际路径)
-alias zm='cd ~/projects/cc-devflow'
-
-# 快速切换到指定 REQ 的 worktree
-zw() {
-  local req_id="${1:-}"
-  if [[ -z "$req_id" ]]; then
-    echo "Usage: zw REQ-123"
-    echo ""
-    echo "Available worktrees:"
-    git worktree list
-    return 1
-  fi
-
-  # Normalize to uppercase
-  req_id=$(echo "$req_id" | tr '[:lower:]' '[:upper:]')
-
-  # Get repo name from current git repo or main repo
-  local main_repo
-  if git rev-parse --show-toplevel >/dev/null 2>&1; then
-    main_repo=$(git rev-parse --show-toplevel)
-    # If in worktree, find main repo
-    local git_dir=$(git rev-parse --git-dir)
-    if [[ "$git_dir" == *".git/worktrees/"* ]]; then
-      main_repo=$(cat "$(git rev-parse --show-toplevel)/.git" 2>/dev/null | sed 's/gitdir: //' | sed 's|/.git/worktrees/.*||')
-    fi
-  else
-    main_repo=~/projects/cc-devflow
-  fi
-
-  local repo_name=$(basename "$main_repo")
-  local target_dir="$(dirname "$main_repo")/${repo_name}-${req_id}"
-
-  if [[ -d "$target_dir" ]]; then
-    cd "$target_dir"
-    echo "Switched to: $target_dir"
-    echo "Branch: $(git rev-parse --abbrev-ref HEAD)"
-  else
-    echo "Worktree not found: $target_dir"
-    echo ""
-    echo "Available worktrees:"
-    git worktree list
-    return 1
-  fi
-}
-
-# 创建新 worktree (快捷方式)
-zwn() {
-  local req_id="${1:-}"
-  local title="${2:-}"
-
-  if [[ -z "$req_id" ]]; then
-    echo "Usage: zwn REQ-123 [title]"
-    return 1
-  fi
-
-  # Find the skill script
-  local script_path
-  if [[ -f ".claude/skills/domain/using-git-worktrees/scripts/worktree-create.sh" ]]; then
-    script_path=".claude/skills/domain/using-git-worktrees/scripts/worktree-create.sh"
-  elif [[ -f "$(git rev-parse --show-toplevel 2>/dev/null)/.claude/skills/domain/using-git-worktrees/scripts/worktree-create.sh" ]]; then
-    script_path="$(git rev-parse --show-toplevel)/.claude/skills/domain/using-git-worktrees/scripts/worktree-create.sh"
-  else
-    echo "ERROR: worktree-create.sh not found"
-    return 1
-  fi
-
-  bash "$script_path" "$req_id" "$title"
-}
-
-# 清理已合并的 worktree
-zwc() {
-  local script_path
-  if [[ -f ".claude/skills/domain/using-git-worktrees/scripts/worktree-cleanup.sh" ]]; then
-    script_path=".claude/skills/domain/using-git-worktrees/scripts/worktree-cleanup.sh"
-  elif [[ -f "$(git rev-parse --show-toplevel 2>/dev/null)/.claude/skills/domain/using-git-worktrees/scripts/worktree-cleanup.sh" ]]; then
-    script_path="$(git rev-parse --show-toplevel)/.claude/skills/domain/using-git-worktrees/scripts/worktree-cleanup.sh"
-  else
-    echo "ERROR: worktree-cleanup.sh not found"
-    return 1
-  fi
-
-  bash "$script_path" --merged "$@"
-}
-```
-
-## Usage Examples
-
-```bash
-# 列出所有 worktree
-zl
-
-# 切换到 REQ-123 的 worktree
-zw REQ-123
-
-# 创建新 worktree
-zwn REQ-456 "New Feature"
-
-# 清理已合并的 worktree
-zwc
-
-# 导航到主仓库
-zm
-
-# 导航到当前 worktree 根目录
-za
-```
-
-## Customization
-
-根据你的项目路径修改 `zm` 别名:
-
-```bash
-# 如果主仓库在不同位置
-alias zm='cd /path/to/your/main/repo'
-```

package/.claude/skills/domain/using-git-worktrees/context.jsonl

@@ -1,4 +0,0 @@
-{"file": ".claude/scripts/common.sh", "reason": "Worktree helper functions"}
-{"file": ".claude/skills/workflow/flow-init/SKILL.md", "reason": "Worktree creation integration"}
-{"file": ".claude/skills/workflow/flow-release/SKILL.md", "reason": "Worktree cleanup integration"}
-{"file": ".claude/rules/devflow-conventions.md", "reason": "Git worktree conventions", "optional": true}

package/.claude/skills/domain/using-git-worktrees/scripts/worktree-cleanup.sh

@@ -1,218 +0,0 @@
-#!/usr/bin/env bash
-# =============================================================================
-# worktree-cleanup.sh - Clean up git worktrees
-# =============================================================================
-#
-# Usage: worktree-cleanup.sh [REQ_ID] [OPTIONS]
-#
-# ARGUMENTS:
-#   REQ_ID              Specific requirement to clean up (optional)
-#
-# OPTIONS:
-#   --merged            Clean up all worktrees with merged branches
-#   --force             Force removal even if branch not merged
-#   --dry-run           Show what would be cleaned without doing it
-#   --json              Output in JSON format
-#   --help, -h          Show help message
-#
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-REQ_ID=""
-MERGED_ONLY=false
-FORCE=false
-DRY_RUN=false
-JSON_MODE=false
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --merged)
-            MERGED_ONLY=true
-            shift
-            ;;
-        --force)
-            FORCE=true
-            shift
-            ;;
-        --dry-run)
-            DRY_RUN=true
-            shift
-            ;;
-        --json)
-            JSON_MODE=true
-            shift
-            ;;
-        --help|-h)
-            cat << 'EOF'
-Usage: worktree-cleanup.sh [REQ_ID] [OPTIONS]
-
-Clean up git worktrees.
-
-ARGUMENTS:
-  REQ_ID              Specific requirement to clean up (optional)
-
-OPTIONS:
-  --merged            Clean up all worktrees with merged branches
-  --force             Force removal even if branch not merged
-  --dry-run           Show what would be cleaned without doing it
-  --json              Output in JSON format
-  --help, -h          Show help message
-
-EXAMPLES:
-  worktree-cleanup.sh REQ-123           # Clean specific worktree
-  worktree-cleanup.sh --merged          # Clean all merged worktrees
-  worktree-cleanup.sh --merged --dry-run # Preview cleanup
-EOF
-            exit 0
-            ;;
-        -*)
-            echo "ERROR: Unknown option '$1'. Use --help for usage." >&2
-            exit 1
-            ;;
-        *)
-            REQ_ID="$1"
-            shift
-            ;;
-    esac
-done
-
-# =============================================================================
-# Source Common Functions
-# =============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-COMMON_SH="$SCRIPT_DIR/../../../scripts/common.sh"
-
-if [[ -f "$COMMON_SH" ]]; then
-    source "$COMMON_SH"
-fi
-
-# =============================================================================
-# Get Main Repo
-# =============================================================================
-
-MAIN_REPO=$(git rev-parse --show-toplevel 2>/dev/null)
-if [[ -z "$MAIN_REPO" ]]; then
-    echo "ERROR: Not in a git repository" >&2
-    exit 1
-fi
-
-REPO_NAME=$(basename "$MAIN_REPO")
-
-# =============================================================================
-# Cleanup Functions
-# =============================================================================
-
-cleanup_worktree() {
-    local path="$1"
-    local branch="$2"
-    local force_flag=""
-
-    if $FORCE; then
-        force_flag="--force"
-    fi
-
-    if $DRY_RUN; then
-        if ! $JSON_MODE; then
-            echo "[DRY-RUN] Would remove: $path (branch: $branch)"
-        fi
-        return 0
-    fi
-
-    # Remove worktree
-    git -C "$MAIN_REPO" worktree remove "$path" $force_flag 2>/dev/null || {
-        if $FORCE; then
-            rm -rf "$path"
-        else
-            echo "ERROR: Failed to remove worktree $path" >&2
-            return 1
-        fi
-    }
-
-    # Delete branch if not main/master
-    if [[ "$branch" != "main" && "$branch" != "master" && -n "$branch" && "$branch" != "(detached)" ]]; then
-        if $FORCE; then
-            git -C "$MAIN_REPO" branch -D "$branch" 2>/dev/null || true
-        else
-            git -C "$MAIN_REPO" branch -d "$branch" 2>/dev/null || true
-        fi
-    fi
-
-    if ! $JSON_MODE; then
-        echo "Removed: $path (branch: $branch)"
-    fi
-}
-
-# =============================================================================
-# Main Logic
-# =============================================================================
-
-if [[ -n "$REQ_ID" ]]; then
-    # Clean specific worktree
-    REQ_ID=$(echo "$REQ_ID" | tr '[:lower:]' '[:upper:]')
-    WORKTREE_DIR="$(dirname "$MAIN_REPO")/${REPO_NAME}-${REQ_ID}"
-
-    if [[ ! -d "$WORKTREE_DIR" ]]; then
-        if $JSON_MODE; then
-            printf '{"error":"not_found","path":"%s"}\n' "$WORKTREE_DIR"
-        else
-            echo "ERROR: Worktree not found: $WORKTREE_DIR" >&2
-        fi
-        exit 1
-    fi
-
-    # Get branch name
-    BRANCH=$(git -C "$WORKTREE_DIR" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
-
-    cleanup_worktree "$WORKTREE_DIR" "$BRANCH"
-
-    if $JSON_MODE; then
-        printf '{"cleaned":[{"path":"%s","branch":"%s"}]}\n' "$WORKTREE_DIR" "$BRANCH"
-    fi
-
-elif $MERGED_ONLY; then
-    # Clean all merged worktrees
-    cleaned=()
-
-    while IFS= read -r line; do
-        if [[ "$line" =~ ^worktree ]]; then
-            path="${line#worktree }"
-        elif [[ "$line" =~ ^branch ]]; then
-            branch="${line#branch refs/heads/}"
-
-            # Skip main repo
-            if [[ "$path" == "$MAIN_REPO" ]]; then
-                continue
-            fi
-
-            # Check if branch is merged into main
-            if git -C "$MAIN_REPO" branch --merged main 2>/dev/null | grep -q "^\s*$branch$"; then
-                cleanup_worktree "$path" "$branch"
-                cleaned+=("$path")
-            fi
-        fi
-    done < <(git worktree list --porcelain)
-
-    if $JSON_MODE; then
-        printf '{"cleaned":['
-        first=true
-        for p in "${cleaned[@]}"; do
-            if ! $first; then printf ','; fi
-            first=false
-            printf '"%s"' "$p"
-        done
-        printf ']}\n'
-    else
-        if [[ ${#cleaned[@]} -eq 0 ]]; then
-            echo "No merged worktrees to clean up."
-        else
-            echo ""
-            echo "Cleaned ${#cleaned[@]} worktree(s)."
-        fi
-    fi
-
-else
-    echo "ERROR: Specify REQ_ID or use --merged flag. Use --help for usage." >&2
-    exit 1
-fi

package/.claude/skills/domain/using-git-worktrees/scripts/worktree-create.sh

@@ -1,232 +0,0 @@
-#!/usr/bin/env bash
-# =============================================================================
-# worktree-create.sh - Create a new git worktree for requirement development
-# =============================================================================
-#
-# Usage: worktree-create.sh REQ_ID [TITLE] [OPTIONS]
-#
-# ARGUMENTS:
-#   REQ_ID              Requirement ID (REQ-XXX or BUG-XXX format)
-#   TITLE               Optional title for branch naming
-#
-# OPTIONS:
-#   --existing-branch   Use existing branch instead of creating new one
-#   --force             Force creation even if worktree exists
-#   --json              Output in JSON format
-#   --help, -h          Show help message
-#
-# EXAMPLES:
-#   worktree-create.sh REQ-123 "User Authentication"
-#   worktree-create.sh REQ-123 --existing-branch
-#   worktree-create.sh BUG-456 "Fix Login Issue"
-#
-# [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
-set -e
-
-# =============================================================================
-# Argument Parsing
-# =============================================================================
-
-REQ_ID=""
-TITLE=""
-EXISTING_BRANCH=false
-FORCE=false
-JSON_MODE=false
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --existing-branch)
-            EXISTING_BRANCH=true
-            shift
-            ;;
-        --force)
-            FORCE=true
-            shift
-            ;;
-        --json)
-            JSON_MODE=true
-            shift
-            ;;
-        --help|-h)
-            cat << 'EOF'
-Usage: worktree-create.sh REQ_ID [TITLE] [OPTIONS]
-
-Create a new git worktree for requirement development.
-
-ARGUMENTS:
-  REQ_ID              Requirement ID (REQ-XXX or BUG-XXX format)
-  TITLE               Optional title for branch naming
-
-OPTIONS:
-  --existing-branch   Use existing branch instead of creating new one
-  --force             Force creation even if worktree exists
-  --json              Output in JSON format
-  --help, -h          Show help message
-
-EXAMPLES:
-  worktree-create.sh REQ-123 "User Authentication"
-  worktree-create.sh REQ-123 --existing-branch
-  worktree-create.sh BUG-456 "Fix Login Issue"
-EOF
-            exit 0
-            ;;
-        -*)
-            echo "ERROR: Unknown option '$1'. Use --help for usage." >&2
-            exit 1
-            ;;
-        *)
-            if [[ -z "$REQ_ID" ]]; then
-                REQ_ID="$1"
-            elif [[ -z "$TITLE" ]]; then
-                TITLE="$1"
-            else
-                echo "ERROR: Too many arguments. Use --help for usage." >&2
-                exit 1
-            fi
-            shift
-            ;;
-    esac
-done
-
-# =============================================================================
-# Source Common Functions
-# =============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-COMMON_SH="$SCRIPT_DIR/../../../scripts/common.sh"
-
-if [[ -f "$COMMON_SH" ]]; then
-    source "$COMMON_SH"
-else
-    echo "ERROR: common.sh not found at $COMMON_SH" >&2
-    exit 1
-fi
-
-# =============================================================================
-# Validation
-# =============================================================================
-
-if [[ -z "$REQ_ID" ]]; then
-    echo "ERROR: REQ_ID is required. Use --help for usage." >&2
-    exit 1
-fi
-
-# Normalize to uppercase
-REQ_ID=$(echo "$REQ_ID" | tr '[:lower:]' '[:upper:]')
-
-# Validate format
-validate_req_id "$REQ_ID" || exit 1
-
-# =============================================================================
-# Path Calculation
-# =============================================================================
-
-MAIN_REPO=$(get_main_repo_path)
-if [[ -z "$MAIN_REPO" ]]; then
-    MAIN_REPO=$(git rev-parse --show-toplevel 2>/dev/null)
-fi
-
-if [[ -z "$MAIN_REPO" ]]; then
-    echo "ERROR: Not in a git repository" >&2
-    exit 1
-fi
-
-REPO_NAME=$(basename "$MAIN_REPO")
-WORKTREE_DIR="$(dirname "$MAIN_REPO")/${REPO_NAME}-${REQ_ID}"
-
-# Determine branch name
-REQ_TYPE=$(get_req_type "$REQ_ID")
-if [[ -n "$TITLE" ]]; then
-    BRANCH_SUFFIX=$(slugify "$TITLE")
-else
-    BRANCH_SUFFIX="dev"
-fi
-
-if [[ "$REQ_TYPE" == "bug" ]]; then
-    BRANCH_NAME="bugfix/${REQ_ID}-${BRANCH_SUFFIX}"
-else
-    BRANCH_NAME="feature/${REQ_ID}-${BRANCH_SUFFIX}"
-fi
-
-# =============================================================================
-# Pre-flight Checks
-# =============================================================================
-
-# Check if worktree already exists
-if [[ -d "$WORKTREE_DIR" ]]; then
-    if $FORCE; then
-        if ! $JSON_MODE; then
-            echo "WARNING: Removing existing worktree at $WORKTREE_DIR" >&2
-        fi
-        git -C "$MAIN_REPO" worktree remove "$WORKTREE_DIR" --force 2>/dev/null || rm -rf "$WORKTREE_DIR"
-    else
-        if $JSON_MODE; then
-            printf '{"error":"worktree_exists","path":"%s"}\n' "$WORKTREE_DIR"
-        else
-            echo "ERROR: Worktree already exists at $WORKTREE_DIR" >&2
-            echo "Use --force to recreate or cd to existing worktree" >&2
-        fi
-        exit 1
-    fi
-fi
-
-# Check if branch is already checked out in another worktree
-if ! $EXISTING_BRANCH; then
-    if git -C "$MAIN_REPO" rev-parse --verify "$BRANCH_NAME" >/dev/null 2>&1; then
-        # Branch exists, check if it's in use
-        BRANCH_WORKTREE=$(git -C "$MAIN_REPO" worktree list --porcelain | grep -A2 "branch refs/heads/$BRANCH_NAME" | head -1 | sed 's/worktree //')
-        if [[ -n "$BRANCH_WORKTREE" ]]; then
-            if $JSON_MODE; then
-                printf '{"error":"branch_in_use","branch":"%s","worktree":"%s"}\n' "$BRANCH_NAME" "$BRANCH_WORKTREE"
-            else
-                echo "ERROR: Branch $BRANCH_NAME is already checked out in $BRANCH_WORKTREE" >&2
-            fi
-            exit 1
-        fi
-        # Branch exists but not in use, use it
-        EXISTING_BRANCH=true
-    fi
-fi
-
-# =============================================================================
-# Create Worktree
-# =============================================================================
-
-if ! $JSON_MODE; then
-    echo "Creating worktree for $REQ_ID..." >&2
-fi
-
-if $EXISTING_BRANCH; then
-    # Use existing branch
-    git -C "$MAIN_REPO" worktree add "$WORKTREE_DIR" "$BRANCH_NAME"
-else
-    # Create new branch
-    git -C "$MAIN_REPO" worktree add -b "$BRANCH_NAME" "$WORKTREE_DIR"
-fi
-
-# =============================================================================
-# Output
-# =============================================================================
-
-if $JSON_MODE; then
-    printf '{"req_id":"%s","worktree_dir":"%s","branch":"%s","main_repo":"%s","created_at":"%s"}\n' \
-        "$REQ_ID" \
-        "$WORKTREE_DIR" \
-        "$BRANCH_NAME" \
-        "$MAIN_REPO" \
-        "$(get_beijing_time_iso)"
-else
-    echo ""
-    echo "✅ Worktree created successfully!"
-    echo ""
-    echo "Requirement ID:    $REQ_ID"
-    echo "Worktree:          $WORKTREE_DIR"
-    echo "Branch:            $BRANCH_NAME"
-    echo "Main Repo:         $MAIN_REPO"
-    echo ""
-    echo "Next Steps:"
-    echo "  cd $WORKTREE_DIR"
-    echo "  claude  # Start new Claude Code session"
-    echo ""
-fi