parthh01/sphinx

解決する問題

エージェント支援開発では、人間のオペレーターが完全に理解していないコードが生成される可能性があります。Sphinx は、プッシュワークフローに理解チェックを追加します。保護されたブランチにプッシュすると、Git は一時停止し、変更が何をするかを予測するよう求めます。何かを見逃した場合は、説明し、新しいシナリオを提供します。合格すると、プッシュは続行されます。あなたまたはコーディングエージェントがプッシュを実行したかどうかに関係なく機能し、インストール後はマシン上のすべてのリポジトリに適用されます。

仕組み

Sphinx は、設定したブランチ（デフォルト：main と master）へのプッシュでトリガーされるグローバル Git フック（core.hooksPath）をインストールします。別のレビューモデルが、読み取り専用の 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 で最近のスキップを表示し、モデル呼び出しを制限したり、プリセットでモデルを切り替えたりできます。