Claude Code Dynamic Workflow 上手指南:多 Agent 编排

.claude/
├── workflows/              # Workflow 脚本存放目录
│   └── math-problems.js    # 一个 workflow = 一个 .js 文件
├── agents/                 # 自定义 agent 定义（⚠️ workflow 无法引用）
│   ├── math-solver.md      # 仅用于主会话自动路由
│   └── math-verifier.md
└── settings.json           # 项目配置

export const meta = {
  name: 'my-workflow',           // 必填：唯一标识
  description: '一句话描述',      // 必填：说明用途
  phases: [                      // 可选：定义阶段（UI 展示用）
    { title: 'Analyze' },
    { title: 'Execute' },
  ],
}

// ... 你的编排逻辑
// 用 agent() / pipeline() / parallel() 编排
// 最后 return 结果

export const meta = {
  name: 'hello',
  description: '最简单的 workflow',
  phases: [{ title: 'Greet' }],
}

const result = await agent('说一句 hello world', { phase: 'Greet' })
return result

export const meta = {
  name: 'hello-name',
  description: '打招呼',
}

// args 由外部传入
const name = (args && args.name) || 'World'
const result = await agent(`对 ${name} 说你好，介绍自己`)
return result

// 基础用法
const result = await agent('你的提示词')

// 完整参数
const result = await agent('你的提示词', {
  label: '显示名称',           // UI 中显示的标签
  phase: 'Solve',             // 归属阶段
  schema: {                   // 强制结构化输出（JSON Schema）
    type: 'object',
    properties: {
      answer: { type: 'string' },
      confidence: { type: 'number' }
    }
  },
  model: 'sonnet',            // 可选模型覆盖
  agentType: 'Explore',       // ⚠️ 仅支持内置类型，不支持自定义
})

const results = await pipeline(
  ['题1', '题2', '题3'],         // 数据数组
  (item) => agent(`处理: ${item}`),     // stage 1
  (prev, item) => agent(`审核: ${prev}`), // stage 2
)

// results[0] = stage2(题1) 的结果
// results[1] = stage2(题2) 的结果
// 每个数据项独立走完整个 pipeline，不同项之间并行

const results = await parallel([
  () => agent('分析前端代码'),
  () => agent('分析后端代码'),
  () => agent('分析数据库'),
])

// results = [前端分析, 后端分析, 数据库分析]
// 任一失败返回 null，用 .filter(Boolean) 过滤

phase('Review')          // 切换到 Review 阶段（UI 进度条分组）
log('已处理 3/10 个文件')  // 输出进度信息

每组的数据流（以第一组为例）：

┌─────────────────────────────────────────────────┐
│ Stage 1: Solver                                 │
│ prompt = SOLVER_PROMPT + 组1全部题目             │
│ output = 5道题的详细解答                         │
└──────────────────────┬──────────────────────────┘
                       │ solution (上一阶段输出)
┌──────────────────────▼──────────────────────────┐
│ Stage 2: Verifier                               │
│ prompt = VERIFIER_PROMPT + 组1题目 + solution   │
│ output = 逐题验证结果（✅/❌）                   │
└──────────────────────┬──────────────────────────┘
                       │ verification (上一阶段输出)
┌──────────────────────▼──────────────────────────┐
│ Stage 3: Scorer                                 │
│ prompt = SCORER_PROMPT + 组1题目 + verification │
│ output = 每道题的分数和评语                      │
└─────────────────────────────────────────────────┘

你是一位数学解题专家。请逐一解答以下数学题。

1. 12 × 15 = ?
2. √144 + 3² = ?
3. 2^10 = ?
4. 1 + 2 + 3 + ... + 100 = ?
5. 1/2 + 1/3 + 1/6 = ?

输出格式（每道题）：
- 题目：{原题}
- 解题过程：{逐步推导}
- 答案：{最终结果}

你是一位数学解题专家。请逐一解答以下数学题。

6. 100! 末尾有多少个 0？
7. sin30° × cos60° = ?
8. log₂1024 = ?
9. 一个圆的周长是 31.4cm，求面积（π≈3.14）
10. 解方程：2x + 5 = 17

输出格式（每道题）：
- 题目：{原题}
- 解题过程：{逐步推导}
- 答案：{最终结果}

你是一位数学验证专家。独立重新解题，对比下面的解答。

1. 12 × 15 = ?
2. √144 + 3² = ?
3. 2^10 = ?
4. 1 + 2 + 3 + ... + 100 = ?
5. 1/2 + 1/3 + 1/6 = ?

=== 待验证的解答 ===
[Solver 的完整输出会插入这里]

=== 要求 ===
- 独立计算，不可信任给出的解答
- 逐步对比，标注对错
- 有错误则精确指出位置

输出格式：
- 判定：✅ 正确 / ❌ 错误
- 验证过程：{独立推导}
- 错误原因：{如有}

你是数学评分专家。综合解题和验证结果打分。

1. 12 × 15 = ?
2. √144 + 3² = ?
3. 2^10 = ?
4. 1 + 2 + 3 + ... + 100 = ?
5. 1/2 + 1/3 + 1/6 = ?

=== 验证结果 ===
[Verifier 的完整输出会插入这里]

评分：10=完美 | 7-9=正确可改进 | 4-6=部分正确 | 0-3=错误

输出格式：
- 分数：{0-10}
- 评语：{一句话}

export const meta = {
  name: 'math-problems',
  description: '数学题 workflow — 题目按组写入 prompt，3阶段 pipeline（解题→验证→评分）',
  phases: [
    { title: 'Solve', detail: '每组并行解题' },
    { title: 'Verify', detail: '独立验证每组解答' },
    { title: 'Score', detail: '综合评分' },
  ],
}

// ─── Prompt 模板（顶部定义，一目了然）──────────────
// {problems_block}  → 该组所有题目
// {solution}        → Solver 的输出
// {verification}    → Verifier 的输出

const SOLVER_PROMPT = `你是一位数学解题专家。请逐一解答以下数学题。

{problems_block}

输出格式（每道题）：
- 题目：{原题}
- 解题过程：{逐步推导}
- 答案：{最终结果}`

const VERIFIER_PROMPT = `你是一位数学验证专家。独立重新解题，对比下面的解答。

{problems_block}

=== 待验证的解答 ===
{solution}

=== 要求 ===
- 独立计算，不可信任给出的解答
- 逐步对比，标注对错
- 有错误则精确指出位置

输出格式：
- 判定：✅ 正确 / ❌ 错误
- 验证过程：{独立推导}
- 错误原因：{如有}`

const SCORER_PROMPT = `你是数学评分专家。综合解题和验证结果打分。

{problems_block}

=== 验证结果 ===
{verification}

评分：10=完美 | 7-9=正确可改进 | 4-6=部分正确 | 0-3=错误

输出格式：
- 分数：{0-10}
- 评语：{一句话}`

// ─── 题目分组（直接写在这里，初学者直接改）──────────
const DEFAULT_GROUPS = [
  {
    name: '第一组（基础计算）',
    problems: [
      '1. 12 × 15 = ?',
      '2. √144 + 3² = ?',
      '3. 2^10 = ?',
      '4. 1 + 2 + 3 + ... + 100 = ?',
      '5. 1/2 + 1/3 + 1/6 = ?',
    ],
  },
  {
    name: '第二组（进阶题目）',
    problems: [
      '6. 100! 末尾有多少个 0？',
      '7. sin30° × cos60° = ?',
      '8. log₂1024 = ?',
      '9. 一个圆的周长是 31.4cm，求面积（π≈3.14）',
      '10. 解方程：2x + 5 = 17',
    ],
  },
]

// ─── 主流程 ─────────────────────────────────────────
const groups = (args && args.groups && args.groups.length)
  ? args.groups
  : DEFAULT_GROUPS

log(`共 ${groups.reduce((n, g) => n + g.problems.length, 0)} 道题，${groups.length} 组`)
groups.forEach((g) => log(`  ${g.name}: ${g.problems.join(', ')}`))

// 每组并行跑 pipeline，题目直接写在 prompt 里
const results = await parallel(
  groups.map((group) => () => {
    const problemsBlock = group.problems.join('\n')
    return pipeline(
      [group],  // 整组作为一个单元
      // Stage 1: 解题
      (grp) => agent(
        SOLVER_PROMPT.replace('{problems_block}', grp.problems.join('\n')),
        { label: `${grp.name}-解题`, phase: 'Solve' }
      ),
      // Stage 2: 验证
      (solution, grp) => agent(
        VERIFIER_PROMPT
          .replace('{problems_block}', grp.problems.join('\n'))
          .replace('{solution}', solution),
        { label: `${grp.name}-验证`, phase: 'Verify' }
      ),
      // Stage 3: 评分
      (verification, grp) => agent(
        SCORER_PROMPT
          .replace('{problems_block}', grp.problems.join('\n'))
          .replace('{verification}', verification),
        { label: `${grp.name}-评分`, phase: 'Score' }
      ),
    )
  })
)

// 按组返回
const output = {}
groups.forEach((g, i) => output[g.name] = results[i][0])
return output

跑 workflow math-problems

Workflow({ name: 'math-problems' })

跑 workflow math-problems，8道题分4组：
12×15, √144+3², 2^10, 100!末尾几个0,
1+2+...+100, sin30°×cos60°, log₂1024, 1/2+1/3+1/6

Workflow({
  name: 'math-problems',
  args: {
    groups: [
      { name: '组1', problems: ['1. 12×15', '2. √144+3²'] },
      { name: '组2', problems: ['3. 2^10', '4. 100!末尾几个0'] },
      { name: '组3', problems: ['5. 1+2+...+100', '6. sin30°×cos60°'] },
      { name: '组4', problems: ['7. log₂1024', '8. 1/2+1/3+1/6'] },
    ]
  }
})

跑 workflow math-problems，分2组：
几何题：求半径5的圆面积、求边长3的正方体体积
代数题：解方程 x²-4=0、求 3x+2=14 的 x

Workflow({
  name: 'math-problems',
  args: {
    groups: [
      { name: '几何题', problems: ['求半径5的圆面积', '求边长3的正方体体积'] },
      { name: '代数题', problems: ['解方程 x²-4=0', '求 3x+2=14 的 x'] },
    ]
  }
})

// ─── Prompt 模板（顶部定义，一眼看清所有 agent） ──────────

const SOLVER_PROMPT = `你是一位数学解题专家。请逐一解答以下数学题。

{problems_block}

输出格式（每道题）：
- 题目：{原题}
- 解题过程：{逐步推导}
- 答案：{最终结果}`

const VERIFIER_PROMPT = `你是一位数学验证专家。独立重新解题，对比下面的解答。

{problems_block}

=== 待验证的解答 ===
{solution}

=== 要求 ===
- 独立计算，不可信任给出的解答
- 逐步对比，标注对错

输出格式：
- 判定：✅ 正确 / ❌ 错误
- 错误原因：{如有}`

const SCORER_PROMPT = `你是数学评分专家。综合解题和验证结果打分。

{problems_block}

=== 验证结果 ===
{verification}

评分：10=完美 | 7-9=正确可改进 | 4-6=部分正确 | 0-3=错误

输出格式：
- 分数：{0-10}
- 评语：{一句话}`
// ─── 模板结束 ─────────────────────────────────────────

// pipeline 中用 .replace() 把数据填入模板
pipeline(
  [group],  // 整组数据
  // Stage 1: 解题
  (grp) => agent(
    SOLVER_PROMPT.replace('{problems_block}', grp.problems.join('\n')),
    { label: `${grp.name}-解题`, phase: 'Solve' }
  ),
  // Stage 2: 验证（solution 是上一阶段输出）
  (solution, grp) => agent(
    VERIFIER_PROMPT
      .replace('{problems_block}', grp.problems.join('\n'))
      .replace('{solution}', solution),
    { label: `${grp.name}-验证`, phase: 'Verify' }
  ),
  // Stage 3: 评分（verification 是上一阶段输出）
  (verification, grp) => agent(
    SCORER_PROMPT
      .replace('{problems_block}', grp.problems.join('\n'))
      .replace('{verification}', verification),
    { label: `${grp.name}-评分`, phase: 'Score' }
  ),
)

claude, claude-code-guide, Explore, general-purpose, Plan
gsd-*, glm-plan-usage:usage-query-agent, statusline-setup

export const meta = {
  name: 'my-workflow',
  description: '描述',
  phases: [{ title: 'Phase1' }, { title: 'Phase2' }],
}

// 1. Prompt 模板（顶部定义，{占位符} 标记数据位置）
const AGENT_PROMPT = `你是一位专家。

{data_block}

请按要求处理以上数据。`

// 2. 数据分组（直接定义，初学者一眼看懂）
const DEFAULT_GROUPS = [
  { name: '组A', items: ['数据1', '数据2'] },
  { name: '组B', items: ['数据3', '数据4'] },
]

const groups = (args && args.groups) || DEFAULT_GROUPS

// 3. 编排：每组并行，组内 pipeline
const results = await parallel(
  groups.map(group => () => pipeline(
    [group],
    (grp) => agent(
      AGENT_PROMPT.replace('{data_block}', grp.items.join('\n')),
      { label: `${grp.name}-阶段1`, phase: 'Phase1' }
    ),
    (prev, grp) => agent(
      '基于结果进一步处理:\n' + prev,
      { label: `${grp.name}-阶段2`, phase: 'Phase2' }
    ),
  ))
)

// 4. 按组返回
const output = {}
groups.forEach((g, i) => output[g.name] = results[i][0])
return output