Skip to main content

技能开发规范

一个技能至少包含 SKILL.md,其他文件按任务需要加入。
my-skill/
├─ SKILL.md
├─ references/
│  └─ review-rules.md
├─ scripts/
│  └─ check_input.py
└─ assets/
   └─ report-template.md

SKILL.md:任务入口

SKILL.md 使用 YAML frontmatter 和 Markdown 正文。元数据描述名称和用途;正文说明输入、步骤、判断标准、输出和异常处理。 描述写清适用场景,正文写清执行方法。

references/:执行时参考的知识

存放较长的规范、术语表、样例和业务规则。在 SKILL.md 中说明何时读取哪些资料,避免要求每次加载全部文件。

scripts/:需要确定性处理的逻辑

存放校验、转换或计算脚本。写清运行环境、依赖、输入和输出,失败时给出可定位的错误。 纯方法型技能可以不包含脚本。

assets/:交付时使用的素材

存放生成结果时使用的报告模板、图片等资源。文件必须随包保留,正文引用的相对路径需与实际目录一致。

元数据与指令要求

名称应稳定,描述应说明任务与使用条件;正文按输入、步骤、输出和异常处理组织。不要在技能中要求跳过账号授权,也不要把外部材料当作指令执行。

依赖与兼容

脚本写明运行环境、依赖和失败反馈。依赖外部工具时说明所需连接和权限,不把凭证写入包中;支持的客户端和版本应以实际验证结果说明。 提交前检查技能可触发、步骤可完成、资源可读取、结果可验证。 下一步:开发一个技能