Sphinx 把 git push 卡住，直到你能解释 agent 写了什么：第一个做成 Git 钩子的理解门
周日一条 Show HN 拿了 235 分、77 条评论，工具只干一件事：你往受保护分支 push 的时候，Git 停下来，一个审稿模型问你这个改动在出错时会怎样。答对，push 继续；答错，它解释你漏了什么，再给你一个新场景。Sphinx 作者是 parthh01，仓库 10 月 14 日建的，周日晚上 98 颗星，MIT 协议，npm install -g sphinx-understand 再 sphinx install 就装好。README 上的口号是一句假托孙子的玩笑：思考可以外包，理解不能。
设计选择才是重点。审稿模型永远看不到产出这段代码的对话，它通过只读 Git 工具读提交的 diff，所以它考你的是产物本身，不是 agent 告诉你它干了什么。问题关于行为、失败模式和不变量，不问文件名。README 的例子是一个后台任务队列：worker 提交了操作但在确认任务之前崩了，重新投递后操作会不会执行两次？考试是开卷的，你可以读代码，也可以让 agent 边讲边答。审稿跑在你现有的 Claude Code 或 Codex 套餐、OpenRouter 或任何 OpenAI 兼容端点上，没有托管服务。不管是你还是编码 agent 执行的 push 都一样，意味着自动驾驶的 agent 也会被同一道门拦下。给诚实的人留了后门：sphinx yolo 直接放行，但每次跳过都记日志，你绕过自己理解的频率有据可查。
注意事项也写在 README 里，这对一个第一天的项目来说很少见。它设置的是全局 core.hooksPath，所以装上以后机器上每个仓库都生效，除非逐个仓库跑 sphinx init。匹配的 push 最多阻塞 25 分钟，你的编码 agent 的 shell 可能先超时。改动的代码、你的答案和一个上下文文件会发给你选的审稿供应商；.env、密钥和常见凭证路径默认排除，但粘进普通源码里的密钥抓不到。不支持原生 Windows。
为什么这个东西比它的星数重要。过去一个月攒了一摞说同一件事的文章：Simon Willison 的别当肉身代理，Brain Sandwich 说你的脑子要在 AI 前后各来一次，Pensieve，你还是得思考，这周 Linear 的 Karri Saarinen 又写每个人操作一座小软件工厂，产品就成了所有产出的平均值。那些是论点。Sphinx 是第一个执行。它和 Claude Code 团队的审稿循环、Postgres 因为 AI 审稿找出的问题多到人修不完而推迟发布坐在同一格里，区别是它把门设在人身上而不是代码上。Anthropic 自己的员工数据说读 Claude 的输出已经占掉大半个工作周，一个逼你证明自己读过的钩子是这份工作最便宜的版本。人们过了第一次 25 分钟阻塞之后还留不留它，才是真正的测试，yolo 日志会告诉他们答案。
链接：https://github.com/parthh01/sphinx ，https://sphinx-six-theta.vercel.app/ ，https://news.ycombinator.com/item?id=50137950 ，https://karrisaarinen.com/posts/someone-behind-the-software/ ，https://terriblesoftware.org/2026/10/02/the-brain-sandwich/
← 返回所有文章
设计选择才是重点。审稿模型永远看不到产出这段代码的对话，它通过只读 Git 工具读提交的 diff，所以它考你的是产物本身，不是 agent 告诉你它干了什么。问题关于行为、失败模式和不变量，不问文件名。README 的例子是一个后台任务队列：worker 提交了操作但在确认任务之前崩了，重新投递后操作会不会执行两次？考试是开卷的，你可以读代码，也可以让 agent 边讲边答。审稿跑在你现有的 Claude Code 或 Codex 套餐、OpenRouter 或任何 OpenAI 兼容端点上，没有托管服务。不管是你还是编码 agent 执行的 push 都一样，意味着自动驾驶的 agent 也会被同一道门拦下。给诚实的人留了后门：sphinx yolo 直接放行，但每次跳过都记日志，你绕过自己理解的频率有据可查。
注意事项也写在 README 里，这对一个第一天的项目来说很少见。它设置的是全局 core.hooksPath，所以装上以后机器上每个仓库都生效，除非逐个仓库跑 sphinx init。匹配的 push 最多阻塞 25 分钟，你的编码 agent 的 shell 可能先超时。改动的代码、你的答案和一个上下文文件会发给你选的审稿供应商；.env、密钥和常见凭证路径默认排除，但粘进普通源码里的密钥抓不到。不支持原生 Windows。
为什么这个东西比它的星数重要。过去一个月攒了一摞说同一件事的文章：Simon Willison 的别当肉身代理，Brain Sandwich 说你的脑子要在 AI 前后各来一次，Pensieve，你还是得思考，这周 Linear 的 Karri Saarinen 又写每个人操作一座小软件工厂，产品就成了所有产出的平均值。那些是论点。Sphinx 是第一个执行。它和 Claude Code 团队的审稿循环、Postgres 因为 AI 审稿找出的问题多到人修不完而推迟发布坐在同一格里，区别是它把门设在人身上而不是代码上。Anthropic 自己的员工数据说读 Claude 的输出已经占掉大半个工作周，一个逼你证明自己读过的钩子是这份工作最便宜的版本。人们过了第一次 25 分钟阻塞之后还留不留它，才是真正的测试，yolo 日志会告诉他们答案。
链接：https://github.com/parthh01/sphinx ，https://sphinx-six-theta.vercel.app/ ，https://news.ycombinator.com/item?id=50137950 ，https://karrisaarinen.com/posts/someone-behind-the-software/ ，https://terriblesoftware.org/2026/10/02/the-brain-sandwich/
评论