这是面向“模型所读文本”的写作技能。模型指令指一切被模型读取以决定行为的文本:系统提示词、工具名称与描述、参数描述、工具返回文本、AGENTS.md 或其他指引文件、技能描述与正文、提示词模板。模型把它们与对话一起读入,注意力有限,每行都在竞争注意力,不改变行为的文字仍消耗注意力。目标是行为而非文笔:在覆盖范围内可靠地产生预期行为,并用最少文字做到。
主要原则:清晰直接,点明情境、行为与边界,先定义术语;弱例为“小心处理 git 操作”,清晰写法是“任何重写已发布历史的 git 命令(如 push --force 或修改已推送提交)前先询问;本地可逆命令直接运行”。先删后加,指令只会膨胀,先看已有覆盖该情境的文字能否删除、锐化或移动。针对一般行为而非单一事件,如把“用户问 Stripe webhook 重试设置时先读 config/stripe.ts”改为“回答配置问题前先读定义它的文件”。说该做什么,仅当模型确实会做时才写禁止。必要时给出理由以便泛化。校准强度:慎用 MUST、NEVER、ALWAYS 与“如有疑问就做 X”,避免过度触发。每条规则只放一处,避免矛盾。示例要有意使用,且真实、多样、明确标注。按模型阅读顺序组织:是什么、何时行动、如何行动、各情形下设置什么,最后示例。
放置位置分层次:系统提示词放适用于该模式每个任务的一般行为与规则,始终在上下文中,最昂贵;技能放偶发需要且无帮助会出错的能力,按任务匹配加载,可容纳细节与示例;AGENTS.md 放某仓库或目录特有、模型无法从代码推断的事实与规则;工具描述说明何时调用、如何调用、返回什么,不涉及更广任务。判断标准:是否适用于该模式所有任务;是否适用于本仓库之外。
写作流程从观察到的行为开始,一例是轶事、两例是信号、三例是模式;先读已有指令找可删或可锐化处,再决定是否新增及放在哪里;写最小改动。评审时对照上述原则。原文提到可提供 eval,但未经明确批准不得运行;计划需说明动机正例、负对照、模型、线程数(默认最多 12)与未覆盖内容,并使用真实智能体、真实系统提示词与工具,线程保持临时,报告新旧文本逐例通过率;“读起来更好”不算结果。原文未提供安装命令、收费、价格或平台信息。