Repo Wiki は、プロジェクトの構造化ドキュメントを自動生成し、コードとドキュメントの変更を継続的に追跡します。
開発中に知識ポイントやコードの説明を照会したり、機能を追加したりする際、Repo Wiki はプロジェクト構造とコード実装を深く分析します。Repo Wiki とコンテキスト情報を組み合わせることで、より正確で詳細な回答とドキュメントサポートを提供し、エージェントにコードベースへのより深い理解をもたらします。
適用シナリオ
-
アーキテクチャと実装に関するクエリ
エージェントは構築済みのアーキテクチャ知識を利用して、ツールをほとんど呼び出すことなく、「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 とナレッジカードへの介入が可能です：
| 操作 | 説明 |
|---|
| 生成 | プロジェクトの Wiki またはナレッジカードを初めて生成 |
| 修正 | 既存の知識コンテンツを部分的に変更 |
| 追加 | 既存の知識に新しいコンテンツを追記 |
| 書き換え | 知識ページまたはカードを完全に書き換え |
- 入力欄で を呼び出す
- 必要な変更内容を記述する指示を入力
- 参考としてローカルファイルをアップロード可能（設計ドキュメント、API ドキュメントなど）
- Agent が指示に基づいて対応する知識コンテンツを変更
手動で変更されたコンテンツはシステムによってマークおよび保護され、次の自動更新時に上書きされません。チームの知識修正のすべてが永続的なナレッジ資産となります。
wiki_plan.yaml — 事前介入設定
設定ファイルを通じて、Wiki 生成前にガイド意図を注入し、生成の方向性と範囲を制御できます。
ファイルの場所：
このファイルは Git コミットを通じてチームと共有されます。
設定構造：
主な設定項目：
| 設定項目 | 説明 |
|---|
repowiki.template | プリセットテンプレート：architecture（包括的な技術分析）または product_requirement（製品要件形式で出力） |
repowiki.notes | 計画フェーズに注入するガイダンスプロンプト、AI の注力ポイントを誘導 |
repowiki.documents | ページホワイトリスト、指定時はリスト通りに厳密にページを生成 |
knowledgecard.notes | ナレッジカードガイダンスプロンプト、モジュール分割の方向に影響 |
scope.include / exclude | 生成時に可視なファイル範囲を制御 |
wiki_plan.yaml を変更した後、「生成」または「再生成」を手動でトリガーする必要があります。
Repo Wiki の共有
チーム内での知識の流動性を高めるために、Wiki の共有をサポートしています。
チーム管理者が Web コンソールでナレッジエンジンのトグルを有効にすると、チームメンバーが生成した Repo Wiki は自動的にチームに同期されます。他のメンバーは同じリポジトリの同じブランチを開き、生成をクリックするだけでチームの最新知識を自動的に取得できます——手動での pull は不要です。チームメンバーによるプロジェクト知識への変更はすべて全員に同期更新され、チームの知識が常に一貫して最新の状態に保たれます。
自動チーム共有は Teams プランでのみ利用可能です。それ以外の場合は、Git 同期を使用して知識を管理することもできます。
.qoder/repowiki を自動的に作成します。
このディレクトリをコミットし、リモートブランチにプッシュできます。チームメンバーは追加の構成なしで、git pull を介して生成された Wiki コンテンツを取得できます。
多言語サポート
Wiki システムは多言語をサポートしています。Wiki 生成時に希望する言語を選択できます。現在、英語と中国語がサポートされています。
Wiki 生成時、システムは言語選択に基づいて、選択した言語ごとの独立したディレクトリを Git ディレクトリの下に自動的に作成します（例：repowiki/zh/、repowiki/en/）。
生成と更新は通常通り Credits を消費します。消費履歴は使用量 - Creditsで確認できます。 
