多 Agent 协作

┌─────────────────────────────┐
│      主 Agent (Main)        │
│  - 理解用户意图              │
│  - 规划任务步骤              │
│  - 协调子 Agent             │
│  - 汇总最终结果              │
├─────────────────────────────┤
│      子 Agent (Sub)         │
│  - 执行具体任务              │
│  - 文件搜索和分析            │
│  - 代码生成和修改            │
│  - 运行命令                 │
└─────────────────────────────┘

┌──────────────────────────┐
│    编排脚本 (Orchestrator) │
│    Shell / Node.js / Python │
├──────┬──────┬──────┬─────┤
│      │      │      │      │
▼      ▼      ▼      ▼      ▼
Agent1 Agent2 Agent3 Agent4 Agent5
前端    后端    数据库  测试    文档

#!/bin/bash

# 定义要处理的文件列表
files=("Button.tsx" "Modal.tsx" "Form.tsx" "Table.tsx" "Input.tsx")

# 创建结果目录
mkdir -p results

# 并行执行
for file in "${files[@]}"; do
  claude -p "分析 src/components/$file 的代码质量，给出评分和改进建议" \
    --output-format json > "results/${file%.tsx}.json" &
done

# 等待所有任务完成
wait

echo "所有分析任务已完成，结果保存在 results/ 目录"

#!/bin/bash

MAX_PARALLEL=3
current_jobs=0

files=$(find src -name "*.ts" -type f)

for file in $files; do
  # 等待，直到并发数低于上限
  while [ $current_jobs -ge $MAX_PARALLEL ]; do
    wait -n  # 等待任意一个后台任务完成
    current_jobs=$((current_jobs - 1))
  done

  # 启动新的 Agent
  claude -p "审查 $file 中的代码，列出潜在问题" \
    --output-format text > "review_$(basename $file).txt" &
  current_jobs=$((current_jobs + 1))
done

# 等待剩余任务完成
wait
echo "全部审查完成"

#!/bin/bash

# Agent 1: 分析项目结构，生成计划
claude -p "分析当前项目结构，列出所有需要添加测试的模块，输出为 JSON 格式" \
  --output-format text > /tmp/test-plan.json

# Agent 2: 读取计划，执行任务
claude -p "读取 /tmp/test-plan.json 中的测试计划，为第一批模块生成单元测试" \
  --output-format text

# Agent 3: 同时执行另一批
claude -p "读取 /tmp/test-plan.json 中的测试计划，为第二批模块生成单元测试" \
  --output-format text

#!/bin/bash

# 创建共享上下文文件
cat > /tmp/shared-context.md << 'CONTEXT'
# 项目重构计划

## 目标
将项目从 JavaScript 迁移到 TypeScript

## 规范
- 使用 strict 模式
- 所有函数必须有类型注解
- 使用 interface 而非 type alias（除非需要联合类型）

## 进度跟踪
（各 Agent 将在此更新进度）
CONTEXT

# 多个 Agent 共享同一个上下文
claude -p "参考 /tmp/shared-context.md 中的规范，将 src/utils/ 目录下的文件迁移到 TypeScript" &
claude -p "参考 /tmp/shared-context.md 中的规范，将 src/models/ 目录下的文件迁移到 TypeScript" &
claude -p "参考 /tmp/shared-context.md 中的规范，将 src/routes/ 目录下的文件迁移到 TypeScript" &

wait
echo "TypeScript 迁移完成"

#!/bin/bash

echo "=== 阶段 1: 分析（顺序执行）==="
analysis=$(claude -p "分析当前项目的架构和依赖关系，输出需要修改的模块列表" \
  --output-format text)

echo "=== 阶段 2: 实施（并行执行）==="
echo "$analysis" | claude -p "根据分析结果，修改前端组件。分析: $(cat -)" \
  --output-format text > /tmp/frontend-result.txt &
echo "$analysis" | claude -p "根据分析结果，修改后端接口。分析: $(cat -)" \
  --output-format text > /tmp/backend-result.txt &
wait

echo "=== 阶段 3: 测试（顺序执行）==="
claude -p "运行所有测试并修复发现的问题" --output-format text

echo "=== 阶段 4: 审查（并行执行）==="
claude -p "审查 /tmp/frontend-result.txt 中前端变更的质量" --output-format text &
claude -p "审查 /tmp/backend-result.txt 中后端变更的质量" --output-format text &
wait

echo "工作流完成"

#!/bin/bash

# 先进行分析
result=$(claude -p "检查当前项目是否有 TypeScript 配置，回答 yes 或 no" \
  --output-format text)

if echo "$result" | grep -qi "yes"; then
  echo "项目使用 TypeScript，执行 TS 相关任务..."
  claude -p "运行 TypeScript 类型检查并修复所有类型错误" --output-format text
else
  echo "项目使用 JavaScript，执行 JS 相关任务..."
  claude -p "运行 ESLint 检查并修复所有 linting 错误" --output-format text
fi

#!/bin/bash

echo "开始自动化代码审查流水线..."

# 第一步：收集变更信息
echo "--- 收集变更 ---"
changes=$(git diff --name-only HEAD~1)

# 第二步：并行审查各类文件
echo "--- 并行审查 ---"

# 筛选不同类型的文件
ts_files=$(echo "$changes" | grep '\.tsx\?$' || true)
css_files=$(echo "$changes" | grep '\.css$\|\.scss$' || true)
test_files=$(echo "$changes" | grep '\.test\.\|\.spec\.' || true)

if [ -n "$ts_files" ]; then
  claude -p "审查以下 TypeScript 文件的变更，关注类型安全和逻辑正确性：$ts_files" \
    --output-format text > /tmp/review-ts.txt &
fi

if [ -n "$css_files" ]; then
  claude -p "审查以下样式文件的变更，关注响应式设计和兼容性：$css_files" \
    --output-format text > /tmp/review-css.txt &
fi

if [ -n "$test_files" ]; then
  claude -p "审查以下测试文件的变更，关注测试覆盖率和断言质量：$test_files" \
    --output-format text > /tmp/review-tests.txt &
fi

wait

# 第三步：汇总审查结果
echo "--- 汇总结果 ---"
claude -p "请汇总以下审查结果，生成统一的审查报告：
TypeScript 审查：$(cat /tmp/review-ts.txt 2>/dev/null || echo '无')
样式审查：$(cat /tmp/review-css.txt 2>/dev/null || echo '无')
测试审查：$(cat /tmp/review-tests.txt 2>/dev/null || echo '无')" \
  --output-format text > review-report.md

echo "审查报告已生成：review-report.md"

好的分解：
- Agent 1: 处理 src/components/ 目录
- Agent 2: 处理 src/utils/ 目录
- Agent 3: 处理 src/api/ 目录

不好的分解：
- Agent 1: 创建接口定义
- Agent 2: 实现接口（依赖 Agent 1 的输出）  ← 需要改为顺序执行

太粗: "重构整个项目"                     → 一个 Agent 无法高效处理
太细: "给变量 x 改个名字"               → 不需要 Agent
合适: "将 auth 模块从 JavaScript 迁移到 TypeScript"  → 范围清晰、可独立完成

#!/bin/bash

run_agent() {
  local task="$1"
  local output_file="$2"
  local max_retries=3
  local attempt=1

  while [ $attempt -le $max_retries ]; do
    if claude -p "$task" --output-format text > "$output_file" 2>&1; then
      echo "任务成功: $output_file"
      return 0
    fi
    echo "任务失败 (尝试 $attempt/$max_retries): $output_file"
    attempt=$((attempt + 1))
    sleep 2
  done

  echo "任务最终失败: $output_file"
  return 1
}

# 使用带重试的 Agent 执行
run_agent "审查 src/api/ 目录的代码" "/tmp/review-api.txt" &
run_agent "审查 src/models/ 目录的代码" "/tmp/review-models.txt" &
wait