knowledge-base-query について
プロジェクト、書籍、基礎トピックを扱うリポジトリ型ナレッジベースを参照して回答する、読み取り専用のスキルです。索引から必要な文書だけを探し、その内容に基づいて回答します。
主な機能
- 01リポジトリ索引から項目を検索
- 02関連文書のみを参照
- 03ナレッジベースの出典に基づく回答
- 04情報不足または古い項目の上流リンク提示
- 05ナレッジベースの内容を変更しない
活用シーン
- 01プロジェクトに記録された機能の確認
- 02書籍や章の情報の検索
- 03基礎トピックに関する質問への回答
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mmontes11/ skills --skill knowledge-base-queryインストール後、Claude Code で/knowledge-base-queryを入力して読み込まれたか確認します。
詳細
ナレッジベースを検索する
ナレッジベースからプロジェクト、書籍、基礎的なトピックに関する情報を読み取り、それに基づいて回答します。ルートの README.md はインデックスです。名前とフォルダーの対応が記載されているため、まずここを確認し、目的のファイルに直接進んでください。リポジトリ全体を読まず、インデックスを使って、質問に必要なファイルだけを開いてください。
ナレッジベースの場所
ナレッジベースのリポジトリ内で作業します。標準のローカルチェックアウト先は ~/code/knowledge-base です。存在しない場合は、git clone [email protected]:mmontes11/knowledge-base.git ~/code/knowledge-base を実行してください。以下のパスはすべてリポジトリのルートからの相対パスです。
ステップ 0 — インデックスで探す
ルートの README.md にインデックスがあります。
- Tracked projects テーブル — 各プロジェクトと、その
projects/<category>/<project>/フォルダーおよび上流 URL の対応を示します。 - Tracked books テーブル — 各書籍と、その
books/<book>/フォルダーの対応を示します。 - Tracked foundational knowledge テーブル — 各基礎的なトピックと、その
foundation/<topic>/フォルダーの対応を示します。
質問の対象がインデックスにない場合は、その旨を伝えてください。ナレッジベースでは扱っていないため、そこで終了します。Tracked projects に該当する行があり、さらに調査すると役立つ場合は、その上流 URL を提示してください。
ステップ 1 — 適切なファイルを読む
質問に答えるファイルに直接進んでください。
| 質問 | 読むファイル |
|---|---|
| プロジェクトとは何か/どのような問題を解決するのか | projects/<c>/<p>/README.md |
| API/リソース/CLI の仕様 | projects/<c>/<p>/api-reference.md |
| 最新リリース/変更点 | projects/<c>/<p>/releases.md |
| 機能 | projects/<c>/<p>/features.md |
| アーキテクチャ | projects/<c>/<p>/architecture.md(存在する場合のみ) |
| 書籍で扱う内容/章の内容 | books/<book>/README.md、次に NN-<chapter>.md |
| 概念の実際の仕組み | foundation/<topic>/README.md |
ステップ 2 — 回答する
- ナレッジベースの情報に基づいて回答し、読んだファイルを引用してください。必要に応じて
last_updatedフロントマターも示し、情報がどの程度最新か読者にわかるようにしてください。 - プロジェクトについて、KB は上流の内容を複製せず、リンクを掲載しています。記載が簡素または古い場合は、その旨を伝え、読者が確認できるよう Tracked projects テーブルの上流リンクを提示してください。
- 質問が複数のファイルにまたがる場合(例:「 の全体像を教えて」)、まず
README.mdを読み、質問に必要な特定のファイルだけを追加で確認してください。
対象範囲
このスキルは読み取り専用です。ナレッジベースの内容を編集、追加、削除することはありません。プロジェクトや書籍の追加、およびプロジェクト情報の更新には、knowledge-base-add-project と knowledge-base-add-book の各スキルを使用します。