静的スキーマ linting
スキーマをプロバイダー固有の制約面に照らして検証し、違反を正確な JSON Pointer パス、違反したキーワード、理由とともに報告します。
schemafit
schemafit は、JSON Schema、structured-output 仕様、tool 定義を主要 LLM プロバイダーの制約に照らして検証するローカルファーストの CLI。CI で問題を事前に検出します。
概要
schemafit は、主要な LLM プロバイダーの制約面に対して structured-output、JSON Schema、tool-definition のペイロードをチェックするローカルファーストの CLI です。このページでは、プロバイダー固有のスキーマ不具合が本番に到達する前に検出する方法として紹介されています。
API の 400 エラーを待つ代わりに、schemafit は違反ごとに正確な JSON Pointer のパス、キーワード、理由を示し、その後非 0 で終了するため CI で変更を失敗させられます。また、ベストエフォートの修復パス、プロバイダー一覧コマンド、静的ルールパックが現在のプロバイダードキュメントから乖離していないかを確認する任意の live-verify モードも提供します。
機能
バージョン管理されたルールパック
プロバイダーのルールを宣言的でバージョン管理されたパックとしてエンコードするため、検査内容はレビュー可能で、場当たり的なロジックではなく文書化された制約に結び付いています。
CI 強制と SARIF 出力
非 0 の終了コードで失敗し、SARIF を出力できるため、違反が CI を失敗させ、GitHub のコードスキャンに表示されます。
ローカルファーストのオフライン動作
API キー不要、モデル呼び出しなし、ランタイム依存関係ゼロでオフライン実行できるため、ベンダリングや監査が容易です。
スキーマ修復パス
問題のあるキーワードを削除または書き換えて、プロバイダー準拠のベストエフォート版を出力する repair コマンドを備えています。
プロバイダー一覧とドリフト検出
providers コマンドと、静的パックをプロバイダーのドキュメントと比較してドリフトを検出するための任意の live-verify モードを提供します。
ユースケース
マージ前のスキーマ検証
ビルドパイプラインで schemafit を使い、対象プロバイダーで 400 エラーになるスキーマを検出して、壊れたスキーマが出荷される前に pull request を失敗させます。
マルチプロバイダーのスキーマ保守
複数の LLM ベンダーをサポートする際に、一連のスキーマに対して linting を実行し、プロバイダー固有のキーワード競合を早期に見つけます。
ベストエフォートのスキーマ修復
特定の API 面に合わせてスキーマを適応させる必要がある場合に、repair コマンドを使ってプロバイダー準拠版を生成します。
コードスキャンのワークフロー
スキーマ違反を GitHub の code scanning または Security タブに表示したい場合に、SARIF 出力を生成します。
オフライン検証
コアワークフローがオフラインでキー不要のため、ネットワーク制限のある環境で新規クローンから demo または lint コマンドを実行します。
Pros and Cons
Pros
- API キー、モデル呼び出し、ランタイム依存関係なしにローカルで実行できます。
- 1 つのスキーマ linting ワークフローから複数の主要プロバイダーを対象にできます。
- 失敗した正確なパス、キーワード、理由を明示するため、デバッグがより直接的になります。
- 不正なスキーマが本番に到達する前に CI を失敗させられます。
- コードスキャンのワークフロー向けの SARIF 出力と、任意の live-verify ドリフトチェックを提供します。
Cons
- ソースには、CLI が静的かつオフラインであること以外の、完全な対応マトリクス、インストールマトリクス、プラットフォーム制限は示されていません。
- repair パスはベストエフォートとして説明されているため、すべてのスキーマに対して完全または意味的に完璧な修正を必ず生成できるわけではありません。
FAQ
schemafit は何をしますか？
OpenAI、Anthropic、Gemini、Mistral、Cohere の公開された制約面に対してスキーマを検証する、ローカルファーストの CLI です。ソースでは、lint、repair、対応プロバイダー一覧の表示、ヘルメット的なデモの実行用コマンドが説明されています。
schemafit に API キーやモデル呼び出しは必要ですか？
ソースによると、これは静的かつオフラインで動作し、API キーは不要で、ランタイム依存関係もありません。新規クローンから、または 1 回の pip install の後に実行できます。
schemafit は CI で使えますか？
はい。製品説明では、lint は非 0 の終了コードで終了するため、スキーマが本番に到達する前に CI でビルドを失敗させられるとされています。また、GitHub のコードスキャンと Security タブ向けの SARIF 出力にも触れています。
schemafit はどのプロバイダーをカバーしていますか？
ページには、OpenAI、Anthropic、Gemini、Mistral、Cohere が対応プロバイダーとして明記されています。さらに、プロバイダーのルールパックはバージョン管理され、公開された制約に基づいていると説明されています。
schemafit は問題の報告だけですか、それともスキーマの修復もできますか？
ページでは、repair パスが、問題のあるキーワードを削除または書き換えながら意図の保持を試み、スキーマのベストエフォートなプロバイダー準拠版を出力できるとされています。また、v0.5 ではドリフト検出のための任意の live-verify モードにも言及しています。
Quick Facts
- カテゴリ
- 開発者ツール
- 製品タイプ
- CLI
- ライセンス
- MIT
- 動作
- 静的、オフライン
- 対応プロバイダー
- OpenAI, Anthropic, Gemini, Mistral, Cohere
- ソースドメイン
- danmercede.com
schemafitの代替品
ByteAsk
ByteAskは、C/C++向けのターミナル起点AIコーディングエージェント。リポジトリを編集し、コンパイラやデバッガ、サニタイザ、テストで変更を検証してから差分を表示。無料枠あり。
Manta AI
Manta AIは、URLからアプリの挙動を把握し、回帰を検出し、スクリプトやセレクタ管理なしでテストを生成できる自律型Webアプリテストツールです。
CreateOS Sandbox
CreateOS Sandboxは、FirecrackerマイクロVM上でコードやエージェントのワークロードを実行できる分離型コンピュート環境です。SDK、CLI、MCPで制御可能。
hob
hobは、エージェントのセッション、ターミナル、履歴、後続作業を、既存のツールやプロバイダーに合わせて整理できる独立したコーディングエージェント向けワークスペース。ローカルでの制御を重視する開発者に最適。
Ably Chat
Ably Chatは、カスタムのリアルタイムチャットアプリを構築できるチャットAPIプラットフォームです。ルーム単位のメッセージ、入力中表示、プレゼンス、リアクション、メッセージ更新に対応し、利用量ベースの料金も選べます。
SonOf
SonOfは、リポジトリとPMツールに接続し、コードベースと周辺の製品コンテキストを監査して、承認済みの作業をシニアエンジニアのレビュー付きで公開済みチケットに変えます。