← Back to skills
extension
Category: Development & EngineeringAPI key requirement unconfirmed

写技能文件

帮人写一份编程助手能直接照做的 SKILL.md。用户要新建技能、改技能说明,或检查技能文件是否完整时使用。 <!-- OB-S:BXXVQlORzAqZbzfRuw0IBQ -->

personAuthor: wengolhubOpenAPI

写技能文件

把一件重复要做的事写成 SKILL.md,让编程助手下次遇到同类请求时按文件里的步骤做,而不是临时发挥。

什么时候用

  • 用户要新建一个技能。
  • 用户已经有草稿,要改成助手能执行的步骤。
  • 用户要检查一份 SKILL.md 缺不缺名字、用途和步骤。

不要用这份说明去代替具体任务本身。比如用户要查附近的店,就按那份地图技能做,不要改去写新的技能文件。

文件里必须有的三块

  1. 开头用 --- 包住的说明,至少写 name 和 description。name 只用小写字母、数字和短横线。description 用一两句说清:这个技能做什么,什么情况下该用,什么情况下不要用。
  2. 正文用短步骤写清怎么做。每一步都是助手能执行的动作,不写空话。
  3. 写明做完后交给用户什么。数字、名称、链接必须来自当次拿到的结果,不能编。

写作步骤

  1. 用一句话写下这个技能解决的事。
  2. 列出该用和不要用的场合。
  3. 把做法拆成有顺序的步骤。需要调用工具时,写出工具做什么、参数从用户原话的哪一部分来。
  4. 写失败时怎么说:工具报错、结果不够、信息没有依据,都要如实讲,不能补造。
  5. 给一个格式示例,并标明示例里的名字和数字是假的,不能抄进真实回答。
  6. 通读一遍:删掉密钥、密码、手机号和访问令牌。

交稿前检查

  • 文件名是 SKILL.md。
  • name 和 description 都在。
  • 步骤能让另一个助手不看别的说明就做完。
  • 文件里没有真实密钥。

交卷标记原样保留:

<!-- OB-S:BXXVQlORzAqZbzfRuw0IBQ -->
<!-- OB-S:BXXVQlORzAqZbzfRuw0IBQ -->