aigroup-workflow 1.3.0 → 2.0.1

package/scripts/harness/lint-workflow-artifacts.sh

@@ -1,150 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Harness 传感器：工作流产物验证
-# 检查 .dev-agents/shared/ 下的产物是否符合模板规范
-#
-# 输出格式对 Agent 友好：
-#   [PASS] 通过的检查
-#   [FAIL] 失败的检查 + [FIX] 修复指令
-# ================================================================
-
-ERRORS=0
-WARNINGS=0
-
-pass() { echo -e "  [PASS] $1"; }
-fail() {
-    echo -e "  [FAIL] $1"
-    ERRORS=$((ERRORS + 1))
-    bash "$(dirname "${BASH_SOURCE[0]}")/log-event.sh" lint_fail --actor harness --payload "lint=workflow-artifacts" 2>/dev/null || true
-}
-warn() { echo -e "  [WARN] $1"; WARNINGS=$((WARNINGS + 1)); }
-fix()  { echo -e "        [FIX] $1"; }
-
-echo "======================================"
-echo "  Harness 传感器：工作流产物检查"
-echo "======================================"
-echo ""
-
-SHARED_DIR=".dev-agents/shared"
-
-# ── 1. 实现计划检查 ──
-echo "▸ 实现计划检查 ($SHARED_DIR/tasks/)"
-
-if [ -d "$SHARED_DIR/tasks" ]; then
-    TASK_COUNT=$(find "$SHARED_DIR/tasks" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-    if [ "$TASK_COUNT" -gt 0 ]; then
-        pass "发现 $TASK_COUNT 个实现计划"
-        for plan in "$SHARED_DIR/tasks/"*.md; do
-            [ -f "$plan" ] || continue
-            filename=$(basename "$plan")
-
-            if grep -q "META" "$plan" 2>/dev/null || grep -q "## " "$plan" 2>/dev/null; then
-                pass "$filename 有结构化标题"
-            else
-                warn "$filename 缺少结构化标题"
-                fix "参考 docs/templates/implementation-plan.md 模板重构 $plan"
-            fi
-
-            if grep -q -iE "(验收|acceptance|完成标准|done)" "$plan" 2>/dev/null; then
-                pass "$filename 包含验收条件"
-            else
-                warn "$filename 缺少验收条件"
-                fix "在 $plan 中添加验收条件（Acceptance Criteria），明确何时算完成"
-            fi
-        done
-    else
-        pass "tasks/ 为空（无活跃任务）"
-    fi
-else
-    warn "$SHARED_DIR/tasks/ 目录不存在"
-    fix "运行: mkdir -p $SHARED_DIR/tasks"
-fi
-
-# ── 2. 设计方案检查 ──
-echo ""
-echo "▸ 设计方案检查 ($SHARED_DIR/designs/)"
-
-if [ -d "$SHARED_DIR/designs" ]; then
-    DESIGN_COUNT=$(find "$SHARED_DIR/designs" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-    if [ "$DESIGN_COUNT" -gt 0 ]; then
-        pass "发现 $DESIGN_COUNT 个设计方案"
-        for design in "$SHARED_DIR/designs/"*.md; do
-            [ -f "$design" ] || continue
-            filename=$(basename "$design")
-
-            if grep -q -iE "(方案|选型|对比|决策|architecture)" "$design" 2>/dev/null; then
-                pass "$filename 包含方案决策内容"
-            else
-                warn "$filename 可能缺少方案决策"
-                fix "设计文档应包含方案选择理由和对比分析"
-            fi
-        done
-    else
-        pass "designs/ 为空（无活跃设计）"
-    fi
-else
-    warn "$SHARED_DIR/designs/ 目录不存在"
-    fix "运行: mkdir -p $SHARED_DIR/designs"
-fi
-
-# ── 3. 审查报告检查 ──
-echo ""
-echo "▸ 审查报告检查 ($SHARED_DIR/reviews/)"
-
-if [ -d "$SHARED_DIR/reviews" ]; then
-    REVIEW_COUNT=$(find "$SHARED_DIR/reviews" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-    if [ "$REVIEW_COUNT" -gt 0 ]; then
-        pass "发现 $REVIEW_COUNT 个审查报告"
-        for review in "$SHARED_DIR/reviews/"*.md; do
-            [ -f "$review" ] || continue
-            filename=$(basename "$review")
-
-            HAS_STAGE1=$(grep -c -iE "(stage.?1|规格符合|spec)" "$review" 2>/dev/null)
-            HAS_STAGE2=$(grep -c -iE "(stage.?2|代码质量|quality)" "$review" 2>/dev/null)
-
-            if [ "$HAS_STAGE1" -gt 0 ] && [ "$HAS_STAGE2" -gt 0 ]; then
-                pass "$filename 包含两阶段审查"
-            elif [ "$HAS_STAGE1" -gt 0 ]; then
-                warn "$filename 只有 Stage 1，缺少 Stage 2"
-                fix "补充 Stage 2 代码质量审查，参考 docs/templates/code-review.md"
-            else
-                warn "$filename 审查结构不完整"
-                fix "参考 docs/templates/code-review.md 重构审查报告"
-            fi
-        done
-    else
-        pass "reviews/ 为空（无活跃审查）"
-    fi
-else
-    warn "$SHARED_DIR/reviews/ 目录不存在"
-    fix "运行: mkdir -p $SHARED_DIR/reviews"
-fi
-
-# ── 4. 模板完整性 ──
-echo ""
-echo "▸ 模板完整性检查"
-
-TEMPLATES_DIR="docs/templates"
-REQUIRED_TEMPLATES=("prd.md" "implementation-plan.md" "code-review.md")
-for tmpl in "${REQUIRED_TEMPLATES[@]}"; do
-    if [ -f "$TEMPLATES_DIR/$tmpl" ]; then
-        pass "模板 $tmpl 存在"
-    else
-        fail "模板 $tmpl 缺失"
-        fix "创建 $TEMPLATES_DIR/$tmpl"
-    fi
-done
-
-# ── 结果汇总 ──
-echo ""
-echo "======================================"
-if [ $ERRORS -eq 0 ] && [ $WARNINGS -eq 0 ]; then
-    echo "  ✅ 全部通过"
-elif [ $ERRORS -eq 0 ]; then
-    echo "  ⚠️  通过（$WARNINGS 个警告）"
-else
-    echo "  ❌ 失败：$ERRORS 个错误，$WARNINGS 个警告"
-fi
-echo "======================================"
-
-exit $ERRORS

package/scripts/harness/run-all.sh

@@ -1,77 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Harness 传感器：主运行器
-# 依次运行所有传感器脚本，汇总结果
-#
-# 用法: bash scripts/harness/run-all.sh
-#
-# Agent 集成说明：
-#   开发完成后运行此脚本进行自检。
-#   如果有 [FAIL]，根据 [FIX] 指令修正后重新运行，直至全部通过。
-# ================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TOTAL_ERRORS=0
-TOTAL_WARNINGS=0
-SENSORS_RUN=0
-SENSORS_FAILED=0
-
-echo "╔════════════════════════════════════════╗"
-echo "║    aiGroup Harness 传感器 - 全量检查    ║"
-echo "╚════════════════════════════════════════╝"
-echo ""
-
-run_sensor() {
-    local name=$1
-    local script=$2
-
-    if [ ! -f "$script" ]; then
-        echo "  [SKIP] $name — 脚本不存在: $script"
-        return
-    fi
-
-    SENSORS_RUN=$((SENSORS_RUN + 1))
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo "  运行: $name"
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo ""
-
-    bash "$script"
-    local exit_code=$?
-
-    if [ $exit_code -ne 0 ]; then
-        SENSORS_FAILED=$((SENSORS_FAILED + 1))
-        TOTAL_ERRORS=$((TOTAL_ERRORS + exit_code))
-    fi
-
-    echo ""
-}
-
-run_sensor "结构检查" "$SCRIPT_DIR/lint-structure.sh"
-run_sensor "文档检查" "$SCRIPT_DIR/lint-docs.sh"
-run_sensor "工作流产物检查" "$SCRIPT_DIR/lint-workflow-artifacts.sh"
-run_sensor "流程合规检查" "$SCRIPT_DIR/lint-process.sh"
-run_sensor "派遣契约检查" "$SCRIPT_DIR/lint-delegation.sh"
-
-echo "╔════════════════════════════════════════╗"
-echo "║            总体检查结果                ║"
-echo "╠════════════════════════════════════════╣"
-echo "║  运行传感器: $SENSORS_RUN"
-echo "║  失败传感器: $SENSORS_FAILED"
-echo "║  累计错误数: $TOTAL_ERRORS"
-
-if [ $TOTAL_ERRORS -eq 0 ]; then
-    echo "║  状态: ✅ 全部通过"
-else
-    echo "║  状态: ❌ 存在问题需修复"
-    echo "║"
-    echo "║  Agent 操作指引："
-    echo "║  1. 查看上方 [FAIL] 标记的检查项"
-    echo "║  2. 按 [FIX] 指令逐一修复"
-    echo "║  3. 重新运行: bash scripts/harness/run-all.sh"
-    echo "║  4. 重复直至全部通过"
-fi
-
-echo "╚════════════════════════════════════════╝"
-
-exit $TOTAL_ERRORS

package/scripts/harness/workflow-state.sh

@@ -1,397 +0,0 @@
-#!/bin/bash
-# ================================================================
-# 工作流状态机 — Harness 行为强制执行的核心
-#
-# 通过状态文件追踪当前工作流阶段，强制管道顺序：
-#   idle → brainstorming → validation → design → planning
-#        → development → testing → documentation → finishing → idle
-#
-# 阶段对照：
-#   brainstorming  = 需求收集（收集和分析功能需求）
-#   validation     = 需求验证（验证需求的完整性和可行性）
-#   design         = 方案设计（设计技术方案和架构）
-#   planning       = 任务拆解（将需求拆解为可执行任务）
-#   development    = 实施开发（按照任务进行开发）
-#   testing        = 测试验证（编写和执行测试用例）
-#   documentation  = 文档更新（更新相关文档）
-#   finishing      = 分支收尾（集成/PR/归档）
-#
-# 用法：
-#   workflow-state.sh status          # 查看当前状态
-#   workflow-state.sh init <名称>     # 开始新工作流（进入 brainstorming）
-#   workflow-state.sh advance         # 推进到下一阶段
-#   workflow-state.sh gate <阶段>     # 门控检查：当前是否可以执行该阶段
-#   workflow-state.sh reset           # 重置状态（完成或放弃）
-#   workflow-state.sh exempt <原因>   # 标记为简单任务豁免
-#
-# 状态文件：.dev-agents/shared/.workflow-state
-# ================================================================
-
-STATE_FILE=".dev-agents/shared/.workflow-state"
-STATE_DIR="$(dirname "$STATE_FILE")"
-
-# 管道阶段定义（有序，8 阶段 + idle）
-STAGES=("idle" "brainstorming" "validation" "design" "planning" "development" "testing" "documentation" "finishing")
-
-# 阶段中文名映射
-stage_label() {
-    case "$1" in
-        idle)            echo "空闲" ;;
-        brainstorming)   echo "需求收集" ;;
-        validation)      echo "需求验证" ;;
-        design)          echo "方案设计" ;;
-        planning)        echo "任务拆解" ;;
-        development)     echo "实施开发" ;;
-        testing)         echo "测试验证" ;;
-        documentation)   echo "文档更新" ;;
-        finishing)       echo "分支收尾" ;;
-        *)               echo "$1" ;;
-    esac
-}
-
-# ── 工具函数 ──
-
-ensure_state_dir() {
-    mkdir -p "$STATE_DIR" 2>/dev/null
-}
-
-get_field() {
-    local field="$1"
-    if [ -f "$STATE_FILE" ]; then
-        grep "^${field}=" "$STATE_FILE" 2>/dev/null | cut -d'=' -f2-
-    fi
-}
-
-get_stage() {
-    local stage
-    stage=$(get_field "stage")
-    echo "${stage:-idle}"
-}
-
-write_state() {
-    local stage="$1"
-    local task="$2"
-    local started="$3"
-    local exempt="${4:-false}"
-    ensure_state_dir
-    cat > "$STATE_FILE" << EOF
-stage=$stage
-task=$task
-started=$started
-exempt=$exempt
-updated=$(date '+%Y-%m-%d %H:%M:%S')
-EOF
-}
-
-# 计算自上次 updated 以来的毫秒数（用于 stage_exit duration）
-compute_stage_duration_ms() {
-    local last_updated
-    last_updated=$(get_field "updated")
-    if [ -z "$last_updated" ]; then
-        echo "0"
-        return
-    fi
-    local last_ts
-    last_ts=$(date -d "$last_updated" +%s 2>/dev/null || echo "0")
-    local now_ts
-    now_ts=$(date +%s)
-    if [ "$last_ts" -eq 0 ]; then
-        echo "0"
-    else
-        echo $(( (now_ts - last_ts) * 1000 ))
-    fi
-}
-
-# 调用 log-event.sh（失败不报错）
-log_event() {
-    local script_dir
-    script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    bash "$script_dir/log-event.sh" "$@" 2>/dev/null || true
-}
-
-stage_index() {
-    local target="$1"
-    for i in "${!STAGES[@]}"; do
-        if [ "${STAGES[$i]}" = "$target" ]; then
-            echo "$i"
-            return
-        fi
-    done
-    echo "-1"
-}
-
-next_stage() {
-    local current="$1"
-    local idx
-    idx=$(stage_index "$current")
-    local next_idx=$((idx + 1))
-    if [ "$next_idx" -lt "${#STAGES[@]}" ]; then
-        echo "${STAGES[$next_idx]}"
-    else
-        echo "idle"
-    fi
-}
-
-# ── 命令实现 ──
-
-cmd_status() {
-    local stage
-    stage=$(get_stage)
-    local task
-    task=$(get_field "task")
-    local started
-    started=$(get_field "started")
-    local exempt
-    exempt=$(get_field "exempt")
-
-    if [ "$stage" = "idle" ]; then
-        echo "[STATE] 当前无活跃工作流"
-        echo "[INFO] 使用 'workflow-state.sh init <任务名>' 开始新工作流"
-    else
-        echo "[STATE] 阶段: $stage（$(stage_label "$stage")）"
-        echo "[STATE] 任务: ${task:-未命名}"
-        echo "[STATE] 开始时间: ${started:-未知}"
-        [ "$exempt" = "true" ] && echo "[STATE] 标记: 简单任务豁免"
-    fi
-}
-
-cmd_init() {
-    local task_name="$1"
-    local current_stage
-    current_stage=$(get_stage)
-
-    if [ "$current_stage" != "idle" ]; then
-        echo "[FAIL] 已有活跃工作流（阶段: $current_stage，任务: $(get_field 'task')）" >&2
-        echo "[FIX] 先完成或重置当前工作流: workflow-state.sh reset" >&2
-        return 1
-    fi
-
-    if [ -z "$task_name" ]; then
-        echo "[FAIL] 必须提供任务名称: workflow-state.sh init <任务名>" >&2
-        return 1
-    fi
-
-    write_state "brainstorming" "$task_name" "$(date '+%Y-%m-%d %H:%M:%S')"
-    log_event workflow_start --stage brainstorming --payload "task_name=$task_name"
-    log_event stage_enter --stage brainstorming
-    echo "[OK] 工作流已启动: $task_name"
-    echo "[STATE] 当前阶段: brainstorming（需求收集）"
-    echo "[NEXT] 收集和分析功能需求，记录到 .dev-agents/shared/designs/ 后运行 advance"
-    echo "[REMIND] 若本工作流涉及架构决策，完成后请更新 .dev-agents/shared/memory/activeContext.md"
-}
-
-cmd_advance() {
-    local current_stage
-    current_stage=$(get_stage)
-    local task
-    task=$(get_field "task")
-
-    if [ "$current_stage" = "idle" ]; then
-        echo "[FAIL] 无活跃工作流，无法推进" >&2
-        echo "[FIX] 使用 workflow-state.sh init <任务名> 开始新工作流" >&2
-        return 1
-    fi
-
-    # 阶段推进前的产物检查
-    case "$current_stage" in
-        brainstorming)
-            # 需求收集阶段：必须有需求文档
-            local design_count
-            design_count=$(find .dev-agents/shared/designs/ -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-            if [ "$design_count" -eq 0 ]; then
-                echo "[FAIL] 需求收集阶段完成前必须产出需求文档" >&2
-                echo "[FIX] 将需求分析保存到 .dev-agents/shared/designs/ 后再推进" >&2
-                return 1
-            fi
-            ;;
-        validation)
-            # 需求验证阶段：需求文档中应有验证标记
-            local design_count
-            design_count=$(find .dev-agents/shared/designs/ -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-            if [ "$design_count" -eq 0 ]; then
-                echo "[FAIL] 需求验证阶段但无需求文档" >&2
-                echo "[FIX] 需求文档应在 brainstorming 阶段产出" >&2
-                return 1
-            fi
-            ;;
-        design)
-            # 方案设计阶段：设计文档中应有方案决策
-            local has_design=0
-            for f in .dev-agents/shared/designs/*.md; do
-                [ -f "$f" ] || continue
-                if grep -q -iE "(方案|架构|技术栈|architecture|approach)" "$f" 2>/dev/null; then
-                    has_design=1
-                    break
-                fi
-            done
-            if [ "$has_design" -eq 0 ]; then
-                echo "[FAIL] 方案设计阶段完成前必须有技术方案" >&2
-                echo "[FIX] 在设计文档中补充方案选择、架构决策和技术栈" >&2
-                return 1
-            fi
-            ;;
-        planning)
-            # 任务拆解阶段：必须有实现计划
-            local task_count
-            task_count=$(find .dev-agents/shared/tasks/ -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-            if [ "$task_count" -eq 0 ]; then
-                echo "[FAIL] 任务拆解阶段完成前必须产出实现计划" >&2
-                echo "[FIX] 将实现计划保存到 .dev-agents/shared/tasks/ 后再推进" >&2
-                return 1
-            fi
-            ;;
-        development)
-            # 实施开发阶段：检查是否有代码变更
-            ;;
-        testing)
-            # 测试验证阶段：必须有审查/测试报告
-            local review_count
-            review_count=$(find .dev-agents/shared/reviews/ -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-            if [ "$review_count" -eq 0 ]; then
-                echo "[FAIL] 测试验证阶段完成前必须有测试/审查报告" >&2
-                echo "[FIX] 派遣 Kyle 完成测试验证和代码审查，报告保存到 .dev-agents/shared/reviews/" >&2
-                return 1
-            fi
-            ;;
-        documentation)
-            # 文档更新阶段：不做强制检查，由 Agent 自行判断
-            ;;
-        finishing)
-            # 分支收尾：无额外检查
-            ;;
-    esac
-
-    local next
-    next=$(next_stage "$current_stage")
-
-    local stage_duration_ms
-    stage_duration_ms=$(compute_stage_duration_ms)
-    log_event stage_exit --stage "$current_stage" --duration-ms "$stage_duration_ms" --payload "next_stage=$next"
-
-    if [ "$next" = "idle" ]; then
-        write_state "idle" "" "" "false"
-        log_event workflow_complete --stage idle --payload "prev_stage=$current_stage"
-        echo "[OK] 工作流已完成: $task"
-        echo "[STATE] 状态已重置为 idle"
-    else
-        write_state "$next" "$task" "$(get_field 'started')"
-        log_event stage_enter --stage "$next" --payload "prev_stage=$current_stage"
-        echo "[OK] 阶段推进: $current_stage（$(stage_label "$current_stage")） → $next（$(stage_label "$next")）"
-        echo "[STATE] 当前阶段: $next（$(stage_label "$next")）"
-
-        case "$next" in
-            validation)
-                echo "[NEXT] 验证需求的完整性和可行性，确认无歧义后 advance" ;;
-            design)
-                echo "[NEXT] 设计技术方案和架构，产出方案决策文档后 advance" ;;
-            planning)
-                echo "[NEXT] 将需求拆解为可执行任务，保存到 .dev-agents/shared/tasks/"
-                echo "[REMIND] 方案设计已完成，请更新 .dev-agents/shared/memory/projectContext.md 记录架构决策" ;;
-            development)
-                echo "[NEXT] 派遣 Jarvis 子代理按任务执行开发" ;;
-            testing)
-                echo "[NEXT] 派遣 Kyle 编写和执行测试用例，进行两阶段审查" ;;
-            documentation)
-                echo "[NEXT] 更新相关文档（API 文档、README、ARCHITECTURE 等）"
-                echo "[REMIND] Kyle 已通过审查，若发现值得沉淀的代码模式，请更新 .dev-agents/shared/memory/systemPatterns.md" ;;
-            finishing)
-                echo "[NEXT] 执行分支收尾流程（集成/PR/归档）" ;;
-        esac
-        echo "[REMIND] 阶段已推进，请同步更新 .dev-agents/shared/memory/activeContext.md 反映当前状态"
-    fi
-}
-
-cmd_gate() {
-    local required_stage="$1"
-    local current_stage
-    current_stage=$(get_stage)
-    local exempt
-    exempt=$(get_field "exempt")
-
-    # 简单任务豁免
-    if [ "$exempt" = "true" ]; then
-        echo "[GATE] 简单任务豁免，跳过门控检查"
-        return 0
-    fi
-
-    # idle 状态下不允许任何操作
-    if [ "$current_stage" = "idle" ] && [ "$required_stage" != "idle" ]; then
-        echo "[GATE-FAIL] 当前无活跃工作流，不能执行 $required_stage（$(stage_label "$required_stage")）" >&2
-        echo "[FIX] 先运行 workflow-state.sh init <任务名> 启动工作流" >&2
-        return 1
-    fi
-
-    # 检查当前阶段是否匹配要求
-    if [ "$current_stage" = "$required_stage" ]; then
-        echo "[GATE] 门控通过: 当前阶段 $current_stage（$(stage_label "$current_stage")）允许执行"
-        return 0
-    fi
-
-    # 阶段不匹配
-    local current_idx
-    current_idx=$(stage_index "$current_stage")
-    local required_idx
-    required_idx=$(stage_index "$required_stage")
-
-    if [ "$required_idx" -gt "$current_idx" ]; then
-        echo "[GATE-FAIL] 当前阶段 $current_stage（$(stage_label "$current_stage")），不能跳到 $required_stage（$(stage_label "$required_stage")）" >&2
-        echo "[FIX] 必须先完成当前阶段，逐步推进到 $required_stage" >&2
-    else
-        echo "[GATE-FAIL] 当前阶段 $current_stage（$(stage_label "$current_stage")），已超过 $required_stage（$(stage_label "$required_stage")）" >&2
-    fi
-    return 1
-}
-
-cmd_reset() {
-    local current_stage
-    current_stage=$(get_stage)
-    local task
-    task=$(get_field "task")
-
-    if [ "$current_stage" = "idle" ]; then
-        echo "[INFO] 当前已是 idle 状态，无需重置"
-        return 0
-    fi
-
-    log_event workflow_reset --stage "$current_stage" --payload "prev_task=${task:-unnamed}"
-    write_state "idle" "" "" "false"
-    echo "[OK] 工作流已重置（原任务: ${task:-未命名}，原阶段: $current_stage）"
-}
-
-cmd_exempt() {
-    local reason="$1"
-
-    if [ -z "$reason" ]; then
-        echo "[FAIL] 必须提供豁免原因: workflow-state.sh exempt <原因>" >&2
-        return 1
-    fi
-
-    write_state "idle" "exempt: $reason" "$(date '+%Y-%m-%d %H:%M:%S')" "true"
-    log_event workflow_exempt --stage idle --payload "reason=$reason"
-    echo "[OK] 已标记为简单任务豁免: $reason"
-    echo "[INFO] 豁免任务完成后请运行 workflow-state.sh reset 恢复正常模式"
-}
-
-# ── 入口 ──
-
-case "${1:-status}" in
-    status)   cmd_status ;;
-    init)     cmd_init "$2" ;;
-    advance)  cmd_advance ;;
-    gate)     cmd_gate "$2" ;;
-    reset)    cmd_reset ;;
-    exempt)   cmd_exempt "$2" ;;
-    *)
-        echo "用法: workflow-state.sh {status|init|advance|gate|reset|exempt}" >&2
-        echo ""
-        echo "  status          查看当前工作流状态"
-        echo "  init <名称>     启动新工作流（进入 brainstorming/需求收集）"
-        echo "  advance         推进到下一阶段（含产物检查）"
-        echo "  gate <阶段>     门控检查：当前是否允许该操作"
-        echo "  reset           重置工作流状态"
-        echo "  exempt <原因>   标记简单任务豁免"
-        echo ""
-        echo "  阶段: brainstorming → validation → design → planning → development → testing → documentation → finishing"
-        exit 1
-        ;;
-esac