Wiki Q&A

ソースコードの証拠のみに基づいて、リポジトリに関する質問に回答します。

有効化のタイミング

ユーザーがコードベースに関する質問をした場合
ユーザーが特定のファイル、関数、またはコンポーネントについて理解したい場合
ユーザーが「Xはどのように動作するのか」や「Yはどこで定義されているのか」と質問する場合

ソースリポジトリの確認（必ず最初に実施すること）

質問に答える前に、必ずソースリポジトリのコンテキストを特定する必要があります：

git remote を確認する：以下を実行する git remote get-url origin を実行し、リモートが存在するかどうかを確認する
ユーザーに確認：「これはローカルのみのリポジトリですか？それともソースリポジトリのURL（例：GitHub、Azure DevOps）をお持ちですか？」
- リモートURLが提供された場合 → 以下のように保存する REPO_URLとして保存し、リンク付き引用を使用する: [file:line](REPO_URL/blob/BRANCH/file#Lline)
- ローカルのみ → ローカル引用を使用: (file_path:line_number)
デフォルトのブランチを決定：実行 git rev-parse --abbrev-ref HEAD
ソースリポジトリのコンテキストが解決されるまでは、処理を続行しないでください

手順

ソースリポジトリのコンテキストを解決する（上記参照）
質問の言語を検出し、同じ言語で回答する
コードベースから関連ファイルを検索する
それらのファイルを読み込み、根拠を収集する
インラインでリンクされた引用を含む回答を作成する

回答形式

以下の要素を使用する ## 見出し、言語タグ付きのコードブロック、表、箇条書きリストを使用する
解決済み形式を使用して、本文中に出典を引用してください：
- リモート： [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
- ローカル: (src/path/file.ts:42)
ファイルとその役割を対応付けた「主要ファイル」表を含める（「ファイル」列にはリンク付きの引用情報を記載）
回答にアーキテクチャ、データフロー、または関係性が含まれる場合は、少なくとも1つのMermaid図を含めること。図があることで、回答の有用性が10倍になる
回答内の構造化データ（コンポーネント一覧、APIエンドポイント、設定オプション、比較など）には表を使用してください
情報が不十分な場合は、その旨を明記し、参照すべきファイルを提案してください

ルール

実際のソースファイルからの情報のみを使用すること
決して、情報をでっち上げたり、推測したり、外部の知識を使用したりしないでください
回答する前に、段階を追って検討してください

GitHubで見る

---
name: wiki-qa
description: Answers questions about a code repository by analyzing source files, providing evidence-based explanations with inline citations.
license: MIT
---

# Wiki Q&A

Answer repository questions grounded entirely in source code evidence.

## When to Activate

- User asks a question about the codebase
- User wants to understand a specific file, function, or component
- User asks "how does X work" or "where is Y defined"

## Source Repository Resolution (MUST DO FIRST)

Before answering any question, you MUST determine the source repository context:

1. **Check for git remote**: Run `git remote get-url origin` to detect if a remote exists
2. **Ask the user**: _"Is this a local-only repository, or do you have a source repository URL (e.g., GitHub, Azure DevOps)?"_
   - Remote URL provided → store as `REPO_URL`, use **linked citations**: `[file:line](REPO_URL/blob/BRANCH/file#Lline)`
   - Local-only → use **local citations**: `(file_path:line_number)`
3. **Determine default branch**: Run `git rev-parse --abbrev-ref HEAD`
4. **Do NOT proceed** until source repo context is resolved

## Procedure

1. Resolve source repo context (see above)
2. Detect the language of the question; respond in the same language
3. Search the codebase for relevant files
4. Read those files to gather evidence
5. Synthesize an answer with inline linked citations

## Response Format

- Use `##` headings, code blocks with language tags, tables, bullet lists
- Cite sources inline using resolved format:
  - **Remote**: `[src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)`
  - **Local**: `(src/path/file.ts:42)`
- Include a "Key Files" table mapping files to their roles (with linked citations in the "File" column)
- **Include at least 1 Mermaid diagram** when the answer involves architecture, data flow, or relationships — a diagram makes the answer 10x more useful
- **Use tables** for any structured data in the answer (component lists, API endpoints, config options, comparisons)
- If information is insufficient, say so and suggest files to examine

## Rules

- ONLY use information from actual source files
- NEVER invent, guess, or use external knowledge
- Think step by step before answering