Chain Builder

链式构建器

Chain Builder 技能可帮助你设计并执行多步骤提示词链，让一个提示词的输出成为下一个提示词的输入。这种方式能够实现复杂的多阶段处理，而这些处理难以通过单个提示词完成，同时保持清晰、模块化且易于调试。

此技能将指导你完成链的设计、识别最佳拆分点、管理步骤间的数据流、处理错误，以及在各阶段验证输出。对于涉及多个不同阶段的任务，此技能尤其有用，例如研究 → 分析 → 综合 → 格式化，或构思 → 规划 → 实施 → 审查。

当复杂任务适合按顺序处理、需要在步骤之间进行中间验证，或任务的不同部分需要不同的专用提示词或工具时，请使用此技能。

核心工作流

工作流 1：根据目标设计提示词链

1. 明确最终目标：
   • 最终输出是什么？
   • 适用哪些质量标准？
   • 有哪些限制？
2. 拆解为逻辑阶段：
   • 确定不同阶段
   • 确定阶段边界
   • 按依赖关系排序
3. 设计各个提示词：
   • 每个阶段的用途
   • 输入要求
   • 输出规范
   • 成功标准
4. 定义数据流：
   • 各阶段之间传递什么？
   • 中间输出采用什么格式？
   • 需要维护什么状态？
5. 添加验证：
   • 每个阶段后的检查点
   • 质量关卡
   • 错误处理
6. 记录链：
   • 链的用途
   • 阶段说明
   • 数据流图
   • 使用示例
7. 测试端到端流程

工作流 2：执行现有链

1. 加载链定义：
   • 阅读链规范
   • 了解各阶段
   • 准备输入
2. 初始化链状态：
   • 设置初始输入
   • 准备输出存储
   • 初始化跟踪
3. 依次执行各阶段：
   • 运行阶段提示词
   • 验证输出
   • 如果验证失败：处理错误
   • 如果验证通过：继续
   • 存储中间结果
   • 将输出传递给下一阶段
4. 监控进度：
   • 跟踪当前阶段
   • 记录输出
   • 报告状态
5. 验证最终输出
6. 报告结果及任何问题

工作流 3：调试链故障

1. 确定故障点：
   • 哪个阶段失败了？
   • 该阶段的输入是什么？
   • 发生了什么错误？
2. 分析根本原因：
   • 输入格式是否错误？
   • 提示词是否不清晰？
   • 验证是否过于严格？
   • 上下文是否不足？
3. 单独测试该阶段：
   • 使用已知有效的输入运行该阶段
   • 确认提示词能正常工作
   • 检查输出格式
4. 修复问题：
   • 如果提示词不清晰，则更新提示词
   • 如果验证过于严格，则调整验证
   • 如有需要，添加错误处理
   • 如果数据传递格式错误，则改进数据传递
5. 从故障点重新测试
6. 记录修复内容

工作流 4：优化链的性能

1. 分析当前链：
   • 各阶段的执行时间
   • 各阶段的令牌用量
   • 各阶段的成功率
   • 瓶颈
2. 找出优化机会：
   • 可并行执行的阶段
   • 冗余处理
   • 过于复杂的提示词
   • 不必要的验证
3. 重构以提升效率：
   • 合并相关阶段
   • 并行执行相互独立的阶段
   • 简化提示词
   • 优化数据传递
4. 保持质量：
   • 不要为了速度牺牲准确性
   • 保持全面验证
   • 保留错误处理
5. 测试优化后的链
6. 衡量改进效果

快速参考

操作	命令/触发语
设计新链	“为[目标]设计一个提示词链”
执行链	“运行此链：[链规范]”
调试链故障	“调试此链：[错误详情]”
优化链	“优化此链：[链规范]”
验证链设计	“审查此链设计：[规范]”
向链中添加阶段	“为此链添加用于[目的]的阶段”
并行化阶段	“哪些阶段可以并行运行？”

最佳实践

• 让阶段专注于单一任务：每个阶段都应有一个明确的目的

  • 不要在同一个提示词中混合研究和分析
  • 不要将格式处理与内容生成结合起来
  • 每个阶段 = 一次转换

• 明确输出内容：准确地定义每个阶段的产出

  • 指定格式（JSON、markdown 等）
  • 定义必需字段
  • 设定质量标准
  • 提供示例

• 在阶段之间进行验证：尽早发现错误

  • 检查输出格式
  • 确认必需字段存在
  • 根据标准进行验证
  • 出错时立即失败

• 妥善处理错误：为故障做好准备

  • 定义重试逻辑
  • 提供回退选项
  • 记录故障以便调试
  • 不要让错误数据级联传播

• 谨慎维护状态：跟踪所需内容，丢弃不需要的内容

  • 只传递必要的数据
  • 保留中间输出以便调试
  • 在独立链之间清除状态
  • 如果链运行时间较长，则对链状态进行版本管理

• 优化数据传递：尽量减少令牌用量

  • 仅提取所需信息
  • 尽可能进行摘要
  • 使用引用而非重复内容
  • 压缩冗长输出

• 完善文档：让链易于维护

  • 每个阶段的目的
  • 预期输入/输出
  • 验证规则
  • 错误处理
  • 执行示例

• 逐步测试：逐阶段建立信心

  • 单独测试每个阶段
  • 测试阶段组合
  • 测试完整链
  • 使用边界情况进行测试

链设计模式

顺序处理

Stage 1: Collect → Stage 2: Process → Stage 3: Format → Output

适用场景：每个阶段都依赖前一阶段的完整输出 示例：网页抓取 → 数据清理 → 分析 → 报告生成

分支链

Stage 1: Analyze →
  If condition A: Stage 2a → Merge
  If condition B: Stage 2b → Merge
→ Stage 3: Synthesize

适用场景：根据条件选择不同的处理路径 示例：文件类型检测 → [JSON 解析器 | CSV 解析器 | XML 解析器] → 规范化

并行聚合

Input →
  [Stage 1a, Stage 1b, Stage 1c] (parallel) →
  Stage 2: Combine →
  Output

适用场景：多个独立分析在之后合并 示例：[语法检查、类型检查、Lint] → 汇总结果 → 报告

迭代优化

Stage 1: Generate →
Stage 2: Critique →
  If quality met: Output
  If not: Refine → back to Stage 1 (max N iterations)

适用场景：通过迭代提升输出质量 示例：编写 → 审查 → [合格？→ 完成 | 修改 → 编写]

扇出/扇入

Stage 1: Split →
  [Process chunk 1, Process chunk 2, ..., Process chunk N] →
  Stage 2: Merge →
  Output

适用场景：大型输入需要并行处理 示例：拆分文档 → [分析各部分] → 综合发现

带验证的流水线

Stage 1 → Validate → Stage 2 → Validate → Stage 3 → Validate → Output

适用场景：阶段之间需要设置质量关卡 示例：生成 → 检查语法 → 转换 → 检查架构 → 部署 → 验证

链规范格式

chain:
  name: "Chain Name"
  description: "What this chain accomplishes"
  version: "1.0.0"

  stages:
    - id: "stage_1"
      name: "Stage Name"
      prompt: "Prompt template with {{placeholders}}"
      inputs:
        - name: "input_name"
          source: "user_input | previous_stage | context"
          required: true
      outputs:
        - name: "output_name"
          format: "json | markdown | text"
          schema: "Optional JSON schema"
      validation:
        - type: "format | content | schema"
          rule: "Validation rule"
          on_fail: "retry | skip | abort"
      on_error:
        action: "retry | fallback | abort"
        max_retries: 3

    - id: "stage_2"
      name: "Next Stage"
      prompt: "Use {{stage_1.output_name}} to..."
      # ... rest of stage definition

  execution:
    mode: "sequential | parallel | conditional"
    timeout_per_stage: 300
    max_total_time: 1800

链示例

研究 → 分析 → 报告链

**Chain**: Research Report Generator

**Stage 1**: Web Research
- Prompt: "Research [topic] using web search. Find 5-10 authoritative sources."
- Output: List of sources with summaries
- Validation: At least 5 sources, each with URL and summary

**Stage 2**: Content Analysis
- Input: Sources from Stage 1
- Prompt: "Analyze these sources and extract key themes, findings, and insights."
- Output: Structured analysis (JSON)
- Validation: JSON schema with required fields

**Stage 3**: Report Writing
- Input: Analysis from Stage 2
- Prompt: "Write executive report based on analysis. Include summary, findings, recommendations."
- Output: Markdown report
- Validation: Contains required sections

**Stage 4**: Formatting
- Input: Report from Stage 3
- Prompt: "Format report for [platform] with proper structure and styling."
- Output: Platform-ready document

代码生成 → 审查 → 测试链

**Chain**: Tested Code Generator

**Stage 1**: Generate Code
- Prompt: "Generate [component] with [requirements]"
- Output: Code file(s)
- Validation: Valid syntax, includes all required functions

**Stage 2**: Code Review
- Input: Code from Stage 1
- Prompt: "Review code for bugs, performance issues, best practices"
- Output: Review findings (JSON)
- Validation: Categorized by severity

**Stage 3**: Apply Fixes
- Input: Code and Review findings
- Prompt: "Fix high and medium severity issues"
- Output: Revised code
- Validation: Addresses all high-severity issues

**Stage 4**: Generate Tests
- Input: Final code
- Prompt: "Generate unit tests with >80% coverage"
- Output: Test file(s)
- Validation: Tests run and pass

**Stage 5**: Verify
- Input: Code and tests
- Action: Run tests
- Output: Test results
- Validation: All tests pass

内容创作链

**Chain**: Blog Post Creator

**Stage 1**: Research & Ideation
- Prompt: "Research [topic] and generate 5 article angles"
- Output: List of angles with brief descriptions

**Stage 2**: Select & Outline
- Input: Angles from Stage 1
- Prompt: "Select best angle and create detailed outline"
- Output: Article outline

**Stage 3**: Draft Content
- Input: Outline from Stage 2
- Prompt: "Write full article following outline"
- Output: Article draft (markdown)

**Stage 4**: Edit & Polish
- Input: Draft from Stage 3
- Prompt: "Edit for clarity, flow, grammar, and engagement"
- Output: Polished article

**Stage 5**: Generate Metadata
- Input: Article from Stage 4
- Prompt: "Generate title variations, meta description, tags"
- Output: SEO metadata

**Stage 6**: Format for Platform
- Input: Article and metadata
- Prompt: "Format for [CMS] with proper structure"
- Output: Platform-ready post

调试链

链运行失败时：

1. 隔离阶段：单独运行失败的阶段
2. 检查输入：确认传递给阶段的数据有效
3. 检查输出：查看阶段实际生成的内容
4. 审查提示词：是否清晰且可实现？
5. 测试验证：验证规则是否合适？
6. 检查上下文：阶段是否具备所需信息？
7. 查看日志：执行过程中发生了什么？

监控链路健康状况

跟踪以下指标：

• 成功率：成功完成的链路占比
• 阶段失败率：哪些阶段最常失败？
• 执行时间：链路需要多长时间？
• Token 用量：每次链路执行的成本
• 重试率：阶段需要重试的频率
• 质量评分：最终输出的质量如何？