cc-devflow 4.2.0 → 4.4.1

package/.claude/skills/workflow/flow-init/scripts/create-requirement.sh

@@ -1,404 +0,0 @@
-#!/usr/bin/env bash
-
-# Create new requirement structure for cc-devflow
-#
-# This script initializes a new requirement or BUG directory structure.
-# Based on spec-kit's create-new-feature.sh design.
-#
-# Usage: ./create-requirement.sh [REQ_ID] [OPTIONS]
-#
-# ARGUMENTS:
-#   REQ_ID              Requirement ID (REQ-XXX or BUG-XXX format)
-#                       Optional if --interactive mode is used
-#
-# OPTIONS:
-#   --title TITLE       Requirement title
-#   --branch-title TITLE Branch title (deprecated, ignored)
-#   --description DESC  Brief description (optional)
-#   --skip-git          Deprecated (git operations removed)
-#   --interactive, -i   Interactive mode (prompts for inputs)
-#   --json              Output in JSON format
-#   --help, -h          Show help message
-#
-# EXAMPLES:
-#   # Create requirement
-#   ./create-requirement.sh REQ-123 --title "User authentication"
-#
-#   # Interactive mode
-#   ./create-requirement.sh --interactive
-#
-#   # Create BUG structure
-#   ./create-requirement.sh BUG-456 --title "Fix login issue" --skip-git
-#
-#   # JSON output for automation
-#   ./create-requirement.sh REQ-123 --title "API Gateway" --json
-
-set -e
-
-# Parse command line arguments
-REQ_ID=""
-TITLE=""
-BRANCH_TITLE=""
-DESCRIPTION=""
-SKIP_GIT=false
-BRANCH_ONLY=false
-USE_WORKTREE=true
-INTERACTIVE=false
-JSON_MODE=false
-AUTO_ID=false
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --title)
-            TITLE="$2"
-            shift 2
-            ;;
-        --branch-title)
-            BRANCH_TITLE="$2"
-            shift 2
-            ;;
-        --description)
-            DESCRIPTION="$2"
-            shift 2
-            ;;
-        --skip-git|--branch-only|--worktree)
-            # Deprecated: git operations removed from DevFlow
-            shift
-            ;;
-        --interactive|-i)
-            INTERACTIVE=true
-            shift
-            ;;
-        --json)
-            JSON_MODE=true
-            shift
-            ;;
-        --auto-id)
-            AUTO_ID=true
-            shift
-            ;;
-        --help|-h)
-            cat << 'EOF'
-Usage: create-requirement.sh [REQ_ID] [OPTIONS]
-
-Create new requirement or BUG structure for cc-devflow.
-
-ARGUMENTS:
-  REQ_ID              Requirement ID (REQ-XXX or BUG-XXX format)
-                      Optional if --interactive mode is used
-
-OPTIONS:
-  --title TITLE       Requirement title
-  --branch-title TITLE Deprecated (ignored)
-  --description DESC  Brief description (optional)
-  --interactive, -i   Interactive mode (prompts for inputs)
-  --json              Output results in JSON format
-  --auto-id           Auto-select next available REQ-ID when missing or duplicated
-  --help, -h          Show this help message
-
-EXAMPLES:
-  # Create requirement with worktree (default)
-  ./create-requirement.sh REQ-123 --title "User authentication"
-
-  # Create requirement with traditional branch
-  ./create-requirement.sh REQ-123 --title "User authentication" --branch-only
-
-  # Interactive mode
-  ./create-requirement.sh --interactive
-
-  # Create BUG structure
-  ./create-requirement.sh BUG-456 --title "Fix login issue"
-
-  # JSON output
-  ./create-requirement.sh REQ-123 --title "API Gateway" --json
-
-STRUCTURE CREATED:
-  Requirements (REQ-XXX):
-    devflow/requirements/REQ-XXX/
-    ├── research/              # External research materials
-    ├── EXECUTION_LOG.md       # Event log
-    └── orchestration_status.json  # Status tracking
-
-  BUG Fixes (BUG-XXX):
-    devflow/bugs/BUG-XXX/
-    ├── EXECUTION_LOG.md
-    └── status.json
-
-NOTE:
-  Git branch/worktree management is handled externally by the user.
-  DevFlow only creates the requirement directory structure.
-
-EOF
-            exit 0
-            ;;
-        -*)
-            echo "ERROR: Unknown option '$1'. Use --help for usage information." >&2
-            exit 1
-            ;;
-        *)
-            if [[ -z "$REQ_ID" ]]; then
-                REQ_ID="$1"
-            else
-                echo "ERROR: Too many arguments. Use --help for usage information." >&2
-                exit 1
-            fi
-            shift
-            ;;
-    esac
-done
-
-# Source common functions
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-COMMON_SH="$SCRIPT_DIR/common.sh"
-if [[ ! -f "$COMMON_SH" ]]; then
-    COMMON_SH="$SCRIPT_DIR/../../../../scripts/common.sh"
-fi
-if [[ ! -f "$COMMON_SH" ]]; then
-    echo "ERROR: common.sh not found (checked local + .claude/scripts)" >&2
-    exit 1
-fi
-source "$COMMON_SH"
-REPO_ROOT=$(get_repo_root)
-
-# Interactive mode
-if $INTERACTIVE; then
-    if ! $JSON_MODE; then
-        echo "=== Create New Requirement ==="
-        echo ""
-    fi
-
-    # Prompt for requirement ID if not provided
-    if [[ -z "$REQ_ID" ]]; then
-        suggested_req_id=$(next_available_req_id "$REPO_ROOT")
-        read -p "Requirement ID (REQ-XXX or BUG-XXX) [${suggested_req_id}]: " input_req_id
-        input_req_id=$(echo "${input_req_id}" | tr '[:lower:]' '[:upper:]')
-        if [[ -z "$input_req_id" ]]; then
-            AUTO_ID=true
-            REQ_ID="$suggested_req_id"
-        else
-            REQ_ID="$input_req_id"
-        fi
-    fi
-
-    # Prompt for title if not provided
-    if [[ -z "$TITLE" ]]; then
-        read -p "Requirement Title: " TITLE
-    fi
-
-    # Prompt for description
-    if [[ -z "$DESCRIPTION" ]]; then
-        read -p "Brief Description (optional): " DESCRIPTION
-    fi
-
-    # Prompt for git branch creation
-    if ! $SKIP_GIT && has_git; then
-        read -p "Create git branch? (y/n): " create_branch
-        if [[ "$create_branch" != "y" && "$create_branch" != "Y" ]]; then
-            SKIP_GIT=true
-        fi
-    fi
-fi
-
-# Ensure requirement ID is set, auto-select when allowed
-if [[ -z "$REQ_ID" ]]; then
-    AUTO_ID=true
-    REQ_ID=$(next_available_req_id "$REPO_ROOT")
-    if [[ -z "$REQ_ID" ]]; then
-        echo "ERROR: Unable to determine next requirement ID" >&2
-        exit 1
-    fi
-    if ! $JSON_MODE; then
-        echo "Auto-selected requirement ID: $REQ_ID" >&2
-    fi
-fi
-
-# Normalize requirement ID to uppercase
-REQ_ID=$(echo "$REQ_ID" | tr '[:lower:]' '[:upper:]')
-
-# Validate requirement ID format
-validate_req_id "$REQ_ID" || exit 1
-
-# Resolve conflicts when requirement ID already exists
-if req_id_in_use "$REPO_ROOT" "$REQ_ID"; then
-    if $AUTO_ID; then
-        original_req_id="$REQ_ID"
-        while req_id_in_use "$REPO_ROOT" "$REQ_ID"; do
-            next_candidate=$(next_available_req_id "$REPO_ROOT")
-            if [[ "$next_candidate" == "$REQ_ID" ]]; then
-                next_candidate="REQ-$(date +%Y%m%d%H%M%S)"
-            fi
-            REQ_ID="$next_candidate"
-        done
-        if [[ "$REQ_ID" != "$original_req_id" ]] && ! $JSON_MODE; then
-            echo "Requirement ID in use; switched to $REQ_ID" >&2
-        fi
-    else
-        suggested_req_id=$(next_available_req_id "$REPO_ROOT")
-        conflict_dir=$(get_req_dir "$REPO_ROOT" "$REQ_ID")
-        echo "ERROR: Requirement directory already exists: $conflict_dir" >&2
-        if [[ "$suggested_req_id" != "$REQ_ID" ]]; then
-            echo "Suggested next available ID: $suggested_req_id" >&2
-        fi
-        exit 1
-    fi
-fi
-
-# Get requirement type and directory
-REQ_TYPE=$(get_req_type "$REQ_ID")
-REQ_DIR=$(get_req_dir "$REPO_ROOT" "$REQ_ID")
-
-# Create directory structure
-if ! $JSON_MODE; then
-    echo "Creating requirement structure at $REQ_DIR..." >&2
-fi
-
-# Create directories
-mkdir -p "$REQ_DIR/research"
-
-# Initialize EXECUTION_LOG.md
-cat > "$REQ_DIR/EXECUTION_LOG.md" <<EOF
-# Execution Log: $REQ_ID
-
-**Title**: ${TITLE:-"To be defined"}
-**Type**: $REQ_TYPE
-**Created**: $(get_beijing_time_full)
-
-EOF
-
-if [[ -n "$DESCRIPTION" ]]; then
-    cat >> "$REQ_DIR/EXECUTION_LOG.md" <<EOF
-## Description
-$DESCRIPTION
-
-EOF
-fi
-
-cat >> "$REQ_DIR/EXECUTION_LOG.md" <<'EOF'
-## Events
-
-EOF
-
-# Initialize status file
-if [[ "$REQ_TYPE" == "bug" ]]; then
-    # BUG-specific status file
-    cat > "$REQ_DIR/status.json" <<EOF
-{
-  "bugId": "$REQ_ID",
-  "title": "${TITLE:-"To be defined"}",
-  "status": "initialized",
-  "phase": "analysis",
-  "severity": "unknown",
-  "createdAt": "$(get_beijing_time_iso)",
-  "updatedAt": "$(get_beijing_time_iso)"
-}
-EOF
-else
-    # Requirement status file
-    cat > "$REQ_DIR/orchestration_status.json" <<EOF
-{
-  "reqId": "$REQ_ID",
-  "title": "${TITLE:-"To be defined"}",
-  "status": "initialized",
-  "phase": "planning",
-  "createdAt": "$(get_beijing_time_iso)",
-  "updatedAt": "$(get_beijing_time_iso)"
-}
-EOF
-fi
-
-# Create README.md for the requirement
-cat > "$REQ_DIR/README.md" <<EOF
-# $REQ_ID: ${TITLE:-"To be defined"}
-
-**Status**: Initialized
-**Type**: $REQ_TYPE
-**Created**: $(get_beijing_time_full)
-
-EOF
-
-if [[ -n "$DESCRIPTION" ]]; then
-    cat >> "$REQ_DIR/README.md" <<EOF
-## Description
-$DESCRIPTION
-
-EOF
-fi
-
-cat >> "$REQ_DIR/README.md" <<'EOF'
-## Documents
-
-### Planning Phase
-- [ ] PRD.md - Product Requirements Document
-- [ ] EPIC.md - Epic Planning
-- [ ] TASKS.md - Task Breakdown
-
-### Execution Phase
-- [ ] TEST_PLAN.md - Test Plan
-- [ ] SECURITY_PLAN.md - Security Plan
-- [ ] EXECUTION_LOG.md - Event Log
-
-### Review Phase
-- [ ] TEST_REPORT.md - Test Report
-- [ ] SECURITY_REPORT.md - Security Report
-- [ ] RELEASE_PLAN.md - Release Plan
-
-## Research Materials
-Place external research materials in `research/` directory:
-- API documentation
-- Design specifications
-- Reference implementations
-- Planning documents
-
-## Workflow
-1. **Planning**: Create PRD → Generate EPIC → Break down TASKS
-2. **Development**: Implement tasks following TDD approach
-3. **Quality**: Execute test plan and security review
-4. **Release**: Create release plan and merge to main
-
-EOF
-
-# Log the creation event
-log_event "$REQ_ID" "Requirement structure initialized"
-
-if [[ -n "$TITLE" ]]; then
-    log_event "$REQ_ID" "Title: $TITLE"
-fi
-
-if [[ -n "$DESCRIPTION" ]]; then
-    log_event "$REQ_ID" "Description: $DESCRIPTION"
-fi
-
-# Set environment variable for REQ identification
-export DEVFLOW_REQ_ID="$REQ_ID"
-
-# Output results
-if $JSON_MODE; then
-    printf '{"req_id":"%s","req_type":"%s","req_dir":"%s","title":"%s","created_at":"%s"}\n' \
-        "$REQ_ID" \
-        "$REQ_TYPE" \
-        "$REQ_DIR" \
-        "${TITLE:-""}" \
-        "$(get_beijing_time_iso)"
-else
-    echo ""
-    echo "✅ Requirement structure created successfully!"
-    echo ""
-    echo "Requirement ID:    $REQ_ID"
-    echo "Type:              $REQ_TYPE"
-    echo "Directory:         $REQ_DIR"
-    if [[ -n "$TITLE" ]]; then
-        echo "Title:             $TITLE"
-    fi
-    echo ""
-    echo "Next Steps:"
-    if [[ "$REQ_TYPE" == "bug" ]]; then
-        echo "  1. Run bug-analyzer agent to analyze the BUG"
-        echo "  2. Run /flow-fix to start BUG fix workflow"
-        echo "  3. Keep EXECUTION_LOG.md updated during fixes"
-    else
-        echo "  1. Add research materials to research/ (optional)"
-        echo "  2. Run prd-writer agent to create PRD.md"
-        echo "  3. Continue with planner and subsequent flow commands"
-    fi
-    echo ""
-fi

package/.claude/skills/workflow/flow-init/scripts/generate-research-tasks.sh

@@ -1,157 +0,0 @@
-#!/usr/bin/env bash
-# shellcheck disable=SC2312
-
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: .claude/scripts/generate-research-tasks.sh <requirement-dir>
-
-Scans the requirement directory for "NEEDS CLARIFICATION" markers and technology
-choices, then writes research/tasks.json with structured tasks ready for agents.
-USAGE
-}
-
-if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
-  usage
-  exit 0
-fi
-
-if [[ $# -lt 1 ]]; then
-  echo "Error: requirement directory is required." >&2
-  usage
-  exit 1
-fi
-
-REQ_DIR="$1"
-if [[ ! -d "$REQ_DIR" ]]; then
-  echo "Error: requirement directory '$REQ_DIR' does not exist." >&2
-  exit 1
-fi
-
-python3 - "$REQ_DIR" <<'PY'
-from __future__ import annotations
-
-import json
-import os
-import re
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import List, Dict
-
-req_dir = Path(sys.argv[1]).resolve()
-research_dir = req_dir / "research"
-research_dir.mkdir(exist_ok=True, parents=True)
-tasks_path = research_dir / "tasks.json"
-
-def to_relative(p: Path) -> str:
-    try:
-        return str(p.relative_to(req_dir))
-    except ValueError:
-        return str(p)
-
-def detect_feature_name() -> str:
-    readme = req_dir / "README.md"
-    if readme.exists():
-        for line in readme.read_text(encoding="utf-8").splitlines():
-            line = line.strip("# ").strip()
-            if line:
-                return line
-    return req_dir.name
-
-def collect_unknowns() -> List[Dict[str, str]]:
-    pattern = re.compile(r"NEEDS CLARIFICATION", re.IGNORECASE)
-    unknowns = []
-    for path in req_dir.rglob("*.md"):
-        if path.name in {"research.md", "ui_design_strategy.md"}:
-            continue
-        rel = to_relative(path)
-        for idx, line in enumerate(path.read_text(encoding="utf-8", errors="ignore").splitlines(), start=1):
-            if pattern.search(line):
-                topic = line.split("NEEDS CLARIFICATION", 1)[0]
-                topic = topic.replace("-", " ").replace("*", " ").replace("•", " ")
-                topic = topic.split(":")[-1].strip()
-                if not topic:
-                    topic = "unspecified topic"
-                payload = {
-                    "topic": re.sub(r"\s+", " ", topic).strip(),
-                    "source": f"{rel}:{idx}",
-                }
-                if payload not in unknowns:
-                    unknowns.append(payload)
-    return unknowns
-
-def collect_technologies() -> List[Dict[str, str]]:
-    tech_entries = []
-    bold_line = re.compile(r"^\s*[-*]\s*\*\*(?P<label>[^*]+)\*\*:\s*(?P<value>.+)$")
-    for filename in ("plan.md", "PLAN.md", "TECH_DESIGN.md"):
-        file_path = req_dir / filename
-        if not file_path.exists():
-            continue
-        for line in file_path.read_text(encoding="utf-8", errors="ignore").splitlines():
-            match = bold_line.match(line)
-            if match:
-                label = match.group("label").strip()
-                value = match.group("value").strip()
-                entry = {"label": label, "value": value}
-                if entry not in tech_entries:
-                    tech_entries.append(entry)
-    return tech_entries
-
-feature_name = detect_feature_name()
-unknowns = collect_unknowns()
-technologies = collect_technologies()
-
-tasks: List[Dict[str, object]] = []
-
-counter = 1
-def next_id() -> str:
-    global counter
-    ident = f"R{counter:03}"
-    counter += 1
-    return ident
-
-for unknown in unknowns:
-    tasks.append(
-        {
-            "id": next_id(),
-            "type": "clarification",
-            "prompt": f"Research {unknown['topic']} for {feature_name}",
-            "source": unknown["source"],
-            "status": "open",
-            "decision": "",      # 新增: 空字段，等待填充
-            "rationale": "",     # 新增: 空字段，等待填充
-            "alternatives": "",  # 新增: 空字段，等待填充
-        }
-    )
-
-for tech in technologies:
-    label = tech["label"]
-    value = tech["value"]
-    # strip trailing notes after parentheses to keep prompt concise
-    prompt_value = value.split(";")[0].strip()
-    tasks.append(
-        {
-            "id": next_id(),
-            "type": "best_practices",
-            "prompt": f"Find best practices for {prompt_value} in the context of {feature_name}",
-            "source": f"Tech-Choice:{label}",
-            "status": "open",
-            "decision": "",      # 新增: 空字段，等待填充
-            "rationale": "",     # 新增: 空字段，等待填充
-            "alternatives": "",  # 新增: 空字段，等待填充
-        }
-    )
-
-data = {
-    "feature": feature_name,
-    "generatedAt": datetime.now(timezone.utc).isoformat(),
-    "requirementDir": str(req_dir),
-    "tasks": tasks,
-}
-
-tasks_path.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
-
-print(f"Generated {len(tasks)} research task(s) for {feature_name} → {tasks_path}")
-PY