资源

Agent 设计检查清单

把 Agent 放进生产流程之前逐项确认

使用方式

在把一个 Agent 接入会影响后续流程的位置之前逐项确认。★ 任何一项答"还没想清楚", 就先不要接入——这份清单的价值在于它给出一个可以说"不"的依据。

目标

  • 目标写成了可判定的形式 (拿一次真实运行能判定成败)?
  • 写了非目标清单?
  • 目标不是能力描述 (如"帮助用户分析数据")?

角色

  • 每一项外部动作被明确允许或明确禁止, 没有留白?
  • 遇到边界外的请求时的处置方式已定义?
  • ★ 确认没有采用"没写禁止即允许"的默认?

输入

  • 必填项与可选项已区分?
  • 每个必填项都定义了缺失时的行为 (报错 / 询问 / 降级)?
  • ★ 显式禁止推断补全 ("缺失即标注缺失")?

推理

  • 拆成了有留痕的多步, 而非单次调用?
  • 任一输出能还原到它所依据的输入片段与中间判断?
  • 中间产物是可读的, 而不只是可存的?

输出

  • 成功结构已定义?
  • 失败结构已定义 (失败类型 / 缺什么 / 建议下一步)?
  • 下游能用程序判定结果是否可用, 而不需要人读一遍?

评测

  • 存在评测集?
  • 有基线成绩?
  • ★ 能判断一次改动是变好还是变坏? 若不能, 上面五项写得再全也无法维护。