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 リポジトリのみがサポートされます。
Repo Wiki の共有
チーム内での知識の流動性を高めるために、Wiki の共有をサポートしています。
チーム管理者が Web コンソールでナレッジエンジンのトグルを有効にすると、チームメンバーが生成した Repo Wiki は自動的にチームに同期されます。他のメンバーは同じリポジトリの同じブランチを開き、生成をクリックするだけでチームの最新知識を自動的に取得できます——手動での pull は不要です。チームメンバーによるプロジェクト知識への変更はすべて全員に同期更新され、チームの知識が常に一貫して最新の状態に保たれます。
自動チーム共有は Teams プランでのみ利用可能です。それ以外の場合は、Git 同期を使用して知識を管理することもできます。
ローカルで Wiki を生成すると、システムはコードリポジトリに専用ディレクトリ .qoder/repowiki を自動的に作成します。
このディレクトリをコミットし、リモートブランチにプッシュできます。チームメンバーは追加の構成なしで、git pull を介して生成された Wiki コンテンツを取得できます。
多言語サポート
Wiki システムは多言語をサポートしています。Wiki 生成時に希望する言語を選択できます。現在、英語と中国語がサポートされています。
Wiki 生成時、システムは言語選択に基づいて、選択した言語ごとの独立したディレクトリを Git ディレクトリの下に自動的に作成します(例:repowiki/zh/、repowiki/en/)。
生成と更新は通常通り Credits を消費します。消費履歴は使用量 - Creditsで確認できます。