用途:编写或修改给智能体看的指令文档,例如 skill 描述、AGENTS.md、CLAUDE.md,以及这些文件指向的说明文档,目标是让智能体每次运行都遵循相同流程。
流程:先读文档、它指向的每处内容,以及文档描述的对应文件与命令;再按下述规则起草或修订;最后逐句对照规则检查,并执行 unslop,所有句子同时通过两部分才算完成。
指针(pointers):指针指常驻上下文中对其他材料的引用,如 skill 描述或 AGENTS.md 中的文档链接,每个字每轮都消耗 token 与注意力。把用户或智能体描述任务时最先说的词放前面;每种不同情况只写一个触发条件,删掉已列出情况的同义词;删掉目标中已有的信息。若智能体跳过必备材料,先改写其指针,改写无效才内联该材料。
放置:每个情况都需要的内容留在主文件,只有部分情况需要的移到单独文件并指过去;把主题的定义、规则与例外放在同一标题下。
完成标准:每个步骤以可核对的完成标准结尾,优先用穷尽边界(如“每个发现都已修复,或已说明理由跳过”),而非模糊表述(如“理解代码”)或形容词(如“要彻底”)。若智能体为赶后续步骤而仓促完成某步,先收紧该步标准;仍仓促,则把该步交给不含后续步骤上下文的新子智能体。
措辞:描述想要的行为而非要避免的行为,硬性护栏才用禁止式;同一概念全篇用同一术语,优先用含义恰好的既有术语(如 YAGNI、tracer bullet),自造术语需定义,写明智能体必须检查的每个条件。
精简:每条规则只出现一处,他处指过去;省略智能体一次查找即可获得的内容,如脚本、配置、目录结构或 --help 输出;写下它查不到的约定、原因与坑。删掉与模型默认行为相比不改变行为的句子,整句删除而非减字;先查历史,为修复已观察到的失败而加的规则,要保留到无该规则的运行不再出现该失败。删除过时或无助于本文档任务的句子。