https://hugozhu.site/tags/runbook/Recent content in Runbook on All about Raspberry PiHugoenFri, 04 Sep 2026 00:00:00 +0000https://hugozhu.site/post/2026/388-runbook-write-why-into-repo/Fri, 04 Sep 2026 00:00:00 +0000https://hugozhu.site/post/2026/388-runbook-write-why-into-repo/<blockquote> <p>写给 Agent 应用工程师。案例是这个仓库的 <code>docs/runbook/</code>：一条自动抄录与 Claude Code 的每一轮交互、再提炼成三份签入文档的管线。这篇讲三件事：它值在哪、怎么做的、以及 那份「提炼契约」里有哪些可以直接抄走的规矩。</p> </blockquote> <h2 id="先说结论">先说结论</h2> <p>这套 runbook 最大的价值不是「有了历史记录」—— 那部分靠会话 transcript 本来就有， 不用额外做任何事。它干的是一件更特殊的活：<strong>把「为什么现在的代码是现在这样」从某个 人的脑子里搬到版本库里，并且用机器去逼它对齐提交历史。</strong></p> <p>CLAUDE.md 自己写着这条链路的痛苦：「改动前先知道为什么是现在这样，否则很容易改回去」。 这个仓库改回去的代价特别高 —— 它有一串静默失败模式：eval 的 answer 闸门一旦放宽， 分数一夜之间虚高接近满分；泄漏闸门漏扫中文路径，整片文档静默地不在检查范围内； <code>--flatten</code> 丢一个标记位，防自环就失效。每一条都是「当时为什么这么写」一旦丢了， 就会被「顺手改回正常」重新放出来的东西。而这些为什么大概率不在代码里，也不在任何 issue 里。</p> <p><a href="https://hugozhu.site/img/2026/runbook-write-why-into-repo.png"><img src="https://hugozhu.site/img/2026/runbook-write-why-into-repo-thumb.jpg" alt="Write the Why into the Repo — A Self-Auditing Runbook Pipeline"></a></p>