把一次成功执行整理成 Skill

一次任务做成功，不等于已经形成能力。真正可复用的 Skill，需要在换人、换输入和换时间后仍然能稳定产出。

从样本开始，不从说明书开始

先保留一份完整的成功执行记录，包括原始输入、关键判断、工具调用、最终交付物和验证结果。同时保留至少一个失败样本，记录错误发生在哪里。

没有样本时编写的 Skill，往往只是在描述理想流程。

区分稳定步骤和临场判断

稳定步骤适合固化，例如读取指定文件、检查必要字段、生成固定格式和运行验证命令。

临场判断需要写成条件，而不是假装它总有唯一答案。例如：

如果内容包含具体数据，必须检查来源日期。
如果来源无法确认，保留“待验证”标记，不得补写推测。

这样的规则说明了何时触发判断，以及无法判断时如何处理。

一个最小 Skill 的五个部分

1. 何时使用：清楚描述触发场景。
2. 输入要求：缺少什么就不能开始。
3. 执行步骤：按依赖顺序排列。
4. 停止条件：遇到哪些情况必须请求确认。
5. 完成证据：用文件、测试或实际结果证明任务完成。

不要把项目事实写死

端口、路径、产品名称和组织角色都可能变化。优先从当前项目配置或权威文档读取，而不是复制进 Skill。只有长期稳定的原则才应该直接写入。

用新样本回归

至少找一个没有参与原始任务的人或 Agent，仅依据 Skill 重新执行。记录它在哪一步需要猜测，然后补充上下文或验证规则。

Skill 的价值不在于文字长，而在于它减少了多少隐含知识和重复判断。