위키 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