aigroup-workflow 1.3.0 → 2.0.0

package/manifests/install-modules.json

@@ -0,0 +1,294 @@
+{
+  "version": 3,
+  "description": "aiGroup 安装清单：agent / skill / commands 模块分组。skill 物理扁平在 skills/<name>/，自动加载；agent 源池在 agents/<name>.md，由 aigroup init 按需选装到 .claude/agents/。模块分类供跨平台插件消费。",
+  "modules": [
+    {
+      "id": "workflow",
+      "kind": "skills",
+      "description": "跨阶段工作流 skill — 需求工程、规划、调试、文档、验证、收尾。",
+      "paths": [
+        "skills/requirement-engineering",
+        "skills/writing-plans",
+        "skills/subagent-driven-development",
+        "skills/systematic-debugging",
+        "skills/documentation",
+        "skills/verification-before-completion",
+        "skills/finishing-a-development-branch",
+        "skills/entropy-management"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": true,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "product",
+      "kind": "skills",
+      "description": "产品管理辅助 skill — PRD、用户研究、竞品、干系人沟通。",
+      "paths": [
+        "skills/competitive-analysis",
+        "skills/meeting-notes",
+        "skills/prd-template",
+        "skills/stakeholder-update",
+        "skills/user-research-synthesis"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": false,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "design",
+      "kind": "skills",
+      "description": "UI/UX 和前端实现 skill — 设计规范、组件、框架专项。",
+      "paths": [
+        "skills/ui-ux-pro-max",
+        "skills/senior-frontend",
+        "skills/react-expert",
+        "skills/vue-expert",
+        "skills/vue-expert-js",
+        "skills/angular-architect",
+        "skills/nextjs-developer",
+        "skills/flutter-expert",
+        "skills/react-native-expert",
+        "skills/design-commands"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "engineering-core",
+      "kind": "skills",
+      "description": "后端核心 skill — API、架构、数据库、调试。任何后端任务的基线。",
+      "paths": [
+        "skills/api-designer",
+        "skills/architecture-designer",
+        "skills/microservices-architect",
+        "skills/graphql-architect",
+        "skills/database-optimizer",
+        "skills/postgres-pro",
+        "skills/sql-pro",
+        "skills/debugging-wizard",
+        "skills/legacy-modernizer",
+        "skills/fullstack-guardian",
+        "skills/feature-forge",
+        "skills/code-documenter"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": true,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "engineering-languages",
+      "kind": "skills",
+      "description": "语言/栈专项 skill — 按项目栈按需加载，不默认全装。",
+      "paths": [
+        "skills/typescript-pro",
+        "skills/javascript-pro",
+        "skills/nestjs-expert",
+        "skills/python-pro",
+        "skills/fastapi-expert",
+        "skills/django-expert",
+        "skills/pandas-pro",
+        "skills/golang-pro",
+        "skills/rust-engineer",
+        "skills/cpp-pro",
+        "skills/java-architect",
+        "skills/spring-boot-engineer",
+        "skills/kotlin-specialist",
+        "skills/swift-expert",
+        "skills/php-pro",
+        "skills/laravel-specialist",
+        "skills/rails-expert",
+        "skills/csharp-developer",
+        "skills/dotnet-core-expert"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": false,
+      "cost": "heavy",
+      "stability": "stable"
+    },
+    {
+      "id": "engineering-infra",
+      "kind": "skills",
+      "description": "基础设施、DevOps、云、CLI、AI/ML 工程 skill。",
+      "paths": [
+        "skills/devops-engineer",
+        "skills/sre-engineer",
+        "skills/cloud-architect",
+        "skills/kubernetes-specialist",
+        "skills/terraform-engineer",
+        "skills/cli-developer",
+        "skills/mcp-developer",
+        "skills/websocket-engineer",
+        "skills/monitoring-expert",
+        "skills/ml-pipeline",
+        "skills/fine-tuning-expert",
+        "skills/rag-architect",
+        "skills/spark-engineer"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "quality",
+      "kind": "skills",
+      "description": "审查、测试、安全 skill — 任何交付前的门禁。",
+      "paths": [
+        "skills/code-reviewer",
+        "skills/security-reviewer",
+        "skills/secure-code-guardian",
+        "skills/tdd-guide",
+        "skills/test-master",
+        "skills/senior-qa",
+        "skills/playwright-expert",
+        "skills/chaos-engineer"
+      ],
+      "targets": [
+        "claude",
+        "codex"
+      ],
+      "defaultInstall": true,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "agents-core",
+      "kind": "agents",
+      "description": "核心 agent — 对齐 ECC 派遣规则（docs/rules/agents.md）。",
+      "agents": [
+        "planner",
+        "architect",
+        "tdd-guide",
+        "code-reviewer",
+        "security-reviewer",
+        "build-error-resolver",
+        "e2e-runner",
+        "refactor-cleaner",
+        "doc-updater",
+        "rust-reviewer",
+        "init-architect",
+        "get-current-datetime"
+      ],
+      "targets": [
+        "claude"
+      ],
+      "defaultInstall": true,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "agents-quality",
+      "kind": "agents",
+      "description": "代码质量深度分析 — 代码探索、架构提取、简化、注释、性能、静默失败、类型设计、对话分析。",
+      "agents": [
+        "code-explorer",
+        "code-architect",
+        "code-simplifier",
+        "comment-analyzer",
+        "conversation-analyzer",
+        "performance-optimizer",
+        "silent-failure-hunter",
+        "type-design-analyzer"
+      ],
+      "targets": [
+        "claude"
+      ],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "agents-language",
+      "kind": "agents",
+      "description": "各语言专项 reviewer / build-resolver — 按项目栈按需选。",
+      "agents": [
+        "cpp-build-resolver",
+        "cpp-reviewer",
+        "csharp-reviewer",
+        "dart-build-resolver",
+        "flutter-reviewer",
+        "go-build-resolver",
+        "go-reviewer",
+        "java-build-resolver",
+        "java-reviewer",
+        "kotlin-build-resolver",
+        "kotlin-reviewer",
+        "python-reviewer",
+        "pytorch-build-resolver",
+        "rust-build-resolver",
+        "typescript-reviewer"
+      ],
+      "targets": [
+        "claude"
+      ],
+      "defaultInstall": false,
+      "cost": "heavy",
+      "stability": "stable"
+    },
+    {
+      "id": "agents-ops",
+      "kind": "agents",
+      "description": "运维与工作流操作 — 数据库审查、文档查证、PR 分析、loop 操作、harness 优化、个人通信中枢。",
+      "agents": [
+        "chief-of-staff",
+        "database-reviewer",
+        "docs-lookup",
+        "harness-optimizer",
+        "loop-operator",
+        "pr-test-analyzer"
+      ],
+      "targets": [
+        "claude"
+      ],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "agents-domain",
+      "kind": "agents",
+      "description": "特殊领域 agent — 无障碍、医疗合规、开源治理、GAN 协作、SEO 等。按业务需要装。",
+      "agents": [
+        "a11y-architect",
+        "gan-evaluator",
+        "gan-generator",
+        "gan-planner",
+        "healthcare-reviewer",
+        "opensource-forker",
+        "opensource-packager",
+        "opensource-sanitizer",
+        "seo-specialist"
+      ],
+      "targets": [
+        "claude"
+      ],
+      "defaultInstall": false,
+      "cost": "light",
+      "stability": "experimental"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aigroup-workflow",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "description": "AI 团队协作框架 — 通过角色派遣、工作流管道和 Harness 传感器驱动 AI 协作开发",
   "type": "module",
   "bin": {
@@ -13,10 +13,15 @@
     "docs/",
     "skills/",
     "scripts/",
+    "manifests/",
     ".claude/commands/",
     ".claude/agents/",
     ".claude/hooks.json",
-    "CLAUDE.md"
+    ".claude-plugin/",
+    ".codex/",
+    ".codex-plugin/",
+    "CLAUDE.md",
+    "AGENTS.md"
   ],
   "keywords": [
     "claude-code",

package/scripts/harness/log-event.sh

@@ -3,18 +3,18 @@
 # Harness 事件写入工具
 #
 # 职责：将 harness 事件以 JSONL 格式追加到日志文件
-# 调用者：workflow-state.sh / lint-*.sh / Max（主动调用）
+# 调用者：主会话或 hooks/checks（主动调用）
 # 设计原则：fail-silent — 写入失败不得中断调用方主流程
 #
 # 用法：
-#   log-event.sh <event_type> [--stage S] [--actor A] [--duration-ms D] [--payload k=v,k=v,...]
+#   log-event.sh <event_type> [--workflow-id W] [--stage S] [--actor A] [--duration-ms D] [--payload k=v,k=v,...]
 #
 # 示例：
-#   log-event.sh stage_enter --actor harness
-#   log-event.sh dispatch --actor max --payload "target=jarvis,task_id=T5"
-#   log-event.sh lint_fail --payload "rule=template-missing,file=prd.md"
+#   log-event.sh dispatch --workflow-id refactor-auth --actor main --payload "target=planner"
+#   log-event.sh worker_completed --workflow-id refactor-auth --actor planner
+#   log-event.sh lint_fail --payload "rule=empty-docs,file=docs/x.md"
 #
-# 输出：.dev-agents/shared/logs/events-YYYY-MM-DD.jsonl（追加一行）
+# 输出：.orchestration/.logs/events-YYYY-MM-DD.jsonl（追加一行）
 # ================================================================
 
 EVENT_TYPE="${1:-}"
@@ -27,6 +27,7 @@ fi
 shift
 
 # ── 解析参数 ──
+WORKFLOW_ID_ARG=""
 STAGE_ARG=""
 ACTOR_ARG=""
 DURATION_ARG=""
@@ -34,6 +35,7 @@ PAYLOAD_ARG=""
 
 while [ $# -gt 0 ]; do
     case "$1" in
+        --workflow-id) WORKFLOW_ID_ARG="$2"; shift 2 ;;
         --stage) STAGE_ARG="$2"; shift 2 ;;
         --actor) ACTOR_ARG="$2"; shift 2 ;;
         --duration-ms) DURATION_ARG="$2"; shift 2 ;;
@@ -42,21 +44,9 @@ while [ $# -gt 0 ]; do
     esac
 done
 
-# ── 读取 state 文件作为默认值 ──
-STATE_FILE=".dev-agents/shared/.workflow-state"
-DEFAULT_WORKFLOW_ID="idle"
-DEFAULT_STAGE="idle"
-
-if [ -f "$STATE_FILE" ]; then
-    WORKFLOW_ID_FROM_STATE=$(grep '^task=' "$STATE_FILE" 2>/dev/null | cut -d'=' -f2-)
-    STAGE_FROM_STATE=$(grep '^stage=' "$STATE_FILE" 2>/dev/null | cut -d'=' -f2-)
-    [ -n "$WORKFLOW_ID_FROM_STATE" ] && DEFAULT_WORKFLOW_ID="$WORKFLOW_ID_FROM_STATE"
-    [ -n "$STAGE_FROM_STATE" ] && DEFAULT_STAGE="$STAGE_FROM_STATE"
-fi
-
-STAGE="${STAGE_ARG:-$DEFAULT_STAGE}"
+WORKFLOW_ID="${WORKFLOW_ID_ARG:-idle}"
+STAGE="${STAGE_ARG:-idle}"
 ACTOR="${ACTOR_ARG:-harness}"
-WORKFLOW_ID="$DEFAULT_WORKFLOW_ID"
 
 # ── 时间戳（ISO-8601 带时区）──
 TS=$(date +%Y-%m-%dT%H:%M:%S%z)
@@ -108,7 +98,7 @@ fi
 JSON="{\"ts\":\"${TS}\",\"workflow_id\":\"$(json_escape "$WORKFLOW_ID")\",\"stage\":\"$(json_escape "$STAGE")\",\"event_type\":\"$(json_escape "$EVENT_TYPE")\",\"actor\":\"$(json_escape "$ACTOR")\"${DURATION_FIELD},\"payload\":${PAYLOAD_JSON}}"
 
 # ── 写入（fail-silent）──
-LOG_DIR=".dev-agents/shared/logs"
+LOG_DIR=".orchestration/.logs"
 LOG_FILE="${LOG_DIR}/events-$(date +%Y-%m-%d).jsonl"
 
 {

package/scripts/harness/logs-query.sh

@@ -10,7 +10,7 @@
 # 实现：纯 bash + grep + sed，无 jq 依赖
 # ================================================================
 
-LOG_DIR=".dev-agents/shared/logs"
+LOG_DIR=".orchestration/.logs"
 
 # ── 辅助：返回近 N 天内的日志文件路径（一行一个）──
 # 基于文件名 events-YYYY-MM-DD.jsonl 解析日期并与 (today - N 天) 比较。
@@ -39,12 +39,7 @@ get_log_files_within_days() {
 }
 
 cmd_stats() {
-    local wf_id="$1"
-    local state_file=".dev-agents/shared/.workflow-state"
-    if [ -z "$wf_id" ] && [ -f "$state_file" ]; then
-        wf_id=$(grep '^task=' "$state_file" 2>/dev/null | cut -d'=' -f2-)
-    fi
-    wf_id="${wf_id:-unknown}"
+    local wf_id="${1:-unknown}"
 
     if [ ! -d "$LOG_DIR" ]; then
         echo "[INFO] 无匹配事件（logs 目录不存在）"
@@ -88,7 +83,7 @@ cmd_stats() {
     local loop_count
     loop_count=$(grep -h "\"workflow_id\":\"${wf_id}\"" $files 2>/dev/null \
         | grep -c "\"event_type\":\"loop_iter\"")
-    echo "  Kyle 审查-修复循环: $loop_count 次"
+    echo "  reviewer 审查-修复循环: $loop_count 次"
 }
 
 cmd_hotspots() {

package/scripts/harness/tests/test-log-event.sh

@@ -7,19 +7,11 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
 LOG_EVENT="$ROOT/scripts/harness/log-event.sh"
 
-# 用临时目录做隔离测试
 TMP=$(mktemp -d)
 trap "rm -rf $TMP" EXIT
 
 cd "$TMP"
-mkdir -p .dev-agents/shared
-cat > .dev-agents/shared/.workflow-state <<EOF
-stage=testing
-task=test-task
-started=2026-04-23 00:00:00
-exempt=false
-updated=2026-04-23 00:00:00
-EOF
+mkdir -p .orchestration
 
 PASS=0
 FAIL=0
@@ -37,42 +29,35 @@ assert() {
     fi
 }
 
-echo "▸ 测试 1：基础事件写入"
-bash "$LOG_EVENT" stage_enter --actor harness
-LOG_FILE=".dev-agents/shared/logs/events-$(date +%Y-%m-%d).jsonl"
+echo "▸ 测试 1：基础事件写入（带 workflow-id/stage 参数）"
+bash "$LOG_EVENT" worker_completed --workflow-id test-session --stage development --actor planner
+LOG_FILE=".orchestration/.logs/events-$(date +%Y-%m-%d).jsonl"
 assert "日志文件已创建" "[ -f '$LOG_FILE' ]"
-assert "事件类型正确" "grep -q '\"event_type\":\"stage_enter\"' '$LOG_FILE'"
-assert "workflow_id 从 state 读取" "grep -q '\"workflow_id\":\"test-task\"' '$LOG_FILE'"
-assert "stage 从 state 读取" "grep -q '\"stage\":\"testing\"' '$LOG_FILE'"
-assert "actor 正确" "grep -q '\"actor\":\"harness\"' '$LOG_FILE'"
+assert "事件类型正确" "grep -q '\"event_type\":\"worker_completed\"' '$LOG_FILE'"
+assert "workflow_id 来自参数" "grep -q '\"workflow_id\":\"test-session\"' '$LOG_FILE'"
+assert "stage 来自参数" "grep -q '\"stage\":\"development\"' '$LOG_FILE'"
+assert "actor 正确" "grep -q '\"actor\":\"planner\"' '$LOG_FILE'"
 
 echo ""
 echo "▸ 测试 2：payload 解析"
-bash "$LOG_EVENT" dispatch --actor max --payload "target=jarvis,task_id=T5"
-assert "payload 包含 target" "grep -q '\"target\":\"jarvis\"' '$LOG_FILE'"
+bash "$LOG_EVENT" dispatch --workflow-id test-session --actor main --payload "target=backend-engineer,task_id=T5"
+assert "payload 包含 target" "grep -q '\"target\":\"backend-engineer\"' '$LOG_FILE'"
 assert "payload 包含 task_id" "grep -q '\"task_id\":\"T5\"' '$LOG_FILE'"
 
 echo ""
 echo "▸ 测试 3：duration_ms 字段"
-bash "$LOG_EVENT" stage_exit --duration-ms 12345
+bash "$LOG_EVENT" phase_skipped --workflow-id test-session --duration-ms 12345
 assert "duration_ms 存在且为数字" "grep -q '\"duration_ms\":12345' '$LOG_FILE'"
 
 echo ""
-echo "▸ 测试 4：state 文件缺失时 fallback 为 idle"
-rm .dev-agents/shared/.workflow-state
-bash "$LOG_EVENT" workflow_reset
-assert "无 state 时 workflow_id 为 idle" "grep -q '\"workflow_id\":\"idle\"' '$LOG_FILE'"
-assert "无 state 时 stage 为 idle" "tail -1 '$LOG_FILE' | grep -q '\"stage\":\"idle\"'"
+echo "▸ 测试 4：省略参数时 fallback 为 idle"
+bash "$LOG_EVENT" red_flag --actor main
+assert "省略 workflow-id 时为 idle" "tail -1 '$LOG_FILE' | grep -q '\"workflow_id\":\"idle\"'"
+assert "省略 stage 时为 idle" "tail -1 '$LOG_FILE' | grep -q '\"stage\":\"idle\"'"
 
 echo ""
 echo "▸ 测试 5：特殊字符转义"
-cat > .dev-agents/shared/.workflow-state <<EOF
-stage=design
-task=test-task
-started=2026-04-23 00:00:00
-exempt=false
-EOF
-bash "$LOG_EVENT" red_flag --actor max --payload 'msg=has "quotes" and \ backslash'
+bash "$LOG_EVENT" red_flag --actor main --payload 'msg=has "quotes" and \ backslash'
 assert "双引号被转义" "tail -1 '$LOG_FILE' | grep -q '\\\\\"quotes\\\\\"'"
 
 echo ""

package/scripts/harness/tests/test-logs-query.sh

@@ -10,9 +10,9 @@ trap "rm -rf $TMP" EXIT
 cd "$TMP"
 
 # 构造 mock 日志
-mkdir -p .dev-agents/shared/logs
+mkdir -p .orchestration/.logs
 TODAY=$(date +%Y-%m-%d)
-LOG="$TMP/.dev-agents/shared/logs/events-$TODAY.jsonl"
+LOG="$TMP/.orchestration/.logs/events-$TODAY.jsonl"
 
 cat > "$LOG" <<EOF
 {"ts":"2026-04-23T10:00:00+0800","workflow_id":"wf1","stage":"brainstorming","event_type":"stage_enter","actor":"harness","payload":{}}
@@ -46,7 +46,7 @@ assert "red_flag 按 flag_id 聚合" "echo '$OUT' | grep -E 'red_flag.*3|3.*red_
 echo ""
 echo "▸ 测试 2b：--days 过滤真实生效"
 # 创建一个旧日期的日志文件，验证 --days N 是否真实按日期过滤
-OLD_LOG="$TMP/.dev-agents/shared/logs/events-2025-01-01.jsonl"
+OLD_LOG="$TMP/.orchestration/.logs/events-2025-01-01.jsonl"
 echo '{"ts":"2025-01-01T00:00:00+0800","workflow_id":"wfold","stage":"testing","event_type":"lint_fail","actor":"harness","payload":{"lint":"ancient"}}' > "$OLD_LOG"
 
 # --days 3650 应包含 ancient（近 10 年窗口覆盖 2025-01-01）
@@ -67,7 +67,7 @@ assert "CSV 行数 >= 8" "[ \$(wc -l < '$TMP/out.csv') -ge 8 ]"
 echo ""
 echo "▸ 测试 4：空日志不报错"
 # 清空所有 mock 日志文件（包括测试 2b 创建的历史日志），确保目录为空
-rm -f "$TMP/.dev-agents/shared/logs"/events-*.jsonl
+rm -f "$TMP/.orchestration/.logs"/events-*.jsonl
 OUT=$(bash "$QUERY" --stats 2>&1)
 assert "空日志返回码 0" "bash '$QUERY' --stats >/dev/null 2>&1"
 assert "含 '无匹配事件' 提示" "echo '$OUT' | grep -qE '无匹配|无事件|no events'"

package/scripts/hooks/README.md

@@ -0,0 +1,49 @@
+# scripts/hooks — Hook Dispatcher
+
+**单一入口**：`dispatcher.cjs <event>` 读 stdin JSON、路由到对应 checks、失败 `exit 2`（错误回注 Claude 上下文）。
+
+## 事件 → Checks 映射
+
+| 事件 | 触发时机 | 执行的 checks |
+|------|----------|---------------|
+| `post-edit` | `PostToolUse: Write\|Edit` | `claude-md-size`, `empty-docs` |
+| `subagent-stop` | `SubagentStop` | `structure`, `orchestration-artifacts` |
+| `stop` | `Stop` | `structure`, `claude-md-size`, `empty-docs`, `delegation-antipatterns`, `workflow-state`, `orchestration-artifacts` |
+
+## 添加新检查
+
+1. 在 `checks/` 下新建 `<name>.cjs`，导出 `{ run(): Report, section: string }`。
+2. 在 `dispatcher.cjs` 的 `DISPATCH` 中把它加入对应事件。
+
+Report API：
+
+```js
+const { createReport } = require('../lib/runner.cjs');
+function run() {
+  const report = createReport();
+  if (badCondition) {
+    report.fail('说人话的问题描述', '说人话的修复提示');
+  }
+  return report;
+}
+```
+
+## 直接调用（调试）
+
+```bash
+echo '{}' | node scripts/hooks/dispatcher.cjs stop
+echo '{}' | node scripts/hooks/dispatcher.cjs post-edit
+echo '{}' | node scripts/hooks/dispatcher.cjs subagent-stop
+```
+
+## 退出码
+
+- `0`：无问题 或 仅 WARN
+- `1`：未知事件（调用错误）
+- `2`：有 FAIL，错误信息回注 Claude 上下文以便修复
+
+## 与 harness/ 的分工
+
+- `scripts/hooks/` — 由 `.claude/hooks.json` 自动触发的 check 集合（只读，快速）
+- `scripts/orchestration/session.cjs` — 协调会话 / worker 三件套管理（状态真相源）
+- `scripts/harness/log-event.sh` / `logs-query.sh` — 事件日志落盘与查询（CLI，可选）

package/scripts/hooks/checks/claude-md-size.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+const { createReport, readFileSafe } = require('../lib/runner.cjs');
+
+const MAX_LINES = 100;
+
+function run() {
+  const report = createReport();
+  const content = readFileSafe('CLAUDE.md');
+  if (content === null) return report;
+  const lines = content.split('\n').length;
+  if (lines > MAX_LINES) {
+    report.fail(
+      `CLAUDE.md 超过 ${MAX_LINES} 行（当前 ${lines} 行）`,
+      'CLAUDE.md 应保持为目录式入口，详细内容移至 docs/'
+    );
+  }
+  return report;
+}
+
+module.exports = { run, section: 'CLAUDE.md 体积检查' };

package/scripts/hooks/checks/delegation-antipatterns.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { createReport, ROOT, relPosix } = require('../lib/runner.cjs');
+
+const SCAN_DIRS = ['docs', 'skills', '.claude'];
+const EXCLUDE_FILES = new Set([
+  'docs/rules/agents.md',
+  'docs/red-flags.md',
+  'scripts/hooks/checks/delegation-antipatterns.cjs'
+]);
+
+const PATTERNS = [
+  {
+    re: /\.dev-agents\//g,
+    fix: '旧目录已移除；使用 .orchestration/<session>/<worker>/ 或 docs/PROJECT_CONTEXT.md'
+  },
+  {
+    re: /\.orchestration\/(ella|jarvis|kyle)\//g,
+    fix: '禁止按角色建协调目录；worker 应按职能（planner/architect/code-reviewer...）命名'
+  },
+  {
+    re: /(读取|加载|load|read)[^\n]{0,20}\.claude\/agents\/[a-z-]+\.md[^\n]{0,20}(你的角色|角色|persona|role)/gi,
+    fix: 'Claude Code 原生已自动加载 agent frontmatter，prompt 里不要再让 agent 读自己的定义'
+  }
+];
+
+function walk(dir, acc = []) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch (_error) {
+    return acc;
+  }
+  for (const entry of entries) {
+    if (entry.name.startsWith('.') && entry.name !== '.claude') continue;
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === 'node_modules' || entry.name === 'everything-claude-code') continue;
+      walk(full, acc);
+    } else if (entry.isFile() && (full.endsWith('.md') || full.endsWith('.toml'))) {
+      acc.push(full);
+    }
+  }
+  return acc;
+}
+
+function run() {
+  const report = createReport();
+  const files = SCAN_DIRS.flatMap(dir => walk(path.join(ROOT, dir)));
+  for (const file of files) {
+    const rel = relPosix(file);
+    if (EXCLUDE_FILES.has(rel)) continue;
+    const content = fs.readFileSync(file, 'utf8');
+    for (const { re, fix } of PATTERNS) {
+      re.lastIndex = 0;
+      if (re.test(content)) {
+        report.fail(`${rel}: 命中反模式 /${re.source}/`, fix);
+      }
+    }
+  }
+  return report;
+}
+
+module.exports = { run, section: '派遣契约反模式检查' };