aigroup-workflow 1.3.0 → 2.0.1

package/scripts/harness/lint-delegation.sh

@@ -1,168 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Harness 传感器：派遣契约检查（delegation-check）
-#
-# 目的：防止 dispatch prompt、文档、skill 重复定义 .claude/agents/*.md
-#       里已经声明的内容（角色身份、门控、技能加载、旧路径）。
-#
-# 参考：Claude-Code-Workflow 项目的 delegation-check skill
-#
-# 检查维度：
-#   A. 角色再定义  — "读取 <persona>.md 了解你的角色" 类指令
-#   B. 角色扮演    — "你是<角色中文名>" 出现在非规范位置
-#   C. 旧路径残留  — 遗留的 .dev-agents/<role>/ 路径引用
-#   D. 旧命令残留  — 遗留的 .claude/commands/{ella,jarvis,kyle}*.md 引用
-#   E. frontmatter — .claude/agents/*.md 缺失必需字段
-# ================================================================
-
-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=delegation" 2>/dev/null || true
-}
-warn() { echo -e "  [WARN] $1"; WARNINGS=$((WARNINGS + 1)); }
-fix()  { echo -e "        [FIX] $1"; }
-
-echo "======================================"
-echo "  Harness 传感器：派遣契约检查"
-echo "======================================"
-echo ""
-
-# ─────────────────────────────────────────
-# 扫描目标：CLAUDE.md + docs/ + skills/
-# 排除目标：.claude/agents/（规范定义自身）
-#          docs/templates/（模板允许示例）
-#          .git/、node_modules/、.idea/
-# ─────────────────────────────────────────
-SCAN_INCLUDE=("CLAUDE.md" "docs" "skills")
-
-scan_files() {
-    local pattern="$1"
-    grep -rnE "$pattern" "${SCAN_INCLUDE[@]}" 2>/dev/null \
-        | grep -v "^\.git/" \
-        | grep -v "node_modules/" \
-        | grep -v "\.idea/" \
-        | grep -v "docs/templates/" \
-        || true
-}
-
-# ── A. 角色再定义检查 ──
-echo "▸ A. 角色再定义检查"
-echo "   （原生子代理已自动加载身份，无需在 prompt 里指示读取）"
-
-# 匹配：读取 .claude/agents/xxx.md 了解你的角色
-# 匹配：先读取 .dev-agents/xxx/PERSONA.md
-role_redef=$(scan_files '(读取|加载|load|read).*\.(claude/agents/(ella|jarvis|kyle)\.md|dev-agents/(ella|jarvis|kyle)/PERSONA\.md).*(你的角色|角色|persona|role)')
-
-if [ -z "$role_redef" ]; then
-    pass "未发现角色再定义的 dispatch prompt 片段"
-else
-    while IFS= read -r line; do
-        fail "角色再定义: $line"
-    done <<< "$role_redef"
-    fix "改用 Agent({subagent_type: \"<role>\", ...})，子代理身份由 frontmatter 自动加载"
-fi
-
-# ── B. 角色扮演检查 ──
-echo ""
-echo "▸ B. 角色扮演（role-switching）检查"
-echo "   （禁止在当前对话中'变成' Ella/Jarvis/Kyle，必须用 Agent 工具派遣）"
-
-# "你是艾拉/贾维斯/凯尔" 在非 .claude/agents/ 位置
-role_switch=$(scan_files '你是.{0,3}(艾拉|贾维斯|凯尔)')
-
-if [ -z "$role_switch" ]; then
-    pass "未发现角色扮演指令"
-else
-    found_switch=0
-    while IFS= read -r line; do
-        # 过滤：文档里解释"角色切换 vs Agent 派遣"的反例引用是合法的
-        if echo "$line" | grep -qE '(禁止|错误|反例|不要|✗|❌|假装)'; then
-            continue
-        fi
-        fail "疑似角色扮演: $line"
-        found_switch=1
-    done <<< "$role_switch"
-    if [ $found_switch -eq 1 ]; then
-        fix "删除'你是<角色>'指令，改用 Agent({subagent_type: \"<role>\"})"
-    else
-        pass "仅命中文档里的反例引用（合法）"
-    fi
-fi
-
-# ── C. 旧路径残留检查 ──
-echo ""
-echo "▸ C. 旧 .dev-agents/<role>/ 路径残留检查"
-
-legacy_path=$(scan_files '\.dev-agents/(ella|jarvis|kyle)/')
-
-if [ -z "$legacy_path" ]; then
-    pass "无旧路径残留"
-else
-    while IFS= read -r line; do
-        fail "旧路径: $line"
-    done <<< "$legacy_path"
-    fix "替换为 .claude/agents/<role>.md，或删除整段引用"
-fi
-
-# ── D. 旧命令残留检查 ──
-echo ""
-echo "▸ D. 旧 /ella /jarvis /kyle 命令残留检查"
-
-legacy_cmd=$(scan_files '\.claude/commands/(ella|jarvis|kyle)(-[a-z]+)?\.md|/(ella|jarvis|kyle)(-[a-z]+)?(\s|$|`)')
-
-if [ -z "$legacy_cmd" ]; then
-    pass "无旧命令路径残留"
-else
-    while IFS= read -r line; do
-        fail "旧命令引用: $line"
-    done <<< "$legacy_cmd"
-    fix "角色派遣改用 Agent({subagent_type: \"<role>\"})；只保留 .claude/commands/{init-project,git-commit}.md"
-fi
-
-# ── E. Agent frontmatter 完整性检查 ──
-echo ""
-echo "▸ E. 子代理 frontmatter 完整性检查"
-
-for agent in ella jarvis kyle; do
-    file=".claude/agents/$agent.md"
-    if [ ! -f "$file" ]; then
-        fail "$file 不存在"
-        fix "创建 $file 并填入 YAML frontmatter（name/description/tools）"
-        continue
-    fi
-
-    # 检查前 20 行内是否有 name/description/tools 三个字段
-    header=$(head -20 "$file")
-    missing=""
-    for field in "name:" "description:" "tools:"; do
-        if ! echo "$header" | grep -q "^$field"; then
-            missing="$missing $field"
-        fi
-    done
-
-    if [ -z "$missing" ]; then
-        pass "$file frontmatter 完整"
-    else
-        fail "$file frontmatter 缺失:$missing"
-        fix "在 $file 顶部的 YAML frontmatter 中补齐上述字段"
-    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-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