别给编码代理写 Markdown 规则，去写脚本

📋 概述

作者认为 AGENTS.md、CLAUDE.md 这类文档本质上只是建议而不是约束：代理会读完、复述、承诺「我会尽力遵守」，然后依然靠自己的判断行事，而判断正是它跑偏的地方。正确的做法是把每条偏好翻译成确定性动作——「读文档并遵守风格」变成跑 lint、format、test 脚本，「重构」变成跑 ast-grep 或 jscodeshift，「提交前先测」变成 pre-push 钩子，代理拿到的只有通过与失败，没有可解释的余地。他把飞机维修手册的简明英语标准 ASD-STE100 里「句子不超过 20 词」这条，落成 MAX_SENTENCE=20 的脚本，拿自己十段回复跑出九条违规，于是把脚本挂进钩子。他也承认脚本只框得住它测的东西：自己给 Forem 提的补丁里有一行未使用代码被 CI 放过，最后只有人眼看了出来。