18. writing-great-skills 技能

快速开始

npx skills add mattpocock/skills --skill=writing-great-skills

npx skills update writing-great-skills

源代码

功能说明

writing-great-skills 是你编写和编辑技能时所参照的参考文档——它定义了使一个技能可预测的共享词汇和原则。

一个技能的职责是在一个随机系统中驾驭确定性，所以目标不是每次运行得到相同的输出，而是得到相同的过程。可预测性是根本的美德，每个设计决策都以它为标准来评判——而不是以技能读起来有多巧妙、多完整或多详尽为标准。

何时使用

你通过输入 /writing-great-skills 来调用它——智能体不会主动使用它。

每当你正在编写一个新技能或编辑一个现有技能，并希望它每次都以相同的方式运行时，使用它：决定调用模式、编写描述、选择什么放在 SKILL.md 中什么放在链接文件中、或诊断一个技能为什么不能正常工作。

认知负荷

整个参考文档所围绕的核心概念是认知负荷——以及它的对应物上下文负荷。每个技能消耗其中一种：

• 模型主动调用的技能每次轮次都会在窗口中保留一段描述，因此它消耗上下文负荷，但能自动触发。

• 用户主动调用的技能会移除那段描述；它消耗零上下文负荷，但现在你就是那个需要记住它存在的索引——这就是认知负荷。

这些技能大多是需要用户主动调用的，这就是为什么认知负荷是整个系统设计来管理的压力：当用户主动调用的技能数量超出你所能记住的范围时，解决方法是使用一个路由器技能来列出其他技能及其各自的使用时机。一旦你开始用这两种负荷来思考，大多数编写决策——拆分还是不拆分、内联还是外露、模型主动调用还是用户主动调用——就成了在不同地方做出的同一种权衡。

其他杠杆

参考文档的其余部分是关于如何有效花费这些负荷的工具包：

• 引导词——一个已经存在于模型预训练中的紧凑概念（如 tight、red、tracer bullet），智能体在运行技能时用它来思考。它以最少的 token 锚定执行和调用；寻找那些可以用单个词替代的重复表述。

• 信息层级——从技能内步骤、到技能内参考、再到上下文指针背后的外部参考的阶梯。渐进式披露就是沿着这个阶梯向下移动，使顶层保持清晰易读。

• 剪枝——单一事实来源、相关性，以及逐句应用的无操作测试，针对沉积和蔓延。

• 故障模式——过早完成、重复、沉积、蔓延、无操作——用于诊断一个行为异常的技能。

在整个流程中的位置

这是一个随时可调用的独立参考文档——你在构建其他技能时查阅的元技能，而不是链条中的一个步骤。它的自然邻居是你维护的任何路由器，因为路由器是治疗用户主动调用技能所积累的认知负荷的直接解药；当你不确定哪个技能或流程适合某个任务时，ask-matt 会帮你导航整个技能集。