用途:指导编写或重构 SKILL.md 正文,让模型在有限注意力下先读到最关键内容,再按需深入。适用于新写技能、精简臃肿技能、把庞大技能拆分为多个聚焦技能,以及发布前的质量审查。
主要能力:给出推荐的结构顺序——frontmatter、一行加粗摘要、When to Use 列表、核心概念(不超过 5 句)、最小示例、深入模式与变体、反模式、最佳实践编号列表;模型自上而下阅读,每节都应有存在价值。提供各节写法要求:开头一句话说清价值;When to Use 用 3-6 条具体场景;核心概念最多 5 句,超出说明应拆分;最小示例只保留技能特有代码,去掉读者已知的样板;深入模式每项一段加一小段代码;反模式与最佳实践用编号列表,写成可执行的祈使句。
篇幅与拆分:快速参考类 80-150 行,概念加工作流类 150-300 行,深度内容 300-500 行且优先拆分;超过 500 行通常意味着应拆成两三个技能。拆分信号包括需要目录导航、读者只关心一半、存在两类受众或两套工作流;可按生命周期、角色或难度拆分。跨技能引用用名称链接,不重复内容。
代码与取舍:示例要真实可运行、最小化、每块只讲一个概念、注释仅用于非显然处。不要写功能历史、营销话术、所有边界情况、模型已知的常识和冗长 API 参数表。
限制:资料未提供具体工具、平台、收费或安装命令信息;上述为写作规范,非可执行工具。