github-kb

GitHub ナレッジベースエクスプローラー

インストール

Claude Code プラグインマーケットプレイスから追加します。

/plugin marketplace add lecion/github-kb

設定

作業ディレクトリをカスタマイズするには、GITHUB_KB_ROOT 環境変数を設定します。

作業ディレクトリ

GITHUB_KB_ROOT 環境変数に基づく動的なパスです（デフォルト：~/github-kb/）。

ナレッジベースの管理

CLAUDE.md の場所

ナレッジベースのインデックスは {GITHUB_KB_ROOT}/CLAUDE.md にあります。このファイルには、調査したすべてのリポジトリがインデックス化されています。

CLAUDE.md の形式

# Claude Code 知识库

本目录包含 X 个 GitHub 项目，涵盖...领域描述

---

## Category Name

### [project-name](/project-name)
Brief description of the project

CLAUDE.md の更新

新しいリポジトリをクローンまたは調査する際は、一貫性を保つために CLAUDE.md を更新します。

• 適切なカテゴリの下にプロジェクトを追加します
• プロジェクト名（そのディレクトリへのリンク付き）と簡単な説明を含めます
• ヘッダーのプロジェクト数を更新します

ワークフロー

1. ナレッジベースの検索（最初の手順）

ユーザーからリポジトリについて質問された場合：

1. {GITHUB_KB_ROOT}/CLAUDE.md を読み、プロジェクトが存在するか確認します
2. 見つかった場合は、Read、Glob、Grep ツールを使って既存のディレクトリを調査します
3. 見つからない場合は、クローンに進みます

2. 新しいリポジトリのクローン

ユーザーが新しいリポジトリの調査を希望する場合、またはリポジトリが存在しない場合：

cd {GITHUB_KB_ROOT}
git clone <repo-url>

• リポジトリへのアクセス方法に応じて HTTPS または SSH を使用します
• クローン先のデフォルトディレクトリは常に {GITHUB_KB_ROOT} です

3. 調査と分析

クローン後、または既存のリポジトリで作業する場合：

• Task ツールで Explore エージェントを使用し、コードを包括的に分析します
• アーキテクチャや調査には、対象を絞って Glob／Read／Grep を使用します
• 実装の詳細、技術的な判断、主要なファイルに焦点を当てます

4. ナレッジベースの維持

調査が正常に完了した後：

• 新しいプロジェクトのエントリーを CLAUDE.md に追加します
• 正確なカテゴリと説明を含めます
• リンクと書式が正しいことを確認します

CLAUDE.md のカテゴリ

プロジェクトの整理に使用する一般的なカテゴリ：

• Web フレームワーク - フロントエンド／バックエンドのフレームワーク
• DevOps ツール - CI/CD、デプロイ、インフラストラクチャ
• 機械学習 - ML ライブラリ、モデル、ツール
• モバイル開発 - iOS、Android、クロスプラットフォーム
• ユーティリティ - CLI ツール、生産性向上ツール
• データベース - データベースクライアント、ORM
• API とサービス - API クライアント、SDK
• その他 - 他のカテゴリに当てはまらないプロジェクト

環境変数

変数	説明	デフォルト
GITHUB_KB_ROOT	クローン先のルートディレクトリ	~/github-kb/

例

# Clone a new repository
cd $GITHUB_KB_ROOT
git clone https://github.com/example/repo.git

# Explore an existing repository
Task tool -> Explore agent -> analyze repo structure

# Update knowledge base
Edit CLAUDE.md -> add new project entry

後方互換性

既存のユーザーは設定を変更する必要はありません。デフォルトのパスにより後方互換性が維持されます。