cc-devflow 1.0.1

package/.claude/scripts/generate-research-tasks.sh

@@ -0,0 +1,157 @@
+#!/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

package/.claude/scripts/generate-status-report.sh

@@ -0,0 +1,523 @@
+#!/usr/bin/env bash
+# generate-status-report.sh - 生成跨需求状态报告
+# 基于 spec-kit 原则，提供跨需求的开发状态总览
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+# 使用说明
+usage() {
+    cat << EOF
+用法: $0 [选项]
+
+生成跨需求状态报告，展示所有需求的开发进度和状态。
+
+选项:
+  -h, --help              显示此帮助信息
+  -o, --output FILE       输出报告到文件 (默认: 输出到标准输出)
+  -f, --format FORMAT     输出格式: text|markdown|json (默认: text)
+  -s, --status STATUS     过滤特定状态: initialized|prd|epic|dev|qa|release|all (默认: all)
+  -v, --verbose           详细模式，显示更多信息
+  --no-color              禁用颜色输出
+
+示例:
+  $0                                    # 生成所有需求的文本报告
+  $0 -o status.md -f markdown           # 生成Markdown格式报告
+  $0 -s dev                             # 只显示开发中的需求
+  $0 -f json -o status.json             # 生成JSON格式报告
+
+EOF
+    exit 0
+}
+
+# 解析命令行参数
+OUTPUT_FILE=""
+FORMAT="text"
+FILTER_STATUS="all"
+VERBOSE=false
+NO_COLOR=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            ;;
+        -o|--output)
+            OUTPUT_FILE="$2"
+            shift 2
+            ;;
+        -f|--format)
+            FORMAT="$2"
+            shift 2
+            ;;
+        -s|--status)
+            FILTER_STATUS="$2"
+            shift 2
+            ;;
+        -v|--verbose)
+            VERBOSE=true
+            shift
+            ;;
+        --no-color)
+            NO_COLOR=true
+            shift
+            ;;
+        *)
+            echo "错误: 未知参数 $1" >&2
+            usage
+            ;;
+    esac
+done
+
+# 如果禁用颜色，清空颜色变量
+if [[ "$NO_COLOR" == "true" || -n "$OUTPUT_FILE" ]]; then
+    RED=''
+    GREEN=''
+    YELLOW=''
+    BLUE=''
+    CYAN=''
+    BOLD=''
+    NC=''
+fi
+
+# 验证格式
+if [[ ! "$FORMAT" =~ ^(text|markdown|json)$ ]]; then
+    echo "错误: 无效的格式 '$FORMAT'，必须是 text, markdown 或 json" >&2
+    exit 1
+fi
+
+# 验证状态过滤器
+if [[ ! "$FILTER_STATUS" =~ ^(all|initialized|prd|epic|dev|qa|release)$ ]]; then
+    echo "错误: 无效的状态 '$FILTER_STATUS'" >&2
+    exit 1
+fi
+
+# 获取需求目录
+REPO_ROOT=$(get_repo_root)
+REQUIREMENTS_DIR="$REPO_ROOT/devflow/requirements"
+
+if [[ ! -d "$REQUIREMENTS_DIR" ]]; then
+    echo "错误: 需求目录不存在: $REQUIREMENTS_DIR" >&2
+    exit 1
+fi
+
+# 阶段显示名称映射
+get_phase_display_name() {
+    local phase="$1"
+    case "$phase" in
+        initialized) echo "初始化" ;;
+        planning) echo "规划中" ;;
+        prd_generation_in_progress) echo "PRD生成中" ;;
+        prd_complete) echo "PRD完成" ;;
+        epic_planning) echo "Epic规划" ;;
+        epic_complete) echo "Epic完成" ;;
+        development) echo "开发中" ;;
+        dev_complete) echo "开发完成" ;;
+        qa) echo "质量保证" ;;
+        qa_complete) echo "QA完成" ;;
+        release) echo "发布中" ;;
+        release_complete) echo "发布完成" ;;
+        completed) echo "已完成" ;;
+        *) echo "$phase" ;;
+    esac
+}
+
+# 阶段进度百分比
+get_phase_percentage() {
+    local phase="$1"
+    case "$phase" in
+        initialized|planning) echo "0" ;;
+        prd_generation_in_progress) echo "10" ;;
+        prd_complete|epic_planning) echo "20" ;;
+        epic_complete) echo "30" ;;
+        development) echo "40" ;;
+        dev_complete) echo "70" ;;
+        qa) echo "80" ;;
+        qa_complete) echo "90" ;;
+        release|release_complete) echo "95" ;;
+        completed) echo "100" ;;
+        *) echo "0" ;;
+    esac
+}
+
+# 收集所有需求信息
+collect_requirements() {
+    local requirements=()
+
+    for req_dir in "$REQUIREMENTS_DIR"/*; do
+        if [[ ! -d "$req_dir" ]]; then
+            continue
+        fi
+
+        local req_id=$(basename "$req_dir")
+        local status_file="$req_dir/orchestration_status.json"
+
+        if [[ ! -f "$status_file" ]]; then
+            continue
+        fi
+
+        # 读取状态文件
+        local status=$(jq -r '.status // "unknown"' "$status_file" 2>/dev/null || echo "unknown")
+        local phase=$(jq -r '.phase // "unknown"' "$status_file" 2>/dev/null || echo "unknown")
+        local title=$(jq -r '.title // ""' "$status_file" 2>/dev/null || echo "")
+        local updated_at=$(jq -r '.updatedAt // ""' "$status_file" 2>/dev/null || echo "")
+
+        # 状态过滤
+        if [[ "$FILTER_STATUS" != "all" ]]; then
+            # 简化状态匹配逻辑
+            local simplified_status="$phase"
+            case "$phase" in
+                initialized|planning) simplified_status="initialized" ;;
+                prd_*|epic_planning) simplified_status="prd" ;;
+                epic_complete) simplified_status="epic" ;;
+                development|dev_complete) simplified_status="dev" ;;
+                qa*) simplified_status="qa" ;;
+                release*|completed) simplified_status="release" ;;
+            esac
+
+            if [[ "$simplified_status" != "$FILTER_STATUS" ]]; then
+                continue
+            fi
+        fi
+
+        # 统计任务进度
+        local tasks_total=0
+        local tasks_completed=0
+        local tasks_file="$req_dir/TASKS.md"
+
+        if [[ -f "$tasks_file" ]]; then
+            # 统计任务总数 (以 ## TASK 开头的行)
+            tasks_total=$(grep -c "^## TASK" "$tasks_file" 2>/dev/null || echo "0")
+
+            # 统计已完成任务 (检查 .completed 标记文件)
+            local tasks_dir="$req_dir/tasks"
+            if [[ -d "$tasks_dir" ]]; then
+                tasks_completed=$(find "$tasks_dir" -name "*.completed" -type f 2>/dev/null | wc -l | tr -d ' ')
+            fi
+        fi
+
+        # 计算进度百分比
+        local progress_percent=$(get_phase_percentage "$phase")
+        if [[ $tasks_total -gt 0 ]]; then
+            # 开发阶段使用任务完成度计算更精确的百分比
+            if [[ "$phase" == "development" ]]; then
+                progress_percent=$((30 + (tasks_completed * 40 / tasks_total)))
+            fi
+        fi
+
+        # 添加到结果数组
+        requirements+=("$req_id|$title|$status|$phase|$updated_at|$tasks_completed|$tasks_total|$progress_percent")
+    done
+
+    printf '%s\n' "${requirements[@]}"
+}
+
+# 文本格式输出
+output_text() {
+    local requirements=("$@")
+    local total=${#requirements[@]}
+
+    echo -e "${BOLD}${CYAN}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${BOLD}${CYAN}          CC-DevFlow 需求开发状态报告${NC}"
+    echo -e "${BOLD}${CYAN}═══════════════════════════════════════════════════════════════${NC}"
+    echo ""
+    echo -e "生成时间: $(get_beijing_time_full)"
+    echo -e "需求总数: ${BOLD}$total${NC}"
+    echo ""
+
+    if [[ $total -eq 0 ]]; then
+        echo -e "${YELLOW}没有找到符合条件的需求${NC}"
+        return
+    fi
+
+    # 统计各阶段需求数量
+    local count_init=0 count_prd=0 count_epic=0 count_dev=0 count_qa=0 count_release=0
+
+    for req_data in "${requirements[@]}"; do
+        IFS='|' read -r req_id title status phase updated_at tasks_completed tasks_total progress_percent <<< "$req_data"
+
+        case "$phase" in
+            initialized|planning) ((count_init++)) ;;
+            prd_*|epic_planning) ((count_prd++)) ;;
+            epic_complete) ((count_epic++)) ;;
+            development|dev_complete) ((count_dev++)) ;;
+            qa*) ((count_qa++)) ;;
+            release*|completed) ((count_release++)) ;;
+        esac
+    done
+
+    echo -e "${BOLD}阶段分布:${NC}"
+    echo -e "  初始化阶段:   $count_init"
+    echo -e "  PRD阶段:      $count_prd"
+    echo -e "  Epic阶段:     $count_epic"
+    echo -e "  开发阶段:     $count_dev"
+    echo -e "  QA阶段:       $count_qa"
+    echo -e "  发布/完成:    $count_release"
+    echo ""
+    echo -e "${BOLD}${CYAN}───────────────────────────────────────────────────────────────${NC}"
+    echo ""
+
+    # 输出每个需求的详细信息
+    for req_data in "${requirements[@]}"; do
+        IFS='|' read -r req_id title status phase updated_at tasks_completed tasks_total progress_percent <<< "$req_data"
+
+        local phase_display=$(get_phase_display_name "$phase")
+        local progress_bar=$(generate_progress_bar "$progress_percent")
+
+        # 根据阶段选择颜色
+        local color="$CYAN"
+        case "$phase" in
+            initialized|planning) color="$YELLOW" ;;
+            *complete|completed) color="$GREEN" ;;
+            development|dev_*) color="$BLUE" ;;
+        esac
+
+        echo -e "${BOLD}${color}${req_id}${NC}: ${title:-无标题}"
+        echo -e "  阶段:     ${phase_display}"
+        echo -e "  进度:     $progress_bar ${progress_percent}%"
+
+        if [[ $tasks_total -gt 0 ]]; then
+            echo -e "  任务:     ${tasks_completed}/${tasks_total} 已完成"
+        fi
+
+        if [[ -n "$updated_at" ]]; then
+            echo -e "  更新时间: ${updated_at}"
+        fi
+
+        if [[ "$VERBOSE" == "true" ]]; then
+            echo -e "  状态:     ${status}"
+            local req_dir="$REQUIREMENTS_DIR/$req_id"
+
+            # 检查关键文件
+            local files_status=""
+            [[ -f "$req_dir/PRD.md" ]] && files_status+="PRD "
+            [[ -f "$req_dir/EPIC.md" ]] && files_status+="Epic "
+            [[ -f "$req_dir/TASKS.md" ]] && files_status+="Tasks "
+            [[ -f "$req_dir/TEST_REPORT.md" ]] && files_status+="TestReport "
+            [[ -f "$req_dir/SECURITY_REPORT.md" ]] && files_status+="SecurityReport "
+
+            if [[ -n "$files_status" ]]; then
+                echo -e "  文档:     ${files_status}"
+            fi
+        fi
+
+        echo ""
+    done
+
+    echo -e "${BOLD}${CYAN}═══════════════════════════════════════════════════════════════${NC}"
+}
+
+# Markdown格式输出
+output_markdown() {
+    local requirements=("$@")
+    local total=${#requirements[@]}
+
+    echo "# CC-DevFlow 需求开发状态报告"
+    echo ""
+    echo "**生成时间**: $(get_beijing_time_full)"
+    echo ""
+    echo "**需求总数**: $total"
+    echo ""
+
+    if [[ $total -eq 0 ]]; then
+        echo "> 没有找到符合条件的需求"
+        return
+    fi
+
+    # 统计各阶段需求数量
+    local count_init=0 count_prd=0 count_epic=0 count_dev=0 count_qa=0 count_release=0
+
+    for req_data in "${requirements[@]}"; do
+        IFS='|' read -r req_id title status phase updated_at tasks_completed tasks_total progress_percent <<< "$req_data"
+
+        case "$phase" in
+            initialized|planning) ((count_init++)) ;;
+            prd_*|epic_planning) ((count_prd++)) ;;
+            epic_complete) ((count_epic++)) ;;
+            development|dev_complete) ((count_dev++)) ;;
+            qa*) ((count_qa++)) ;;
+            release*|completed) ((count_release++)) ;;
+        esac
+    done
+
+    echo "## 阶段分布"
+    echo ""
+    echo "| 阶段 | 数量 |"
+    echo "|------|------|"
+    echo "| 初始化阶段 | $count_init |"
+    echo "| PRD阶段 | $count_prd |"
+    echo "| Epic阶段 | $count_epic |"
+    echo "| 开发阶段 | $count_dev |"
+    echo "| QA阶段 | $count_qa |"
+    echo "| 发布/完成 | $count_release |"
+    echo ""
+
+    echo "## 需求详情"
+    echo ""
+    echo "| 需求ID | 标题 | 阶段 | 进度 | 任务进度 | 最后更新 |"
+    echo "|--------|------|------|------|----------|----------|"
+
+    for req_data in "${requirements[@]}"; do
+        IFS='|' read -r req_id title status phase updated_at tasks_completed tasks_total progress_percent <<< "$req_data"
+
+        local phase_display=$(get_phase_display_name "$phase")
+        local tasks_display="-"
+
+        if [[ $tasks_total -gt 0 ]]; then
+            tasks_display="${tasks_completed}/${tasks_total}"
+        fi
+
+        local updated_display="${updated_at:-N/A}"
+
+        echo "| **$req_id** | ${title:-无标题} | $phase_display | ${progress_percent}% | $tasks_display | $updated_display |"
+    done
+
+    echo ""
+
+    if [[ "$VERBOSE" == "true" ]]; then
+        echo "## 详细信息"
+        echo ""
+
+        for req_data in "${requirements[@]}"; do
+            IFS='|' read -r req_id title status phase updated_at tasks_completed tasks_total progress_percent <<< "$req_data"
+
+            local phase_display=$(get_phase_display_name "$phase")
+
+            echo "### $req_id: ${title:-无标题}"
+            echo ""
+            echo "- **阶段**: $phase_display"
+            echo "- **进度**: ${progress_percent}%"
+
+            if [[ $tasks_total -gt 0 ]]; then
+                echo "- **任务**: ${tasks_completed}/${tasks_total} 已完成"
+            fi
+
+            echo "- **最后更新**: ${updated_at:-N/A}"
+            echo "- **状态**: $status"
+
+            local req_dir="$REQUIREMENTS_DIR/$req_id"
+            echo "- **文档**:"
+            [[ -f "$req_dir/PRD.md" ]] && echo "  - ✅ PRD.md"
+            [[ -f "$req_dir/EPIC.md" ]] && echo "  - ✅ EPIC.md"
+            [[ -f "$req_dir/TASKS.md" ]] && echo "  - ✅ TASKS.md"
+            [[ -f "$req_dir/TEST_REPORT.md" ]] && echo "  - ✅ TEST_REPORT.md"
+            [[ -f "$req_dir/SECURITY_REPORT.md" ]] && echo "  - ✅ SECURITY_REPORT.md"
+
+            echo ""
+        done
+    fi
+}
+
+# JSON格式输出
+output_json() {
+    local requirements=("$@")
+
+    echo "{"
+    echo "  \"generated_at\": \"$(get_beijing_time_iso)\","
+    echo "  \"total_requirements\": ${#requirements[@]},"
+    echo "  \"requirements\": ["
+
+    local first=true
+    for req_data in "${requirements[@]}"; do
+        IFS='|' read -r req_id title status phase updated_at tasks_completed tasks_total progress_percent <<< "$req_data"
+
+        if [[ "$first" == "true" ]]; then
+            first=false
+        else
+            echo ","
+        fi
+
+        echo "    {"
+        echo "      \"id\": \"$req_id\","
+        echo "      \"title\": \"${title:-}\","
+        echo "      \"status\": \"$status\","
+        echo "      \"phase\": \"$phase\","
+        echo "      \"phase_display\": \"$(get_phase_display_name "$phase")\","
+        echo "      \"progress_percent\": $progress_percent,"
+        echo "      \"tasks\": {"
+        echo "        \"total\": $tasks_total,"
+        echo "        \"completed\": $tasks_completed"
+        echo "      },"
+        echo "      \"updated_at\": \"${updated_at:-}\""
+
+        if [[ "$VERBOSE" == "true" ]]; then
+            local req_dir="$REQUIREMENTS_DIR/$req_id"
+            echo "      ,"
+            echo "      \"documents\": {"
+            echo "        \"prd\": $([ -f "$req_dir/PRD.md" ] && echo "true" || echo "false"),"
+            echo "        \"epic\": $([ -f "$req_dir/EPIC.md" ] && echo "true" || echo "false"),"
+            echo "        \"tasks\": $([ -f "$req_dir/TASKS.md" ] && echo "true" || echo "false"),"
+            echo "        \"test_report\": $([ -f "$req_dir/TEST_REPORT.md" ] && echo "true" || echo "false"),"
+            echo "        \"security_report\": $([ -f "$req_dir/SECURITY_REPORT.md" ] && echo "true" || echo "false")"
+            echo "      }"
+        fi
+
+        echo -n "    }"
+    done
+
+    echo ""
+    echo "  ]"
+    echo "}"
+}
+
+# 生成进度条
+generate_progress_bar() {
+    local percent=$1
+    local bar_length=20
+    local filled=$((percent * bar_length / 100))
+    local empty=$((bar_length - filled))
+
+    local bar="["
+    for ((i=0; i<filled; i++)); do bar+="█"; done
+    for ((i=0; i<empty; i++)); do bar+="░"; done
+    bar+="]"
+
+    echo "$bar"
+}
+
+# 主逻辑
+main() {
+    # 收集需求信息
+    local requirements_data=$(collect_requirements)
+
+    if [[ -z "$requirements_data" ]]; then
+        requirements_data=()
+    else
+        mapfile -t requirements_data <<< "$requirements_data"
+    fi
+
+    # 根据格式输出
+    local output=""
+    case "$FORMAT" in
+        text)
+            output=$(output_text "${requirements_data[@]}")
+            ;;
+        markdown)
+            output=$(output_markdown "${requirements_data[@]}")
+            ;;
+        json)
+            output=$(output_json "${requirements_data[@]}")
+            ;;
+    esac
+
+    # 输出到文件或标准输出
+    if [[ -n "$OUTPUT_FILE" ]]; then
+        echo "$output" > "$OUTPUT_FILE"
+        echo -e "${GREEN}报告已生成: $OUTPUT_FILE${NC}" >&2
+    else
+        echo "$output"
+    fi
+}
+
+main