適用シナリオ
- アーキテクチャと実装に関するクエリ
エージェントは構築済みのアーキテクチャ知識を利用して、ツールをほとんど呼び出すことなく、「X はどのように実装されていますか？」や「どのサービスがこのモジュールに依存していますか？」といった質問にすばやく回答できます。 - エージェント主導の開発タスク
コンテキストの幅が制限されている場合、Repo Wiki はコードの特定を加速し、以下のタスクをサポートします：- 新機能の追加
- バグの修正
Repo Wiki の生成
リポジトリ内の Wiki は静的なものではありません。コードと同期を保ちます。 Wiki は 3 つの重要な状況で更新されます。トリガーのタイミングと理由を理解することで、Wiki をリアルタイムで更新し続けることができます。- 初回の Wiki 生成 プロジェクトを初めて開いたとき、デフォルトでは Wiki は存在しません。ワンクリックでゼロから生成できます。
- コード変更の検出 初回生成後、システムはコードの変更を継続的に監視します。 Wiki に記録されている内容（関数シグネチャ、クラス定義、API エンドポイントなど）を変更した場合、システムは現在のコードと既存の Wiki との不一致を検出します。更新 をクリックすると、影響を受ける部分のみを再生成できます。
- Git ディレクトリの同期 Git ディレクトリ内の Markdown ファイルを直接編集した場合、システムは Git コンテンツと Wiki の不一致を検出します。同期 をクリックすると、Git の変更を同期して Wiki を更新できます。
- 生成の制限
- プロジェクトごとに最大 10,000 ファイル。プロジェクトに 10,000 以上のファイルが含まれる場合は、Qoder Settings → Codebase Indexing → Index Exclusions で不要なパスを除外することをお勧めします。
- 少なくとも 1 つのコミットを持つ Git リポジトリのみがサポートされます。
Wiki 生成への介入
Repo Wiki は「一度生成したら読み取り専用」という成果物ではありません。生成前に設定ファイルで方向性を導くことも、生成後にいつでも変更することもできます。チームによる知識の修正はすべてシステムに新たな認知の蓄積として認識され、次の自動更新で上書きされることなく、対応するナレッジカードに逆方向で同期されます——人の判断を真にナレッジ資産に書き込みます。/knowledge コマンド
チャット入力欄で と入力すると、Repo Wiki とナレッジカードへの介入が可能です：
使い方：
- 入力欄で を呼び出す
- 必要な変更内容を記述する指示を入力
- 参考としてローカルファイルをアップロード可能（設計ドキュメント、API ドキュメントなど）
- Agent が指示に基づいて対応する知識コンテンツを変更
wiki_plan.yaml — 事前介入設定
設定ファイルを通じて、Wiki 生成前にガイド意図を注入し、生成の方向性と範囲を制御できます。 チャット入力欄で/knowledge-plan コマンドを入力すると、wiki_plan.yaml 事前介入設定ファイルを作成または編集でき、Wiki とナレッジカードの生成戦略を制御します。
例：
wiki_plan.yaml を変更した後、「生成」または「再生成」を手動でトリガーする必要があります。Repo Wiki の共有
チーム内での知識の流動性を高めるために、Wiki の共有をサポートしています。 チーム管理者が Web コンソールでナレッジエンジンのトグルを有効にすると、チームメンバーが生成した Repo Wiki は自動的にチームに同期されます。他のメンバーは同じリポジトリの同じブランチを開き、生成をクリックするだけでチームの最新知識を自動的に取得できます——手動での pull は不要です。チームメンバーによるプロジェクト知識への変更はすべて全員に同期更新され、チームの知識が常に一貫して最新の状態に保たれます。 ローカルで Wiki を生成すると、システムはコードリポジトリに専用ディレクトリ.qoder/repowiki を自動的に作成します。
git pull を介して生成された Wiki コンテンツを取得できます。
多言語サポート
Wiki システムは多言語をサポートしています。Wiki 生成時に希望する言語を選択できます。現在、英語と中国語がサポートされています。 Wiki 生成時、システムは言語選択に基づいて、選択した言語ごとの独立したディレクトリを Git ディレクトリの下に自動的に作成します（例：repowiki/zh/、repowiki/en/）。