用途:这是一个撰写 agent 技能的指导型技能,用于在用户想创建、撰写或构建新技能时,给出结构化的编写流程与规范。
主要流程:
- 收集需求:询问用户技能覆盖什么任务/领域、需要处理哪些具体用例、是否需要可执行脚本还是仅指令、是否要包含参考材料。
- 起草技能:创建含简洁指令的 SKILL.md;内容超过 500 行时增加参考文件;需要确定性操作时添加工具脚本。
- 与用户复核:呈现草稿并确认是否覆盖用例、有无遗漏或不清晰之处、某部分是否需要更详细或更简略。
结构约定:目录包含必需的 SKILL.md,以及按需的 REFERENCE.md、EXAMPLES.md 和 scripts/ 工具脚本目录。SKILL.md 模板含 name 与 description 的 front matter,以及快速开始、工作流、高级特性等章节。
description 要求:它是 agent 决定加载哪个技能时唯一看到的内容,会与其他已安装技能的描述一起出现在系统提示中。目标:让 agent 知道该技能提供什么能力、何时/为何触发(具体关键词、上下文、文件类型)。格式:不超过 1024 字符,用第三人称,第一句写功能,第二句写“Use when [具体触发条件]”。
脚本与拆分:操作具确定性(校验、格式化)、同一代码会被反复生成、错误需显式处理时添加脚本,可节省 token 并提升可靠性。SKILL.md 超过 100 行、内容分属不同领域、高级特性很少用到时拆分为单独文件。
复核清单:description 包含触发词;SKILL.md 少于 100 行;无时效性信息;术语一致;含具体示例;引用仅一层深度。
限制:资料未提供更多平台、收费或运行环境信息。