Agent Skills · 人工智能

先把流程跑通

适合沉淀的任务应有明确场景、输入、输出和可验证的完成标准。不要把一次失败或临时猜测直接写成长期规范。

这个任务以后会重复做。
请先总结适用场景、输入材料、执行步骤、输出格式、检查清单和常见错误。
暂时不要创建 Skill 文件。

区分需要保存的东西

它们可以互相引用,不需要把全部历史对话复制进 SKILL.md。

创建步骤

  1. 写清什么时候使用、什么时候不用,关键触发词放在描述前部。
  2. 固定输入材料、目标对象、输出格式和成功标准。
  3. 把步骤写成可执行动作,说明缺信息、权限不足或检查失败时怎么处理。
  4. 提取稳定流程;长文、命令参考和案例放 references,确定性的操作按需要放 scripts。
  5. 用正常任务、边界任务和不应触发的任务试用,检查是否选对 Skill 和是否得到正确输出。
  6. 根据结果迭代,再决定是否分发给团队。

最小结构

my-skill/
  SKILL.md
  references/
  scripts/
  assets/
---
name: summarize-feedback
description: 当用户需要将客户反馈整理为主题、问题与行动建议时使用;不用于直接回复客户。
---
## 输入
客户反馈、产品背景和输出用途。
## 步骤
1. 读取材料,标记来源和缺失信息。
2. 按主题归类,区分事实、建议和待确认项。
3. 输出问题、证据与下一步。
## 验证
核对引用来源、重复项和未覆盖的信息。