浏览 AI 知识库
SKILL.md 怎么写名称、说明、触发条件和工作流程
SKILL.md 的名称和说明要让 Agent 判断何时使用、何时不要使用；工作流还要写清输入、动作、验证和停止条件，不能只说“帮助处理内容”。
沿完整工作流推进
前一阶段的可检查结果，是下一阶段的输入；中间证据不足时停在当前阶段。
“帮助用户处理内容”为什么会让一个 Skill 到处误触发
SKILL.md 描述写“帮助用户处理内容”，范围太宽；任何写作、表格甚至代码请求都可能触发，输出也没有完成标准。
- 名称与描述直接说明边界
- 工作流和禁止动作完整
- 正反例触发符合预期
先确认这次任务的起点、边界和交付
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | 目标 Skill 只把已核验文章打包为微信公众号草稿，不负责发布；已有固定浏览器流程和终检。 |
| 不能越过的边界 | 名称直接，description 写清触发与不触发；正文按实际工作流；发布、群发和不可逆账号操作明确禁止。 |
| 要交付的结果 | 可触发的最小 `SKILL.md` |
从“名称和说明”走到“验收与测试”
| 当前阶段 | 实际处理 |
|---|---|
| 名称和说明 | 名称对应稳定能力，说明覆盖应触发的真实请求、关键文件或对象，并暗含不适用边界。 |
| 输入契约 | 列必需材料、版本、权限和用户决定，缺失时提问或停止，不自行补。 |
| 工作流程 | 按实际依赖写动作，工具调用和人工确认明确，优先复用脚本与模板。 |
| 风险和停止 | 删除、发布、付款、外发、生产写入和秘密处理单独规定，不能埋在普通步骤。 |
| 验收与测试 | 定义可观察结果，准备正例、反例、缺材料和越界用例。 |
把‘处理商品图片’写成能触发和停止的说明
领域太宽，无法测试边界
用于图片、设计、营销和商品内容等相关任务。
对象、交付和不适用场景可验证
当用户要求检查一批商品图片的尺寸、命名、色彩空间并输出报告时使用。只问创意、要求自动覆盖原图、缺少图片目录或需要发布素材时不适用；缺材料或发现写入请求时停止并说明。
示例只展示 description 和边界写法，完整 Skill 仍需补输入契约、工具、脚本、风险和验收。
完成后的可触发的最小 `SKILL.md`
最小 SKILL.md 的描述包含“公众号草稿、标题/摘要/正文/封面更新”，并明确仅保存草稿、不发布。工作流覆盖登录态检查、编辑、移动预览、回读和保存证据；普通文章改写不会触发。
为什么“描述清楚，输出仍不稳定”还不能交付
描述清楚，输出仍不稳定
- 原因
- 步骤缺输入格式、失败分支或验证
- 怎么改
- 为每一步补可观察结果和停止条件，用固定任务回归