用途:这是一个 SKILL.md 标准模板,新建技能时以此为基底编写,定义了技能写作指南与必需章节结构。触发场景包括“想创建新技能”“技能模板”“SKILL.md 模板”“技能编写方法”等请求。
主要能力与结构:
- Frontmatter 模式:name(必填,小写连字符,如 doc-docx)与 description(必填,写目的加触发关键词,并列出触发语句)。默认不使用 user-invocable:设为 true 时桌面应用会把该技能归为“命令”而非“技能”,导致从插件技能数中排除;若插件只有一个技能,会显示为 0 个技能。已发布的 224 个技能中 214 个未使用该字段且正常工作。如需斜杠入口,改为创建 commands/<名称>.md 文件,这是 Claude Cowork 的正式路径。
- 禁止字段(v1.3.0 政策):metadata 块(version、status、updated、tags)、非标准 keywords、正文顶部的版本横幅。
- 正文必备章节顺序:标题与一行摘要、归属行、概述(2-4 句,含解决的问题、使用者与使用时机)、触发关键词(空格分隔)、工作流(编号步骤)、执行规则(含条件/动作表格)、使用示例(至少 2 个可复制提示)、输出格式(表格说明产物与格式)、注意事项(限制与替代技能)、相关技能(before/after/alternative 关系)。所有章节均为必填,不适用时保留标题并标注“不适用”。
- 复杂度分层:Simple(少于 50 行,含概述、触发、工作流与 1 个示例,自检);Standard(50-150 行,全部章节加 2 个示例,自检加建议同级评审);Complex(150 行以上,全部章节、3 个示例与测试用例,自检加强制同级评审)。
- 质量检查清单:确认 frontmatter 含 name、description;无 metadata 块;全部必填章节存在;示例数量达标;触发关键词不与其它技能重复;工作流步骤可按顺序执行;相关技能需标注 before/after/alternative 关系。
限制:资料仅规定模板与写作规范,未提供安装命令、定价或运行平台信息,这些暂未提供。来源为 revfactory/harness skill-writing-guide(Apache 2.0)的 MoAI 适配版。