aigroup-workflow 1.3.0 → 2.0.0

package/scripts/harness/lint-docs.sh

@@ -1,121 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Harness 传感器：文档新鲜度与一致性检查
-# 检测文档是否过期、交叉引用是否有效、内容是否一致
-#
-# 输出格式对 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=docs" 2>/dev/null || true
-}
-warn() { echo -e "  [WARN] $1"; WARNINGS=$((WARNINGS + 1)); }
-fix()  { echo -e "        [FIX] $1"; }
-
-echo "======================================"
-echo "  Harness 传感器：文档检查"
-echo "======================================"
-echo ""
-
-# ── 1. CLAUDE.md 行数检查（应保持精简） ──
-echo "▸ CLAUDE.md 精简度检查"
-
-if [ -f "CLAUDE.md" ]; then
-    LINE_COUNT=$(wc -l < "CLAUDE.md" | tr -d ' ')
-    if [ "$LINE_COUNT" -le 100 ]; then
-        pass "CLAUDE.md 保持精简（${LINE_COUNT} 行 ≤ 100）"
-    else
-        warn "CLAUDE.md 过长（${LINE_COUNT} 行 > 100）"
-        fix "CLAUDE.md 应作为目录/地图，详细内容移至 docs/ 目录。参考 Harness Engineering 的渐进式披露原则"
-    fi
-else
-    fail "CLAUDE.md 不存在"
-    fix "创建 CLAUDE.md 作为 Agent 入口文件"
-fi
-
-# ── 2. 交叉引用有效性 ──
-echo ""
-echo "▸ CLAUDE.md 交叉引用检查"
-
-if [ -f "CLAUDE.md" ]; then
-    while IFS= read -r ref; do
-        [ -z "$ref" ] && continue
-        if [ -f "$ref" ] || [ -d "$ref" ]; then
-            pass "引用有效: $ref"
-        else
-            fail "引用无效: $ref"
-            fix "文件 $ref 不存在，请创建或更新 CLAUDE.md 中的引用路径"
-        fi
-    done < <(grep -oE '`(docs/[^`]+|skills/[^`]+|\.dev-agents/[^`]+|scripts/[^`]+)`' CLAUDE.md | tr -d '`' | sort -u)
-fi
-
-# ── 3. 知识库索引一致性 ──
-echo ""
-echo "▸ 知识库索引一致性"
-
-if [ -f "docs/README.md" ]; then
-    while IFS= read -r ref; do
-        [ -z "$ref" ] && continue
-        if [ -f "docs/$ref" ]; then
-            pass "索引引用有效: docs/$ref"
-        else
-            fail "索引引用无效: docs/$ref"
-            fix "docs/README.md 引用了不存在的 docs/$ref，请创建该文档或删除引用"
-        fi
-    done < <(grep -oE '\[.*\]\(([^)]+\.md)\)' docs/README.md | grep -oE '\([^)]+\)' | tr -d '()' | grep -v '^http')
-fi
-
-# ── 4. 文档非空检查 ──
-echo ""
-echo "▸ 文档非空检查"
-
-for doc in docs/*.md; do
-    if [ -f "$doc" ]; then
-        size=$(wc -c < "$doc" | tr -d ' ')
-        if [ "$size" -gt 50 ]; then
-            pass "$doc 有内容（${size} bytes）"
-        else
-            warn "$doc 内容过少（${size} bytes）"
-            fix "$doc 可能是空壳文档，请补充实质内容"
-        fi
-    fi
-done
-
-# ── 5. QUALITY_SCORE.md 更新检查 ──
-echo ""
-echo "▸ 质量评分更新检查"
-
-if [ -f "docs/QUALITY_SCORE.md" ]; then
-    LAST_UPDATE=$(grep -oE '最后更新：[0-9]{4}-[0-9]{2}-[0-9]{2}' docs/QUALITY_SCORE.md | head -1 | grep -oE '[0-9]{4}-[0-9]{2}-[0-9]{2}')
-    if [ -n "$LAST_UPDATE" ]; then
-        DAYS_AGO=$(( ($(date +%s) - $(date -d "$LAST_UPDATE" +%s 2>/dev/null || echo 0)) / 86400 ))
-        if [ "$DAYS_AGO" -le 30 ] 2>/dev/null; then
-            pass "质量评分最近更新于 $LAST_UPDATE"
-        else
-            warn "质量评分上次更新于 $LAST_UPDATE（超过 30 天）"
-            fix "运行熵管理流程，更新 docs/QUALITY_SCORE.md 中的评分"
-        fi
-    fi
-fi
-
-# ── 结果汇总 ──
-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/lint-process.sh

@@ -1,221 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Harness 传感器：工作流过程合规检查
-#
-# 与 lint-structure.sh（检查文件存在）不同，本传感器检查的是
-# 工作流是否被正确遵守：
-#   - 有代码变更时，是否有对应的设计文档和实现计划
-#   - 有实现计划时，是否有对应的设计文档
-#   - 有审查报告时，是否覆盖了两阶段
-#   - 工作流状态机是否一致
-#
-# 核心原则：从"文件存在"检查升级为"过程合规"检查
-# ================================================================
-
-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=process" 2>/dev/null || true
-}
-warn() { echo -e "  [WARN] $1"; WARNINGS=$((WARNINGS + 1)); }
-fix()  { echo -e "        [FIX] $1"; }
-
-SHARED_DIR=".dev-agents/shared"
-STATE_FILE="$SHARED_DIR/.workflow-state"
-
-echo "======================================"
-echo "  Harness 传感器：流程合规检查"
-echo "======================================"
-echo ""
-
-# ── 1. 工作流状态一致性 ──
-echo "▸ 工作流状态一致性"
-
-if [ -f "$STATE_FILE" ]; then
-    CURRENT_STAGE=$(grep "^stage=" "$STATE_FILE" | cut -d'=' -f2-)
-    IS_EXEMPT=$(grep "^exempt=" "$STATE_FILE" | cut -d'=' -f2-)
-
-    if [ "$IS_EXEMPT" = "true" ]; then
-        pass "简单任务豁免模式（跳过流程检查）"
-    elif [ -n "$CURRENT_STAGE" ] && [ "$CURRENT_STAGE" != "idle" ]; then
-        pass "工作流活跃（阶段: $CURRENT_STAGE）"
-
-        # 检查阶段与产物是否匹配
-        case "$CURRENT_STAGE" in
-            validation|design|planning|development|testing|documentation|finishing)
-                DESIGN_COUNT=$(find "$SHARED_DIR/designs/" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-                if [ "$DESIGN_COUNT" -eq 0 ]; then
-                    fail "当前阶段 $CURRENT_STAGE，但缺少需求/设计文档"
-                    fix "工作流不应跳过 brainstorming 阶段。在 $SHARED_DIR/designs/ 中补充文档"
-                else
-                    pass "设计文档存在（$DESIGN_COUNT 个），符合阶段 $CURRENT_STAGE 的前置要求"
-                fi
-                ;;
-        esac
-
-        case "$CURRENT_STAGE" in
-            development|testing|documentation|finishing)
-                TASK_COUNT=$(find "$SHARED_DIR/tasks/" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-                if [ "$TASK_COUNT" -eq 0 ]; then
-                    fail "当前阶段 $CURRENT_STAGE，但缺少实现计划"
-                    fix "工作流不应跳过 planning 阶段。在 $SHARED_DIR/tasks/ 中补充实现计划"
-                else
-                    pass "实现计划存在（$TASK_COUNT 个），符合阶段 $CURRENT_STAGE 的前置要求"
-                fi
-                ;;
-        esac
-
-        case "$CURRENT_STAGE" in
-            documentation|finishing)
-                REVIEW_COUNT=$(find "$SHARED_DIR/reviews/" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-                if [ "$REVIEW_COUNT" -eq 0 ]; then
-                    fail "当前阶段 $CURRENT_STAGE，但缺少审查报告"
-                    fix "不应跳过 testing 阶段。派遣 Kyle 完成测试验证和两阶段审查"
-                else
-                    pass "审查报告存在（$REVIEW_COUNT 个），符合 finishing 的前置要求"
-                fi
-                ;;
-        esac
-    else
-        pass "工作流空闲（idle）"
-    fi
-else
-    pass "无工作流状态文件（首次使用或已重置）"
-fi
-
-# ── 2. 产物因果链完整性 ──
-echo ""
-echo "▸ 产物因果链检查"
-
-DESIGN_COUNT=$(find "$SHARED_DIR/designs/" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-TASK_COUNT=$(find "$SHARED_DIR/tasks/" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-REVIEW_COUNT=$(find "$SHARED_DIR/reviews/" -name "*.md" -type f 2>/dev/null | wc -l | tr -d ' ')
-
-# 有实现计划但没有设计文档 = 跳过了 brainstorming
-if [ "$TASK_COUNT" -gt 0 ] && [ "$DESIGN_COUNT" -eq 0 ]; then
-    fail "存在实现计划但无设计文档 → 可能跳过了 brainstorming"
-    fix "补充设计文档到 $SHARED_DIR/designs/，或确认是否为简单任务豁免"
-elif [ "$TASK_COUNT" -gt 0 ] && [ "$DESIGN_COUNT" -gt 0 ]; then
-    pass "实现计划有对应的设计文档（因果链完整）"
-elif [ "$TASK_COUNT" -eq 0 ] && [ "$DESIGN_COUNT" -eq 0 ]; then
-    pass "无活跃产物（因果链不适用）"
-elif [ "$DESIGN_COUNT" -gt 0 ] && [ "$TASK_COUNT" -eq 0 ]; then
-    pass "有设计文档，尚无实现计划（正常的 brainstorming → planning 过渡）"
-fi
-
-# 有审查报告但没有实现计划 = 跳过了 planning
-if [ "$REVIEW_COUNT" -gt 0 ] && [ "$TASK_COUNT" -eq 0 ]; then
-    warn "存在审查报告但无实现计划 → 审查没有对照规格"
-    fix "审查应基于实现计划中的规格进行，确认是否有计划遗漏"
-elif [ "$REVIEW_COUNT" -gt 0 ] && [ "$TASK_COUNT" -gt 0 ]; then
-    pass "审查报告有对应的实现计划（可对照规格）"
-fi
-
-# ── 3. 实现计划内容质量 ──
-echo ""
-echo "▸ 实现计划内容质量"
-
-if [ "$TASK_COUNT" -gt 0 ]; then
-    for plan in "$SHARED_DIR/tasks/"*.md; do
-        [ -f "$plan" ] || continue
-        filename=$(basename "$plan")
-
-        # 检查验收条件
-        if grep -q -iE "(验收|acceptance|完成标准|done.?criteria)" "$plan" 2>/dev/null; then
-            pass "$filename 包含验收条件"
-        else
-            fail "$filename 缺少验收条件"
-            fix "实现计划必须包含明确的验收条件，定义何时算完成"
-        fi
-
-        # 检查文件变更列表
-        if grep -q -iE "(文件|file|变更|change|修改|modify)" "$plan" 2>/dev/null; then
-            pass "$filename 包含变更范围描述"
-        else
-            warn "$filename 缺少变更范围描述"
-            fix "实现计划应列出需要变更的文件清单"
-        fi
-    done
-else
-    pass "无实现计划（跳过内容质量检查）"
-fi
-
-# ── 4. 审查报告完整性 ──
-echo ""
-echo "▸ 审查报告两阶段完整性"
-
-if [ "$REVIEW_COUNT" -gt 0 ]; then
-    for review in "$SHARED_DIR/reviews/"*.md; do
-        [ -f "$review" ] || continue
-        filename=$(basename "$review")
-
-        HAS_STAGE1=$(grep -c -iE "(stage.?1|阶段.?1|规格符合|spec.?compliance)" "$review" 2>/dev/null)
-        HAS_STAGE2=$(grep -c -iE "(stage.?2|阶段.?2|代码质量|code.?quality)" "$review" 2>/dev/null)
-        HAS_VERDICT=$(grep -c -iE "(通过|不通过|pass|fail|approved|rejected)" "$review" 2>/dev/null)
-
-        if [ "$HAS_STAGE1" -gt 0 ] && [ "$HAS_STAGE2" -gt 0 ]; then
-            pass "$filename 包含完整两阶段审查"
-        elif [ "$HAS_STAGE1" -gt 0 ] && [ "$HAS_STAGE2" -eq 0 ]; then
-            fail "$filename 只有 Stage 1，缺少 Stage 2（代码质量审查）"
-            fix "必须完成两阶段审查：Stage 1 通过后，派遣 Kyle 执行 Stage 2"
-        elif [ "$HAS_STAGE1" -eq 0 ] && [ "$HAS_STAGE2" -gt 0 ]; then
-            fail "$filename 只有 Stage 2，缺少 Stage 1（规格符合性审查）"
-            fix "Stage 2 不能在 Stage 1 之前执行。先派遣 Kyle 执行 Stage 1"
-        else
-            fail "$filename 审查结构不完整（缺少阶段标识）"
-            fix "审查报告必须包含 Stage 1（规格符合性）和 Stage 2（代码质量）"
-        fi
-
-        if [ "$HAS_VERDICT" -eq 0 ]; then
-            warn "$filename 缺少明确的审查结论"
-            fix "审查报告必须包含明确结论（通过/不通过）"
-        fi
-    done
-else
-    pass "无审查报告（跳过完整性检查）"
-fi
-
-# ── 5. 设计文档内容质量 ──
-echo ""
-echo "▸ 设计文档内容质量"
-
-if [ "$DESIGN_COUNT" -gt 0 ]; then
-    for design in "$SHARED_DIR/designs/"*.md; do
-        [ -f "$design" ] || continue
-        filename=$(basename "$design")
-
-        # 检查方案选择
-        if grep -q -iE "(方案|选型|option|approach|alternative|trade.?off)" "$design" 2>/dev/null; then
-            pass "$filename 包含方案分析"
-        else
-            warn "$filename 缺少方案对比分析"
-            fix "设计文档应包含 2-3 种方案及取舍分析"
-        fi
-
-        # 检查是否有 TODO/待定
-        if grep -q -iE "(TODO|待定|TBD|之后再说|暂不确定)" "$design" 2>/dev/null; then
-            warn "$filename 包含未确定项（TODO/待定）"
-            fix "设计文档不应有未确定项，请现在确定或标记为明确的开放问题"
-        fi
-    done
-else
-    pass "无设计文档（跳过内容质量检查）"
-fi
-
-# ── 结果汇总 ──
-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/lint-structure.sh

@@ -1,145 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Harness 传感器：项目结构验证
-# 检查项目目录结构、必要文件是否存在且符合规范
-#
-# 输出格式对 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=structure" 2>/dev/null || true
-}
-warn() { echo -e "  [WARN] $1"; WARNINGS=$((WARNINGS + 1)); }
-fix()  { echo -e "        [FIX] $1"; }
-
-echo "======================================"
-echo "  Harness 传感器：结构检查"
-echo "======================================"
-echo ""
-
-# ── 1. 核心文件存在性 ──
-echo "▸ 核心文件检查"
-
-for f in "CLAUDE.md" "docs/README.md" "docs/ARCHITECTURE.md"; do
-    if [ -f "$f" ]; then
-        pass "$f 存在"
-    else
-        fail "$f 缺失"
-        fix "创建 $f，参考 docs/README.md 中的知识库索引"
-    fi
-done
-
-# ── 2. 原生子代理定义 ──
-echo ""
-echo "▸ 原生子代理定义检查"
-
-for agent in ella jarvis kyle; do
-    agent_file=".claude/agents/$agent.md"
-    if [ -f "$agent_file" ]; then
-        pass "$agent_file 存在"
-    else
-        fail "$agent_file 缺失"
-        fix "创建 $agent_file，包含 YAML frontmatter（name/description/tools）和角色定义"
-    fi
-done
-
-# ── 3. 协作产物目录 ──
-echo ""
-echo "▸ 协作产物目录检查"
-
-for dir in ".dev-agents/shared/tasks" ".dev-agents/shared/designs" ".dev-agents/shared/reviews" ".dev-agents/shared/memory" ".dev-agents/shared/logs" "docs/templates"; do
-    if [ -d "$dir" ]; then
-        pass "$dir/ 存在"
-    else
-        warn "$dir/ 不存在"
-        fix "运行: mkdir -p $dir"
-    fi
-done
-
-# ── 4. 工作流技能完整性 ──
-echo ""
-echo "▸ 工作流技能检查"
-
-WORKFLOW_DIR="skills/max/workflow"
-REQUIRED_SKILLS=(
-    "brainstorming"
-    "requirement-validation"
-    "solution-design"
-    "writing-plans"
-    "subagent-driven-development"
-    "testing"
-    "documentation"
-    "systematic-debugging"
-    "verification-before-completion"
-    "finishing-a-development-branch"
-    "entropy-management"
-)
-
-for skill in "${REQUIRED_SKILLS[@]}"; do
-    skill_file="$WORKFLOW_DIR/$skill/SKILL.md"
-    if [ -f "$skill_file" ]; then
-        pass "$skill 技能存在"
-    else
-        fail "$skill 技能缺失"
-        fix "创建 $skill_file，参考其他 SKILL.md 的格式"
-    fi
-done
-
-# ── 5. docs/ 知识库完整性 ──
-echo ""
-echo "▸ 知识库文档检查"
-
-REQUIRED_DOCS=(
-    "docs/ARCHITECTURE.md"
-    "docs/workflow-pipeline.md"
-    "docs/dispatch-rules.md"
-    "docs/coding-standards.md"
-    "docs/red-flags.md"
-    "docs/QUALITY_SCORE.md"
-    "docs/tech-debt-tracker.md"
-    "docs/steering-loop.md"
-)
-
-for doc in "${REQUIRED_DOCS[@]}"; do
-    if [ -f "$doc" ]; then
-        pass "$doc 存在"
-    else
-        fail "$doc 缺失"
-        fix "创建 $doc，参考 docs/README.md 中的文档地图"
-    fi
-done
-
-# ── 6. Harness 脚本自身完整性 ──
-echo ""
-echo "▸ Harness 传感器套件检查"
-
-for script in "scripts/harness/lint-structure.sh" "scripts/harness/lint-docs.sh" "scripts/harness/lint-workflow-artifacts.sh" "scripts/harness/lint-process.sh" "scripts/harness/workflow-state.sh" "scripts/harness/run-all.sh"; do
-    if [ -f "$script" ]; then
-        pass "$script 存在"
-    else
-        warn "$script 缺失"
-        fix "创建 $script 以完善传感器覆盖"
-    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/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