概要

npx check-ai は、リポジトリを対象に自動で「AIに関する準備状況」を評価するコマンドラインツールです。インストール不要で npx を使って一度に実行でき、合計66件のチェックを実施して総合スコアを算出します。対象はエージェント設定（agent configs）、プロンプトテンプレート、ドキュメントの充実度、テストやセーフティネット、MCP（構成連携）の有無など多岐にわたり、CI パイプラインでの自動化やバッジ発行、改善箇所の発見に役立ちます。Zero-deps をうたう設計は、環境依存を抑え手軽に導入できる点が特徴です。

リポジトリの統計情報

スター数: 23
フォーク数: 2
ウォッチャー数: 23
コミット数: 18
ファイル数: 17
メインの言語: JavaScript

主な特徴

ワンコマンドで実行できるCLI（npx check-ai）、インストール不要・依存ゼロ。
66件の多面的なチェックで「AI準備度」をスコア化し、バッジ化も可能。
リポジトリ内のエージェント設定、プロンプトやドキュメント、テストやCI構成などを横断的に検査。
CIへの組み込みや自動レポート出力（ヒューマン／機械可読）を想定した設計。

技術的なポイント

check-ai は JavaScript で実装された軽量な解析ツールで、依存関係を持たず Node.js の標準API（ファイルシステムやパス操作、ストリーム等）を活用してリポジトリをスキャンします。実行は npx を通じて行う想定で、単一のコマンドで起動し、ファイルパターンや既知の設定ファイル（agent configs、プロンプトテンプレート、.mcp.json 等）を検出してヒューリスティックに評価します。チェックは静的解析ベースが中心で、存在チェック（例：README、CONTRIBUTING、CODE_OF_CONDUCT、CIワークフロー）、構成チェック（エージェントやAPIキーのハードコーディング有無、MCP連携の痕跡）、品質チェック（テストスイート、型チェック、Lint設定）、安全性チェック（シークレットの有無、セキュリティポリシー）やプロンプトの管理状況（テンプレート化、外部化、コメント・説明の有無）など多領域に渡ります。スコアリングは各チェックの重み付けに基づく合成スコアを返し、CIでの失敗判定用にプロセス終了コードを提供する設計が想定されます。出力は人が読めるサマリと、機械処理しやすいJSONやバッジ（SVG）を想定しており、.github ディレクトリ内のワークフローと組み合わせることで PR 時やマージ時に自動評価を走らせられます。Zero-deps設計により環境依存を減らし、シンプルな導入フローと高速な実行を両立している点が技術的な肝です。

プロジェクトの構成

主要なファイルとディレクトリ：

.github: dir
.gitignore: file
.mcp.json: file
.prettierrc: file
.windsurf: dir

…他 12 ファイル

まとめ

ワンコマンドで導入できるAI準備度診断ツール。CI連携で運用しやすい設計。

リポジトリ情報：

名前: check-ai
説明: Audit any repository for AI-readiness.
スター数: 23
言語: JavaScript
URL: https://github.com/f/check-ai
オーナー: f
アバター: https://avatars.githubusercontent.com/u/196477?v=4

READMEの抜粋：

npx check-ai

Audit any repository for AI-readiness.

One command. 66 checks. Zero dependencies. Scans for agent configs, repo hygiene, grounding docs, testing safety nets, prompt templates, MCP integrations, AI…

check-ai — リポジトリのAI準備度診断ツール