parthh01/sphinx

它解决了什么问题

代理辅助开发可能会产生人类操作者不完全理解的代码。Sphinx 在推送工作流中增加了一项理解检查：当你推送到受保护分支时，Git 会暂停并要求你预测你的更改会产生什么效果。如果你遗漏了某些内容，它会解释并给出新的场景。一旦你通过，推送将继续。无论你或编码代理执行推送，它都有效，并且安装后适用于你机器上的每个仓库。

工作原理

Sphinx 安装全局 Git 钩子（core.hooksPath），这些钩子在你配置的分支（默认：main 和 master）上触发推送。一个单独的审查模型通过只读 Git 工具读取已提交的更改——它永远不会看到生成代码的对话。它生成关于行为、失败模式和不变量的问题，而不是文件名或函数名。你在本地浏览器页面（或终端）中回答，并附上预测和简要推理。错误答案会得到解释和新的场景；争议会特殊处理。检查是开卷的：你可以在回答时阅读代码。通过后有效期为 24 小时，同一推送不会再次提问。审查在你的 Claude Code 或 Codex 计划、OpenRouter 或任何兼容 OpenAI 的端点上运行。Sphinx 本身没有托管服务。

适用人群

使用编码代理（Claude Code、Codex、Cursor、OpenCode、Pi 或普通 git push）并希望确保他们理解提交到受保护分支的更改的开发人员。它需要 Node.js 22.19+、Git 和 macOS/Linux/WSL（尚不支持 Windows）。它还假设你有一个审查模型账户（例如，已登录的 Codex 或 Claude Code CLI、OpenRouter 密钥或兼容 OpenAI 的端点）。它旨在作为个人实践工具，而不是安全门。

亮点

• 阻止 Git 直到你通过、暂停或跳过 — 匹配的推送最多等待 25 分钟，你可以稍后恢复。
• 开卷问题涵盖行为和失败模式 — 不是文件名，每个问题旁边都有可浏览的差异和审查者的证据。
• 适用于多种代理和提供商 — Claude Code、Codex、Cursor、OpenCode、Pi、普通 git 以及任何兼容 OpenAI 的端点。
• 每个仓库和全局策略文件 — .sphinxconfig、.sphinxignore 和 .sphinxcontext.md 让你控制分支、问题深度以及审查者可以看到的代码。
• 透明且可控 — sphinx doctor 检查设置，sphinx status 显示最近的跳过，你可以限制模型调用或使用预设切换模型。