mcpField
C
chain

chain

github.com/sharpdeveyeAgent 工作流592332 次安装26 周前更新
代码仓库

关于 chain

用于设计和验证复杂任务中可靠工具链的 Agent 技能,介绍顺序、并行、条件和迭代结构,并强调数据契约与故障处理。

主要功能

  1. 01设计四种工具链模式
  2. 02定义各步骤的输入和输出
  3. 03检查架构兼容性
  4. 04规划错误与部分结果处理
  5. 05设置超时和迭代上限

适用场景

  1. 01组合相互依赖的工具步骤
  2. 02并行运行独立步骤并合并结果
  3. 03为工作流添加分支或有界循环

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sharpdeveye/maestro --skill chain

安装后在 Claude Code 中输入/chain确认已加载。

详细介绍

必须准备

调用 /agent-workflow — 其中包含工作流原则、反模式和上下文收集协议。继续之前请遵循该协议 — 如果尚无工作流上下文,必须先运行 /teach-maestro。 请查阅 agent-workflow 技能中的工具编排参考,了解组合模式和错误处理。


设计能够可靠完成复杂工作的工具链。链条的强度取决于其中最薄弱的一环。

链条模式

顺序:A → B → C(每一步都依赖上一步) 并行:[A, B, C] → 合并(独立步骤同时运行) 条件:A →(如果 X,则执行 B,否则执行 C)→ D(根据结果分支) 迭代:A → 检查 →(如果尚未完成)→ 再次执行 A(循环直至收敛)

链条设计流程

对于每条链,定义:

## Chain: [Name]

### Steps
1. [Tool A] — [what it does] — Input: [schema] — Output: [schema]
2. [Tool B] — [what it does] — Input: [output of step 1] — Output: [schema]
3. [Tool C] — [what it does] — Input: [output of step 2] — Output: [schema]

### Data Flow
Step 1 output.field_a → Step 2 input.source_data
Step 2 output.results → Step 3 input.items

### Error Handling
Step 1 failure → [retry 3x, then return error]
Step 2 failure → [return partial results from step 1]
Step 3 failure → [retry with simplified input]

### Constraints
Max total execution time: 60s
Max retries per step: 3
链条验证
  • 已连接步骤之间的数据模式兼容
  • 每个步骤都有错误处理
  • 已设置链条总超时时间
  • 已为循环设置最大迭代次数
  • 已处理部分结果(如果 4 个步骤中的第 2 步失败,该怎么办?)
建议的下一步

构建链条后,运行 /fortify,为每个步骤添加错误处理,然后运行 /evaluate 测试完整流程。

绝不可:

  • 未定义步骤间数据契约就构建链条
  • 创建没有最大迭代次数的循环
  • 跳过任何步骤的错误处理(链条会在最薄弱的一环断开)
  • 假设第 N 步的输出始终是第 N+1 步的有效输入
  • 单个提示词就能完成任务时,仍构建冗长的链条

评论

支持 Markdown