可复制打法·show_hn·18 评论值得深看Show HN:Treedocs,用文件树给人和 agent 维护项目地图↗
Treedocs 把仓库文件树镜像成 `treedocs.yaml`,给目录和文件补描述、引用和链接,并能检查文件移动/删除造成的文档过期。作者明确把它定位为两件事:帮助新人理解陌生仓库,也给 coding agent 提供更短、更稳定的项目上下文。
这条正好命中 agent 工具链的真实痛点:context 不是越多越好,结构化的项目地图比把全仓库塞进 RAG 更实用。可以借鉴到自己的项目:每个模块维护短描述、边界、入口文件和常见任务,配合 CI 检查过期,比让 agent 每次重新 grep 更省 token。
Show HN:Treedocs,用文件树给人和 agent 维护项目地图↗
他认为这种 progressive disclosure 往往比通用 embedding/RAG 更有效,因为 agent 很喜欢目录和索引。
作者说 `treedocs explore` 的挑战在于让 agent 可靠地先用它,而不是默认继续 grep;这说明工具还需要配套 prompt/skill。
他把维护责任交给 LLM:在规则里要求每层维护 INDEX.md,靠 agent 自维护项目地图。