关于 chain
用于设计和验证复杂任务中可靠工具链的 Agent 技能,介绍顺序、并行、条件和迭代结构,并强调数据契约与故障处理。
主要功能
- 01设计四种工具链模式
- 02定义各步骤的输入和输出
- 03检查架构兼容性
- 04规划错误与部分结果处理
- 05设置超时和迭代上限
适用场景
- 01组合相互依赖的工具步骤
- 02并行运行独立步骤并合并结果
- 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