Agent Skills：把提示词变成可维护接口

Agent 的能力不应该只藏在一段很长的系统提示词里。只要它需要调用外部工具、处理失败，或者把工作交给另一个 Agent，能力就已经有了接口的性质。

先定义边界，而不是工具名

一个好的 Skill 描述的是「谁可以在什么条件下完成什么」，而不是一串 API 名称。它需要把输入、输出、权限和失败路径说清楚。

type Skill<Result> = {
  canRun(input: unknown): boolean
  execute(input: unknown): Promise<Result>
  recover(error: unknown): "retry" | "ask-user" | "stop"
}

这样做的收益很直接：模型的推理空间更小，调用记录可以审计，工具的实现也可以独立演进。

把不可逆操作留给人

删除、发布、转账之类的操作应该被建模成明确的确认边界。Agent 可以收集证据、生成计划，但不能把「看起来合理」当成授权。

自动化最有价值的地方，不是绕开判断，而是把判断需要的信息准备好。

下一步是为每个 Skill 写下最小的可验证结果。HTTP 200 不是成功；只有目标状态真的改变，才算完成。