用途:指导创建或更新有效的技能(Skill)。技能是模块化、自包含的包,通过专门知识、工作流和工具扩展智能体能力,相当于特定领域的“上手引导”。
主要能力与内容:说明技能可提供专门工作流、工具集成、领域专长和捆绑资源;强调简洁优先,因为上下文窗口是公共资源,只补充智能体尚不具备的信息,并优先用简洁示例代替冗长解释。提出按任务脆弱性与可变性设置自由度:高自由度用文本指令,中自由度用带参数的伪代码或脚本,低自由度用具体脚本和少量参数。
技能结构:每个技能包含必需的 SKILL.md 和可选捆绑资源。SKILL.md 由 YAML frontmatter(必需 name、description,可选 compatibility 等)和 Markdown 正文组成;只有 name 和 description 会被读取以判断触发时机,因此需清晰完整地说明技能是什么、何时使用。捆绑资源包括 scripts/(可执行代码,适合重复重写或需确定性可靠性的任务)、references/(按需加载的文档,如数据库模式、API 文档、公司政策)、assets/(用于输出而非加载进上下文的模板、图标、字体等)。不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档。
渐进式披露:采用三级加载——元数据始终在上下文(约100词)、SKILL.md 正文在触发时加载(少于5k词)、捆绑资源按需加载。SKILL.md 正文保持精简并少于500行,超出时拆分文件,并从 SKILL.md 明确引用和说明何时读取。给出三种模式:高层指南加引用、按领域或变体组织、条件性细节。引用保持一层深度,长文件加目录。
创建流程:理解技能的具体用例;规划可复用内容(脚本、引用、资产);初始化技能,运行 scripts/init_skill.py <skill-name> --path <output-directory>;编辑技能,先实现可复用资源并实际运行测试脚本,再更新 SKILL.md,正文使用祈使/不定式,description 包含做什么和何时使用;打包技能,运行 scripts/package_skill.py <path/to/skill-folder>,可选指定输出目录,如 scripts/package_skill.py <path/to/skill-folder> ./dist;最后根据真实使用迭代。
限制:资料未提供该技能的收费、价格、平台支持范围或具体效果数据;打包脚本的完整校验细节在资料中被截断,暂未提供。