aigroup-workflow 1.3.0 → 2.0.0

package/scripts/check-gitignore.sh

@@ -1,130 +0,0 @@
-#!/bin/bash
-# ================================================================
-# aiGroup 项目 - .gitignore 规则检查脚本
-# 版本: v1.0
-# 创建日期: 2026-02-12
-# 维护人: 麦克斯 (Max)
-# ================================================================
-
-set -e
-
-PROJECT_ROOT="/Users/yuhao/Desktop/yezannnnn/aiGroup"
-
-cd "$PROJECT_ROOT"
-
-echo "================================================================"
-echo "  aiGroup 项目 .gitignore 规则检查"
-echo "================================================================"
-echo ""
-
-# 颜色定义
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-GREEN='\033[0;32m'
-NC='\033[0m' # No Color
-
-# 检查计数
-TOTAL_CHECKS=0
-PASSED_CHECKS=0
-WARNINGS=0
-ERRORS=0
-
-# 检查函数
-check_files() {
-    local pattern=$1
-    local description=$2
-    local severity=$3  # ERROR or WARNING
-
-    TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
-
-    echo "检查: $description"
-
-    result=$(git ls-files | grep -E "$pattern" || true)
-
-    if [ -z "$result" ]; then
-        echo -e "${GREEN}✅ 通过${NC} - 未发现问题"
-        PASSED_CHECKS=$((PASSED_CHECKS + 1))
-    else
-        if [ "$severity" == "ERROR" ]; then
-            echo -e "${RED}🔴 错误${NC} - 发现不应追踪的文件:"
-            ERRORS=$((ERRORS + 1))
-        else
-            echo -e "${YELLOW}⚠️  警告${NC} - 发现以下文件:"
-            WARNINGS=$((WARNINGS + 1))
-        fi
-        echo "$result" | sed 's/^/    /'
-    fi
-    echo ""
-}
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  第 1 部分: 系统文件检查"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-check_files "\.(DS_Store)$" "macOS 系统文件 (.DS_Store)" "ERROR"
-check_files "\.(Thumbs\.db|desktop\.ini)$" "Windows 系统文件" "ERROR"
-check_files "^\.directory$" "Linux 系统文件" "ERROR"
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  第 2 部分: 临时和日志文件检查"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-check_files "\.(log|tmp|swp|swo)$" "日志和临时文件" "ERROR"
-check_files "\.(bak|backup|old)$" "备份文件" "WARNING"
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  第 3 部分: 设计源文件检查"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-check_files "\.(psd|ai|fig|sketch|xd)$" "大型设计源文件" "ERROR"
-check_files "shared/designs/.*\.(png|jpg|jpeg)$" "设计目录导出图片（预览图除外）" "WARNING"
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  第 4 部分: 缓存和依赖检查"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-check_files "__pycache__|\.pyc$|\.pyo$" "Python 缓存文件" "ERROR"
-check_files "node_modules/|\.cache/" "Node.js 依赖和缓存" "ERROR"
-check_files "\.(egg-info|pytest_cache)/" "Python 包管理和测试缓存" "ERROR"
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  第 5 部分: 敏感信息检查"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-check_files "\.(env|key|pem)$|secrets/" "敏感配置和密钥文件" "ERROR"
-check_files "settings\.local\.json$" "本地配置文件" "ERROR"
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  第 6 部分: 编辑器配置检查"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-check_files "\.vscode/|\.idea/|\.cursor/" "编辑器配置目录" "WARNING"
-
-echo "================================================================"
-echo "  检查结果汇总"
-echo "================================================================"
-echo ""
-echo "总检查项:   $TOTAL_CHECKS"
-echo -e "${GREEN}通过:       $PASSED_CHECKS${NC}"
-echo -e "${YELLOW}警告:       $WARNINGS${NC}"
-echo -e "${RED}错误:       $ERRORS${NC}"
-echo ""
-
-if [ $ERRORS -gt 0 ]; then
-    echo -e "${RED}❌ 检查失败 - 发现 $ERRORS 个错误${NC}"
-    echo "建议: 使用 'git rm --cached <file>' 移除不应追踪的文件"
-    exit 1
-elif [ $WARNINGS -gt 0 ]; then
-    echo -e "${YELLOW}⚠️  检查通过（有警告） - 发现 $WARNINGS 个警告${NC}"
-    echo "建议: 检查警告文件是否应该保留在版本控制中"
-    exit 0
-else
-    echo -e "${GREEN}✅ 检查完全通过 - .gitignore 规则正常工作${NC}"
-    exit 0
-fi

package/scripts/clean-system-files.sh

@@ -1,169 +0,0 @@
-#!/bin/bash
-# ================================================================
-# aiGroup 项目 - 系统文件清理脚本
-# 版本: v1.0
-# 创建日期: 2026-02-12
-# 维护人: 麦克斯 (Max)
-# ================================================================
-
-set -e
-
-PROJECT_ROOT="/Users/yuhao/Desktop/yezannnnn/aiGroup"
-
-cd "$PROJECT_ROOT"
-
-echo "================================================================"
-echo "  aiGroup 项目系统文件清理工具"
-echo "================================================================"
-echo ""
-
-# 颜色定义
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# 统计
-total_files=0
-deleted_files=0
-
-echo -e "${BLUE}查找项目中的系统文件...${NC}"
-echo ""
-
-# 查找 .DS_Store 文件
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  macOS 系统文件 (.DS_Store)"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-ds_store_files=$(find . -name ".DS_Store" -type f | grep -v ".git/" || true)
-
-if [ -z "$ds_store_files" ]; then
-    echo -e "${GREEN}✅ 未发现 .DS_Store 文件${NC}"
-else
-    echo "发现以下 .DS_Store 文件:"
-    echo "$ds_store_files"
-    count=$(echo "$ds_store_files" | wc -l | tr -d ' ')
-    total_files=$((total_files + count))
-fi
-echo ""
-
-# 查找 Thumbs.db 文件
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  Windows 系统文件 (Thumbs.db, desktop.ini)"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-windows_files=$(find . \( -name "Thumbs.db" -o -name "desktop.ini" \) -type f | grep -v ".git/" || true)
-
-if [ -z "$windows_files" ]; then
-    echo -e "${GREEN}✅ 未发现 Windows 系统文件${NC}"
-else
-    echo "发现以下 Windows 系统文件:"
-    echo "$windows_files"
-    count=$(echo "$windows_files" | wc -l | tr -d ' ')
-    total_files=$((total_files + count))
-fi
-echo ""
-
-# 查找 Vim/Emacs 临时文件
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  编辑器临时文件 (.swp, *~)"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-temp_files=$(find . \( -name "*.swp" -o -name "*.swo" -o -name "*~" \) -type f | grep -v ".git/" || true)
-
-if [ -z "$temp_files" ]; then
-    echo -e "${GREEN}✅ 未发现编辑器临时文件${NC}"
-else
-    echo "发现以下临时文件:"
-    echo "$temp_files"
-    count=$(echo "$temp_files" | wc -l | tr -d ' ')
-    total_files=$((total_files + count))
-fi
-echo ""
-
-# 汇总
-echo "================================================================"
-echo "  清理汇总"
-echo "================================================================"
-echo ""
-
-if [ $total_files -eq 0 ]; then
-    echo -e "${GREEN}✅ 项目非常干净，未发现需要清理的系统文件${NC}"
-    echo ""
-    exit 0
-fi
-
-echo -e "${YELLOW}发现 $total_files 个系统文件需要清理${NC}"
-echo ""
-
-# 询问是否删除
-read -p "$(echo -e ${YELLOW}是否删除这些文件？[y/N]:${NC} )" -n 1 -r
-echo ""
-
-if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-    echo -e "${BLUE}已取消操作${NC}"
-    exit 0
-fi
-
-echo ""
-echo -e "${BLUE}开始清理...${NC}"
-echo ""
-
-# 删除 .DS_Store
-if [ -n "$ds_store_files" ]; then
-    echo "$ds_store_files" | while read file; do
-        if [ -f "$file" ]; then
-            rm "$file"
-            echo "  删除: $file"
-            deleted_files=$((deleted_files + 1))
-        fi
-    done
-fi
-
-# 删除 Windows 文件
-if [ -n "$windows_files" ]; then
-    echo "$windows_files" | while read file; do
-        if [ -f "$file" ]; then
-            rm "$file"
-            echo "  删除: $file"
-            deleted_files=$((deleted_files + 1))
-        fi
-    done
-fi
-
-# 删除临时文件
-if [ -n "$temp_files" ]; then
-    echo "$temp_files" | while read file; do
-        if [ -f "$file" ]; then
-            rm "$file"
-            echo "  删除: $file"
-            deleted_files=$((deleted_files + 1))
-        fi
-    done
-fi
-
-echo ""
-echo "================================================================"
-echo -e "${GREEN}✅ 清理完成${NC}"
-echo "================================================================"
-echo ""
-echo "已删除 $total_files 个文件"
-echo ""
-
-# 验证
-remaining=$(find . \( -name ".DS_Store" -o -name "Thumbs.db" -o -name "*.swp" \) -type f | grep -v ".git/" || true)
-
-if [ -z "$remaining" ]; then
-    echo -e "${GREEN}验证通过: 所有系统文件已清理${NC}"
-else
-    echo -e "${YELLOW}警告: 仍有部分文件未清理${NC}"
-    echo "$remaining"
-fi
-
-echo ""
-echo "建议: 运行 'git status' 检查 Git 状态"
-echo ""

package/scripts/harness/hook-post-edit.sh

@@ -1,40 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Hook: PostToolUse — Write|Edit（文件修改后自动触发）
-#
-# 触发方式：
-#   Claude Code CLI → hooks.json 自动触发（强制）
-#   Cursor → 不会自动触发（需在 CLAUDE.md 中指令引导）
-#
-# 策略：静默成功，仅在失败时输出 + exit 2
-#   exit 0 = 静默通过，stdout 显示在 transcript
-#   exit 2 = 错误回注到 Agent 上下文，Agent 必须修复
-# ================================================================
-
-ERRORS=""
-
-# 检查 CLAUDE.md 行数是否膨胀
-if [ -f "CLAUDE.md" ]; then
-    LINE_COUNT=$(wc -l < "CLAUDE.md" | tr -d ' ')
-    if [ "$LINE_COUNT" -gt 100 ]; then
-        ERRORS="${ERRORS}[FAIL] CLAUDE.md 超过 100 行（当前 ${LINE_COUNT} 行）\n"
-        ERRORS="${ERRORS}[FIX] CLAUDE.md 应保持为目录式入口，详细内容移至 docs/ 目录\n\n"
-    fi
-fi
-
-# 检查 docs/ 下是否有空壳文档
-for doc in docs/*.md; do
-    if [ -f "$doc" ]; then
-        SIZE=$(wc -c < "$doc" 2>/dev/null | tr -d ' ')
-        if [ -n "$SIZE" ] && [ "$SIZE" -lt 50 ]; then
-            ERRORS="${ERRORS}[FAIL] $doc 内容过少（${SIZE} bytes）\n"
-            ERRORS="${ERRORS}[FIX] 文档不应为空壳，请补充实质内容\n\n"
-        fi
-    fi
-done
-
-# 静默成功，失败时 exit 2 回注上下文
-if [ -n "$ERRORS" ]; then
-    echo -e "$ERRORS" >&2
-    exit 2
-fi

package/scripts/harness/hook-stop.sh

@@ -1,70 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Hook: Stop（Agent 准备停止时自动触发）
-#
-# 触发方式：
-#   Claude Code CLI → hooks.json 自动触发（强制）
-#   Cursor → 不会自动触发（需在 CLAUDE.md 中指令引导）
-#
-# 策略：静默成功，失败时 exit 2 阻止 Agent 停止
-#   exit 0 = 允许停止
-#   exit 2 = 阻止停止，错误信息回注让 Agent 继续修复
-#
-# 检查范围：
-#   1. 结构检查（lint-structure.sh）
-#   2. 文档检查（lint-docs.sh）
-#   3. 工作流产物检查（lint-workflow-artifacts.sh）
-#   4. 流程合规检查（lint-process.sh）— 新增
-# ================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ERRORS=""
-
-collect_failures() {
-    local output="$1"
-    local exit_code=$2
-    local section_name="$3"
-
-    if [ $exit_code -ne 0 ]; then
-        local fail_lines
-        fail_lines=$(echo "$output" | grep -E "\[FAIL\]|\[FIX\]")
-        if [ -n "$fail_lines" ]; then
-            ERRORS="${ERRORS}--- ${section_name} ---\n${fail_lines}\n\n"
-        fi
-    fi
-}
-
-# 运行各传感器（静默模式，只收集失败项）
-STRUCT_OUTPUT=$(bash "$SCRIPT_DIR/lint-structure.sh" 2>&1)
-collect_failures "$STRUCT_OUTPUT" $? "结构检查"
-
-DOCS_OUTPUT=$(bash "$SCRIPT_DIR/lint-docs.sh" 2>&1)
-collect_failures "$DOCS_OUTPUT" $? "文档检查"
-
-ARTIFACT_OUTPUT=$(bash "$SCRIPT_DIR/lint-workflow-artifacts.sh" 2>&1)
-collect_failures "$ARTIFACT_OUTPUT" $? "工作流产物检查"
-
-PROCESS_OUTPUT=$(bash "$SCRIPT_DIR/lint-process.sh" 2>&1)
-collect_failures "$PROCESS_OUTPUT" $? "流程合规检查"
-
-# 检查工作流状态：如果有活跃工作流且未完成，警告
-if [ -f ".dev-agents/shared/.workflow-state" ]; then
-    CURRENT_STAGE=$(grep "^stage=" ".dev-agents/shared/.workflow-state" | cut -d'=' -f2-)
-    EXEMPT=$(grep "^exempt=" ".dev-agents/shared/.workflow-state" | cut -d'=' -f2-)
-    TASK_NAME=$(grep "^task=" ".dev-agents/shared/.workflow-state" | cut -d'=' -f2-)
-
-    if [ "$CURRENT_STAGE" != "idle" ] && [ "$EXEMPT" != "true" ]; then
-        ERRORS="${ERRORS}--- 工作流状态检查 ---\n"
-        ERRORS="${ERRORS}[FAIL] 工作流未完成就停止（阶段: $CURRENT_STAGE，任务: $TASK_NAME）\n"
-        ERRORS="${ERRORS}[FIX] 完成当前工作流阶段后再停止，或运行 bash scripts/harness/workflow-state.sh reset 重置\n\n"
-    fi
-fi
-
-# 静默成功，失败时 exit 2 阻止停止
-if [ -n "$ERRORS" ]; then
-    echo "Harness 传感器检测到问题，请修复后再停止：" >&2
-    echo "" >&2
-    echo -e "$ERRORS" >&2
-    echo "修复上述 [FAIL] 项后重试。" >&2
-    exit 2
-fi

package/scripts/harness/hook-subagent-stop.sh

@@ -1,54 +0,0 @@
-#!/bin/bash
-# ================================================================
-# Hook: SubagentStop（子代理完成后自动触发）
-#
-# 检查子代理是否：
-#   1. 将产出写入正确的 shared/ 位置
-#   2. 产出内容符合模板要求
-#
-# 策略：
-#   exit 0 = 允许停止（有 warning 也不阻止）
-#   exit 2 = 阻止停止，要求修复
-# ================================================================
-
-SHARED_DIR=".dev-agents/shared"
-ERRORS=""
-WARNINGS=""
-
-# 检查 shared/ 子目录是否存在
-for dir in "$SHARED_DIR/tasks" "$SHARED_DIR/designs" "$SHARED_DIR/reviews"; do
-    if [ ! -d "$dir" ]; then
-        WARNINGS="${WARNINGS}[WARN] $dir/ 目录不存在\n"
-        WARNINGS="${WARNINGS}[FIX] 运行: mkdir -p $dir\n"
-    fi
-done
-
-# 检查最近 5 分钟内是否有新的审查报告，如果有，验证两阶段完整性
-if [ -d "$SHARED_DIR/reviews" ]; then
-    for review in "$SHARED_DIR/reviews/"*.md; do
-        [ -f "$review" ] || continue
-
-        # 检查是否是近期修改的文件（5 分钟内）
-        if [ "$(find "$review" -mmin -5 2>/dev/null)" ]; then
-            filename=$(basename "$review")
-            HAS_STAGE1=$(grep -c -iE "(stage.?1|阶段.?1|规格符合)" "$review" 2>/dev/null)
-            HAS_STAGE2=$(grep -c -iE "(stage.?2|阶段.?2|代码质量)" "$review" 2>/dev/null)
-
-            if [ "$HAS_STAGE1" -eq 0 ] && [ "$HAS_STAGE2" -eq 0 ]; then
-                ERRORS="${ERRORS}[FAIL] 审查报告 $filename 缺少阶段标识（Stage 1/Stage 2）\n"
-                ERRORS="${ERRORS}[FIX] 审查报告必须包含 'Stage 1：规格符合性审查' 和 'Stage 2：代码质量审查'\n"
-            fi
-        fi
-    done
-fi
-
-# 输出警告（不阻止）
-if [ -n "$WARNINGS" ]; then
-    echo -e "$WARNINGS"
-fi
-
-# 错误则阻止
-if [ -n "$ERRORS" ]; then
-    echo -e "$ERRORS" >&2
-    exit 2
-fi

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