SKILL.md 怎么写名称、说明、触发条件和工作流程

SKILL.md 先写清什么时候应该用

名称简洁，description 用用户会说的任务、对象和交付描述触发边界；正文再规定输入、步骤、工具、停止和验收。不要把所有参考资料塞进说明。

名称和说明

名称对应稳定能力，说明覆盖应触发的真实请求、关键文件或对象，并暗含不适用边界。

记录客户端版本、Skill 版本、触发输入、实际步骤、工具调用和输出，正例与反例都要保留。

输入契约

列必需材料、版本、权限和用户决定，缺失时提问或停止，不自行补。

确认“输入契约”已经有可回查结果，再进入“工作流程”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

工作流程

按实际依赖写动作，工具调用和人工确认明确，优先复用脚本与模板。

确认“工作流程”已经有可回查结果，再进入“风险和停止”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

风险和停止

删除、发布、付款、外发、生产写入和秘密处理单独规定，不能埋在普通步骤。

确认“风险和停止”已经有可回查结果，再进入“验收与测试”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

验收与测试

定义可观察结果，准备正例、反例、缺材料和越界用例。

脚本、网络、凭证和写操作必须在说明中可见；触发边界不清或结果不可验收时不要扩大使用范围。 完成后把证据归入“可触发的最小 `SKILL.md`”。

最小 Skill 要先稳定触发和停止

目录复杂度后加。SKILL.md 在新任务中能触发、按步骤完成、遇到越界停止并产出可验收结果，才算最小可用。