推文

@onionl5236 · 2026-10-14 21:45

用了一整天时间重新重构了一个 holt 项目的整个文档系统，导致晚上面试的时候头都是晕的😫终于把项目里面40+的 adr 文档给清理了，舒服了 文档最终参考了一下 magpie 的那个 subsystem 的设计， AGENTS.md 只回答“什么时候读哪份文档”，不讲具体业务细节，只放指针和触发时机。然后分了14个 subsystem 文档，按照 agent runtime，agent application以及 app 来分层。最重要的是把 40+ adr 融合成了一个大的 decision 文档，然后把简单的架构决策分散在了各个代码中作为注释。 整体重构下来我认为首先初次使用占用 context 肯定是变少了，同时清晰的文档记录也帮助了 bug 定位的速度，目前还没有试过开发新功能的效果。欢迎大家拷打。 https://github.com/Onion-L/holt

曝光 19 · 评论 0 · 点赞 0 · 书签 0 · 曝光/时 3.9961033341471794