Git.Top

Git.Top

オープンソースのナレッジグラフ。

GitHub が提供するのはコードです。Git.Top が提供するのはナレッジです。

Git.Top は、構造化されていない GitHub リポジトリのデータを構造化されたプロジェクトナレッジに変換します。人間や AI エージェントは、REST API または MCP ツールを通じて、これを検索、比較、推薦、評価、利用できます。

Cloudflare Worker が唯一のプロダクト提供面です。人間向けの HTML ページ、REST API、MCP エンドポイント、GitHub 同期、D1 を基盤とするナレッジデータを提供します。

本番環境：git.top

リポジトリ：github.com/haocn-ops/git-top

エージェントを接続する

最初の接続を最短で行うには、用途を絞った MCP プロファイルを使用してください。

codex mcp add git-top --url https://git.top/mcp/core
claude mcp add --transport http --scope user git-top https://git.top/mcp/core

次に、エージェントに次のように尋ねてください。

Use Git.Top to recommend three open-source browser-agent projects for Docker, then cite the data source and one caveat for each.

詳細な設定、クライアントのステータス、REST の代替手段：git.top/connect。

日付付きの互換性の根拠、および設定の検証と実際のクライアントサポートの違い：git.top/compatibility。

レジストリ向けの文面、プロファイル、プライバシーの境界、キャンペーンリンク、提出状況：git.top/distribution.json。インストール可能な REST 優先のエージェントスキルは、skills/git-top-project-selection から利用できます。

Git.Top の機能

• カテゴリ、デプロイ先、ユースケースからオープンソースの AI プロジェクトを見つけます。
• 意思決定の要約、ランキング指標、トレードオフを使ってプロジェクトを比較します。
• 類似性の指標と比較にすぐ使える候補リストから、代替プロジェクトを見つけます。
• 代替プロジェクト、関連プロジェクト、依存関係、デプロイ、ユースケースにまたがるプロジェクト間のつながりを調べます。
• Git.Top Score、Agent Score、品質指標、リスクフラグ、根拠を説明します。
• エージェント向けの REST、OpenAPI、llms.txt、llms-full.txt、MCP の各インターフェースを提供します。

プロダクトの各機能

• /discover - AI エージェント、MCP サーバー、RAG、ブラウザー自動化、AI IDE プロジェクトを閲覧します。
• /recommend - ユースケースと制約を、根拠を説明できるプロジェクト候補リストに変換します。
• /compare - プロジェクト候補リストを比較します。
• /alternatives および /alternatives/:project - 置き換え候補を見つけます。
• /graph/:project - プロジェクトのナレッジグラフを確認します。
• /score/:project - プロジェクトのスコアの各項目を説明します。
• /atlas - エコシステムマップを調べます。
• /api/* - 構造化されたナレッジを利用します。
• /mcp - MCP 経由でエージェントを接続します。
• /mcp/core - 初回利用向けの、5 つのツールに絞った MCP プロファイルに接続します。

アーキテクチャ

GitHub API
  -> Git.Top ETL
  -> Cloudflare D1
  -> Worker pages, REST APIs, MCP tools, sync jobs, and quality gates

このプロジェクトでは、独立した Next.js アプリをあえて提供していません。Worker がレンダリングするページ、API、同期、D1 アクセス、OpenAPI、MCP を単一のランタイムにまとめることで、プロダクトの挙動が分断されるのを防いでいます。

ドキュメント

• コーディングエージェントガイド
• AI エージェントの導入と配布計画 2026-07-31
• エージェントクライアントの互換性
• エージェント配布パッケージ
• エージェントネイティブの評価と最適化計画
• 競合分析と90日間の最適化計画 2026-09-02
• エージェント機能のテストと改善計画 2026-07-30
• 本番環境の鮮度最適化計画 2026-07-14
• サイトの評価と改善計画 2026-07-12
• 自動運用とエージェントフレンドリー化計画 2026-07-12
• エージェントタスクの評価
• エージェントネイティブ最適化の実装レポート
• エージェントネイティブ最適化のPR概要
• Git.Top 2.0 製品アップグレード計画
• 次の段階の計画
• エージェントフレンドリー化最適化計画
• デプロイの判断
• REST API ガイド
• MCP ガイド
• MCP ツールの動作例
• MCP 適合性マトリックス
• SDK 向けサンプル
• 導入分析の運用手順書
• GRP の例
• エージェントクイックスタート
• MailAgents のエージェントワークフローに関する記事
• サイト評価 2026-06-21
• 本番環境の運用手順書
• 運用とデータガバナンス計画
• 公開信頼性ベンチマーク：/benchmark および /api/benchmark
• データカバレッジレポート
• シードのライブチェックレポート
• 評価品質レポート
• ローカル評価レポート
• ランキング実験
• 品質強化計画
• V1 リリース後の改善計画
• コントリビューション
• セキュリティ
• ライセンス

開発

保守エージェントは、まずAGENTS.mdを確認してください。ランタイム、リスクの高い領域、生成データ、検証レベルがまとめられています。

簡易チェック：

pnpm docs:validate
pnpm check

エージェント向けインターフェースのチェック：

pnpm api:validate
pnpm mcp:validate
pnpm eval:explanations
pnpm check

データとローカル D1 のチェック：

pnpm db:execute
pnpm db:seed
pnpm db:integration

リリースチェック：

pnpm validate
pnpm release:check

よく使う開発コマンド：

pnpm install
pnpm db:execute
pnpm db:seed
pnpm seed:validate
pnpm seed:coverage
pnpm seed:candidates
pnpm seed:live-check -- --limit 20
pnpm seed:live-check -- --offset 20 --limit 20
node scripts/run-governance-task.mjs daily-production-health
pnpm knowledge:validate
pnpm db:seed-sql
pnpm db:validate
pnpm db:integration
pnpm core:validate
pnpm api:validate
pnpm mcp:validate
pnpm eval:quality
pnpm eval:explanations
pnpm eval:local
pnpm eval:ranking
pnpm eval:agent-tasks
pnpm smoke:prod
pnpm release:check
pnpm check
pnpm validate
pnpm quality:check
pnpm dev

/api/health は、D1 の利用可否と現在のプロジェクト数を報告します。D1 の状態が空の場合は、ローカル API のチェック前に pnpm db:execute と pnpm db:seed を実行してください。pnpm db:execute は、ローカル D1 のスキーマを準備し、古いローカルデータベースに不足している可能性のあるオプションの列を補完します。seed.sql は、手書きのシードナレッジと生成された評価用フィクスチャから生成されます。これらのフィクスチャを変更した場合は、pnpm db:seed-sql を実行してください。pnpm db:integration は、ローカル D1 にシードデータを投入し、一時的なローカル Worker を起動して、D1 を利用する HTTP API の経路を検証します。

pnpm eval:quality は、CI で安全に実行できる推奨と分類のリグレッションゲートです。pnpm eval:explanations は、エージェント向けの応答にソースのメタデータ、分類の根拠、品質シグナルの信頼度、推奨の理由とトレードオフ、ヘルスチェックにおける件数の意味、GRP の推論が含まれていることを確認します。pnpm eval:agent-tasks は、信頼性、フォールバック、ページネーション、根拠、比較、変更フィード、フィードバック、多言語、誤字、エイリアスの各ワークフローを網羅しているかを判定し、docs/AGENT_TASK_EVAL.md を出力します。pnpm eval:local は、フィクスチャに基づくプロジェクト群を対象に、生成されたカテゴリとデプロイの広範なプローブを実行し、docs/EVAL_LOCAL.md を出力します。ランキングのヒューリスティックを調整する前に使用してください。ただし、デフォルトの検証フローには含めないでください。pnpm eval:ranking は、docs/RANKING_EXPERIMENTS.md にあるオフラインランキング戦略を比較します。ランタイム検索では、デフォルトで意図に厳密に一致するランキングを使用します。広範囲を対象としたスコープ付き探索では、ranking=browse を選択できます。

pnpm seed:candidates は、GitHub の組織メタデータからシード拡張候補を検出し、docs/SEED_CANDIDATES.md を出力します。これはレビュー待ちの候補リストとして扱い、自動追加の手順にはしないでください。候補を data/seed-repositories.json に追加する前に、ライブチェックとカテゴリのレビューが必要です。

pnpm smoke:prod は、デプロイ済み Worker を https://git.top で検証し、D1 に基づく応答を必要とします。ローカルまたはプレビュー Worker を対象にする場合は pnpm smoke:prod -- --base-url http://localhost:8787 を使用してください。シードへのフォールバック動作を意図的に確認する場合に限り、--allow-seed を追加してください。

pnpm quality:check は、デフォルトで https://git.top の本番 /api/quality エンドポイントを検証し、D1 に基づくメタデータを必須とします。デフォルトの最低スコアは 90 です。プレビューやフォールバックのチェックには、--base-url、--target、--min-score、--allow-seed を使用してください。

運用とデータガバナンスには、/operations、/api/governance/summary、/api/governance/runs からアクセスできます。Cloudflare Worker の cron は、毎時のメンテナンスに加え、毎日、毎週、隔週、毎月のガバナンスチェックを実行し、その結果を governance_runs に記録します。

pnpm release:check は、公開 V1 リリースゲートとして、ローカル検証、ローカル D1 統合、本番品質、本番スモークテストを実行します。本番デプロイ前のビルドを検証する場合に限り、pnpm release:check -- --skip-prod-smoke を使用してください。これにより、本番環境のみを対象とするチェックが省略されます。Worker のプレビューまたはローカルのオリジンに対して同じゲートを実行するには、pnpm release:check -- --base-url <origin> を使用してください。

既存の D1 データベースを更新する場合は、新しい列を読み取るコードをデプロイする前に、migrations の SQL ファイルを適用してください。

同期

Git.Top は、GitHub API から実際のリポジトリデータを D1 に同期できます。

本番環境で必要なシークレット：

wrangler secret put GITHUB_TOKEN
wrangler secret put SYNC_SECRET

ローカル開発では、.dev.vars.example を .dev.vars にコピーし、実際の値を入力します。

保護されたローカルまたは本番環境の同期を実行します：

curl -X POST http://localhost:8787/api/admin/sync \
  -H "authorization: Bearer $SYNC_SECRET" \
  -H "content-type: application/json" \
  -d '{"limit": 40, "offset": 0, "signal_depth": "lite"}'

最近の /api/sync/status の実行状況を確認したうえで、手動の追いつき同期には {"limit":40,"signal_depth":"lite"} を使用します。Cron では Worker のサブリクエスト制限を超えないよう、より小さい軽量バッチサイズを使用します。一方、手動の追いつき同期は上限が 50 です。

本番環境で追いつき同期を繰り返し実行します：

SYNC_SECRET=... pnpm sync:prod:catchup --rounds 13 --limit 40

保存されているシードカーソルを使用するには、offset を省略します。Cron 同期ではこのカーソルを使用し、上限付きのバッチでシードリストを順に処理します。 すべてのシードリポジトリのインデックス作成が完了していても、remaining_count=0 にもかかわらず鮮度の回復のためにシードカーソル全体を再処理する必要がある場合は、--refresh-cycle を追加します。

API

• GET /api/project/:owner/:name
• GET /api/health
• GET /api/quality
• GET /api/benchmark
• GET /api/governance/summary
• GET /api/governance/runs
• GET /api/sync/status
• GET /api/schema/agent-card.v1
• GET /api/schema/project-knowledge.v1
• GET /api/search
• GET /api/trending
• GET /api/category/:name
• GET /api/recommend
• GET /api/compare
• GET /api/alternatives/:owner/:name
• POST /api/grp/query
• POST /api/admin/sync
• POST /api/admin/alternatives
• POST /api/admin/governance/runs

V1 開発仕様については git_top_v1.md を、GRP v1 推論プロトコルの実装仕様については git_top_grp_v1.md を参照してください。

ライセンス

MIT