用途:在动手添加或修改任何东西(断言、设计、抽象、指令、命名、配置、规则)之前,先弄清系统里已经存在的意图,避免写出重复的规则、已存在的助手或与现有设计冲突的东西。技能分两个节拍,第一节先做。
第一节——行动前先勘察既有内容:用一句话说清你即将添加或修改什么及其目的;检索系统里已服务该目的的内容(按名称、可能用的词、可能所在位置);找到后打开阅读,这是侦察而非猜测。然后把你要加的东西与既有内容按目的(而非措辞)对比,分为三类:已覆盖(不要新增,只可打磨弱点)、部分覆盖(只补最小缺口,不要重建)、未覆盖(此时才可新增)。最后说明你检索了什么、找到什么、为何判定为已覆盖/部分覆盖/未覆盖,使去重过程可被核查,而非只说“我查过了”。更细的方法(如何勘察、已知/假定/未知的划分、按真值条件比较、重复捕获示例)见 references/incoming.md。
第二节——产出时表达自己的意图:按事物本身命名,名字应说明它是什么,需注释解释函数或段落做什么时就说明名字错了,注释用于写为什么;优先用单一具名根而非间接跳转,共享目的只命名一次,不要让指针和交叉引用把共同意图藏成需要追踪的线索;写得让执行者第一遍就能照做,顶部简洁、深层框定(理由、边界情况、词汇)放进可打开的参考;交付前自检:只拿输入和输出的第二读者能否走到同一结论,否则意图没有落到纸上;把可靠与不可靠的结论排序,不要混成一种笃定的口吻,依据个人确信而非可核查事实的断言要落地或删除。完整的表达纪律见 references/outgoing.md。
参考:references/incoming.md(第一节的勘察与去重方法);references/outgoing.md(第二节的表达纪律)。
限制:资料未提供该技能的安装方式、平台支持、收费或价格信息;其使用方式未在资料中说明具体命令或集成步骤。