使代理编写的代码可审查。当编程代理构建一个功能时，它在过程中做出了一堆小决定，而这些决定你并不真正批准。后来有人审查PR并问“为什么这样做？”而你不知道。答案被埋藏在你笔记本上的聊天记录中，而Claude Code默认在30天后删除那些记录。Grepathy本地读取你的会话记录，提取出决策，并将它们写入一个与代码一起提交的Markdown文件。现在，仓库可以独立回答“为什么”，供审查者、团队成员和未来的代理使用。 npx grepathy init 它是什么样子的 实际示例：在一个合同项目中，我的代理自行决定预创建Clerk中的访客用户。这不在任何计划中。CTO在PR中看到了这一点并问我为什么。我完全不知道，因为我没有做出那个决定。使用Grepathy，这会被记录在仓库中： ### 访客身份在Clerk中预创建 状态：代理启动 - 不在计划或提示中请求 影响文件：` lib/clerk/* ` , ` db/schema/guests.ts ` 代理推断了这种方法，以简化下游身份验证检查。没有讨论的明确理由。 风险：访客用户偏离了正常的注册路径。 审查者关注：确认访客是否应建模为正常用户。 运行grep -rn "agent-initiated" .ai/why/，你会得到一份代理在未咨询任何人情况下做出的每个决定的列表。 它是如何工作的 你不需要运行Grepathy。它自动通过钩子运行： claude # 正常工作，让代理在进行时提交 git push # Grepathy写入原因文件并向你展示以供审查 一些值得注意的事项： 它是事后从记录中工作的。它从不要求代理在任务中“记录其决策”（我们一开始就试过，代理就是不这样做）。每个分支得到一个文件：.ai/why/<branch>.md。 未来的代理实际上会看到这些内容。CLAUDE.md中的一个说明指向它们，并且一个钩子在代理编辑有历史的文件之前注入相关条目。它从不阻止推送，从未接触你的暂存区，也从不自行推送任何内容。它与多个代理和工作树的配合得很好。 未来的代理如何满足原因 - 两个自动触发器，均从提交的原因包中读取，因此代理无需记住去查看： flowchart TD why[("原因包<br/>(.ai/why/, 提交)")] claude["CLAUDE.md指针<br/>每个会话自动加载"] hook["PreToolUse钩子<br/>在编辑之前触发"] claude -->|"为什么 / 解释 / 审查"| read["代理读取<br/>原因包"] hook -->|"编辑的文件匹配影响：通配符"| inject["匹配的条目注入<br/>到代理的上下文中"] why -.-> read why -.-> inject read --> meets["✅ 代理在更改代码之前满足理由"] inject --> meets 加载 没有服务器，没有帐户，没有机器人。它是一个CLI，一些钩子和git中的Markdown文件。 详细信息请见docs/how-it-works.md。 隐私 你的记录从未离开你的机器。唯一共享的内容是Markdown摘要，摘要器遵循严格的规则：它从不引用你的消息，从不描述你的困惑或反复，从不包括商业或财务细节，并且会去除机密信息。提示后面有两个确定性检查（秘密/财务扫描仪和一条规则每个条目必须指向真实代码），然后你在推送之前审查文件。如果你编辑或删除条目，Grepathy会永久尊重这一点。更多详细信息见docs/privacy.md。 它的用途（我们实际上测试过） 我们进行了盲目、预注册的评估，针对诚实的基线，并发布了整个过程，包括该工具失利的部分：docs/REPORT.md。 它的帮助在于：在被删除之前保存推理。Claude Code在30天后丢弃记录。我们自己两个项目在我们甚至可以进行评估之前丢失了整个历史记录。 grepathy init提供回填仍存在的内容。 代码中没有的知识。像“我们考虑过CDN并拒绝了”或“代理自行做了这个，没有人批准”的内容在代码中没有任何痕迹。在我们的测试中，有了原因文件的代理做得很好。没有它的代理则编造了听起来信服的错误答案。 诚实地说，它不帮助的地方： 它不会阻止代理重构重要代码。我们直接测试过这点，它没有。它不会让代理更聪明。如果答案可以从代码中读取，代理会自己找到。Grepathy只对那些别无他处记录的内容重要。 命令 命令 目的 grepathy init 安装钩子和目录。可以安全地重跑。提供回填旧会话的选项。 grepathy status / doctor 健康检查，什么被提炼，什么已过期。 grepathy context <path> 显示适用于文件的条目。 grepathy sync 立即提炼并提交（仍然从不推送）。 grepathy distill / repair / off / on / uninstall 其它命令。--help以获取详细信息。 常见问题 这与Beads和任务跟踪工具有何不同？那些跟踪代理应该做什么。