# Knowledge Base

> .ai-game-dev/knowledge/ にあるMarkdownノートをプロジェクトと一緒にコミットし、グラフとしてインデックス化してエージェントが検索できるようにする、プロジェクトのKnowledge Baseです。エージェントは設計上の決定や規約を記録し、ノートをスペースに整理し、移動時にリンクを修正し、壊れたリンクを見つけます。デスクトップアプリはノートを3Dグラフで表示します。

- ID: `aigd.knowledge`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: 3D
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 0.3.22 (公開日 2026-11-22)
- ライセンス: Apache-2.0
- AI Game Dev アプリが必要です: `>=0.25.11`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.knowledge

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

```bash
gamedev pkg add aigd.knowledge
```

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.knowledge` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 0.3.22 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.3.21 | 2026-11-19 | `>=0.25.11` | - |
| 0.3.20 | 2026-11-13 | `>=0.25.11` | - |
| 0.3.19 | 2026-11-13 | `>=0.25.11` | - |
| 0.3.18 | 2026-11-06 | `>=0.25.11` | - |
| 0.3.17 | 2026-11-02 | `>=0.25.11` | - |
| 0.3.16 | 2026-11-01 | `>=0.25.11` | - |
| 0.3.15 | 2026-11-01 | `>=0.25.11` | - |
| 0.3.7 | 2026-10-15 | `>=0.22.0` | - |
| 0.3.6 | 2026-10-13 | `>=0.22.0` | - |
| 0.3.5 | 2026-10-12 | `>=0.22.0` | - |
| 0.3.4 | 2026-10-11 | `>=0.22.0` | - |
| 0.3.3 | 2026-10-09 | `>=0.22.0` | - |
| 0.3.2 | 2026-10-07 | `>=0.22.0` | - |
| 0.2.1 | 2026-10-05 | `>=0.20.0` | - |

## 説明

````markdown
# Knowledge Base(`aigd.knowledge`)について

AI Game Devエージェントのための、プロジェクトのKnowledge Baseです。`.ai-game-dev/knowledge/`にあるMarkdownノートをプロジェクトと一緒にコミットし、gitを通じてチームと共有します。このパッケージはノートとそのリンクをグラフとしてインデックス化し、エージェントがノートを閲覧・検索・リンク・整理するためのツールを提供し、グラフを3Dウィンドウに表示します。設計上の決定や規約、システムの仕組みを、人とエージェントの両方が見つけられる場所に書き留めておきたいゲームチームに適しています。

## できること

- 作業中に、設計上の決定とその理由、規約、気づきにくい落とし穴を、エージェントに適切なトピックのスペースへ記録させられます。
- あるシステムについてチームが何を決めたのかをエージェントに尋ねられます。エージェントはノートを検索して答えます。
- ノートをスペース(`README.md`を持つフォルダー)に整理でき、リンクを壊さずにノートやフォルダーを移動・名前変更できます。
- 壊れたリンクや孤立したノートを見つけ、すべてがグラフでどうつながっているかを確認できます。
- 3Dグラフウィンドウや、デスクトップアプリのサイドパネルのプレビューで、ノートを自分で閲覧できます。

## リクエストの例

- 「戦闘システムの物理ステップを60 Hz固定にしたことと、その理由を書き留めておいて。」
- 「Knowledge Baseにはセーブゲームの形式について何が書かれていますか?」
- 「インベントリシステム用のスペースを作って、アイテムのノートをそこへ移動して。」
- 「Knowledge Baseの壊れたリンクをチェックして修正して。」
- `/kb systems`(Knowledge Baseの合計と壊れたリンク、および`systems`スペースのツリー)

## 仕組み

ノートは`<project>/.ai-game-dev/knowledge/`の下にあるプレーンなMarkdownファイルなので、ゲームと同じバージョン管理下に置かれます。**スペース**とは`README.md`を持つフォルダーで、`# Title`があり、その後に1段落の説明が続きます。ノート同士はKnowledge Baseのルートからのパスでリンクします(例: `[Combat](/systems/combat.md)`)。相対リンクやウィキリンク(`[[Combat]]`)もインデックス化されます。

エージェントは指示の中で最上位のスペースの一覧を確認し、一度に1つのスペースをたどっていきます。ノートの読み書きは通常のファイルツールで行い、それ以外の操作には次のツールを使います。

| ツール | 機能 |
|---|---|
| `kb_space_get` | スペースを開きます。説明、子スペース、ノートを返します。 |
| `kb_space_create` | スペースを作成します。`README.md`(タイトルと説明)を持つフォルダーです。 |
| `kb_search` | タイトル、パス、本文によるノートのランク付き検索。スニペット付き。 |
| `kb_links` | ノート1件、またはフォルダー内の全ノートの、外向きリンク、バックリンク、壊れたリンク。 |
| `kb_move` | ノートやフォルダーを移動・名前変更し、そこへのすべてのリンクを書き換えます。 |
| `kb_lint` | 壊れたリンク、孤立したノート、規約上の問題、ヒント。 |

エージェントには、重要で長く残る知識(決定とその理由、規約、システムの仕組み、気づきにくい落とし穴)だけを記録すること、まず検索し、重複させずに既存のノートを更新すること、すべての事実をあなたの発言かコードが示す内容に基づくことが指示されます。

このパッケージが提供するもの:

- **Knowledge Base**機能(デフォルトでオン)。
- `/kb [folder or note]`コマンド(CLIとデスクトップ)。ノート、フォルダー、リンク、壊れたリンク、孤立ノート、続いてツリーを表示します。
- デスクトップアプリでは、3Dグラフウィンドウ(ステータスバー、セッションのツールメニュー、またはファイルエクスプローラーでノートやフォルダーの「Knowledge Baseグラフで開く」から開けます)、右パネルのKnowledge Baseビュー、そしてそこへ誘導するヒント。グラフはエージェントがノートを書いている間もリアルタイムに更新されます。

## 要件

- AI Game Dev 0.25.11以降。グラフウィンドウとサイドパネルはデスクトップアプリの一部です。
- プロジェクトフォルダー。ノートをチームと共有するには`git`。

## ライセンス

Apache-2.0.
````
