写给 Agent 应用工程师。案例是这个仓库的
docs/runbook/:一条自动抄录与 Claude Code 的每一轮交互、再提炼成三份签入文档的管线。这篇讲三件事:它值在哪、怎么做的、以及 那份「提炼契约」里有哪些可以直接抄走的规矩。
先说结论
这套 runbook 最大的价值不是「有了历史记录」—— 那部分靠会话 transcript 本来就有, 不用额外做任何事。它干的是一件更特殊的活:把「为什么现在的代码是现在这样」从某个 人的脑子里搬到版本库里,并且用机器去逼它对齐提交历史。
CLAUDE.md 自己写着这条链路的痛苦:「改动前先知道为什么是现在这样,否则很容易改回去」。
这个仓库改回去的代价特别高 —— 它有一串静默失败模式:eval 的 answer 闸门一旦放宽,
分数一夜之间虚高接近满分;泄漏闸门漏扫中文路径,整片文档静默地不在检查范围内;
--flatten 丢一个标记位,防自环就失效。每一条都是「当时为什么这么写」一旦丢了,
就会被「顺手改回正常」重新放出来的东西。而这些为什么大概率不在代码里,也不在任何
issue 里。