ParaWiki/.claude/skills/query/SKILL.md

name, description

name	description
query	Answer a user question using wiki/ pages as the knowledge base. Document-based retrieval, NOT vector DB. Use when the user asks a substantive question about parametric modeling, civil BIM, Revit, or any topic likely covered in ParaWiki — or invokes "/query <질문>". Cites wikilinks as sources.

query

사용자 질문을 wiki/ 문서를 근거로 답한다. 벡터 DB·임베딩 사용 안 함 — 파일 시스템 + 문자열 검색으로 필요한 페이지를 찾고, 해당 페이지들을 읽어 답한다.

절차

1. 질문 의도 파악 (한 번만 빠르게)

• 질문의 핵심 키워드 2~5개 추출. 한국어 + 영어 동의어 모두 고려 (예: "솔버" / "solver" / "GCS", "변경 엔진" / "PCE" / "propagation").

2. index.md 먼저 (Rule 8)

• wiki/index.md 를 읽는다.
• 한 줄 설명과 제목을 훑어 관련성 높은 페이지 후보 3~7개 선정.

3. 본문 검색 보강

• Grep으로 wiki/*.md 전체에서 키워드 검색 (Grep 도구, path: wiki/).
• index.md에서 놓친 페이지 발견 시 후보에 추가.

4. 후보 페이지 읽기

• 선정한 페이지들을 Read 로 열람.
• 각 페이지의 frontmatter(sources, principles) 와 사실/해석 섹션을 근거로 추출.
• 페이지 안의 wikilink로 연결된 페이지가 중요해 보이면 재귀적으로 1단계 더 타고 읽음 (과도한 확장 금지 — 보통 2단계 이내).

5. raw/ 폴백 (최후 수단)

• 위키에 해당 내용이 없거나 빈약할 때만 raw/ 검색.
• raw에서 근거를 찾았다면 답변 후 새 위키 페이지·기존 페이지 업데이트를 제안 (자동 실행 금지 — /ingest-raw로 사용자가 트리거).

6. 답변 작성

형식:

• 결론부터. 1~3문장 요약.
• 근거 — 사실은 어느 페이지에서 왔는지 [[페이지명]] 인용. 여러 페이지를 종합하면 각각 표기.
• 해석·제안 (선택) — 위키의 해석 섹션 또는 답변자 판단. 사실과 구분.
• 관련 페이지 — 사용자가 더 파고들 링크 2~4개.

원칙:

• 사실과 해석을 섞지 않는다. (Rule 7)
• 모순된 소스가 있으면 양쪽 모두 인용하고 차이를 드러낸다. (Rule 6)
• 위키에 없는 내용은 "위키에 아직 없음" 이라고 명시. 추측 금지.
• 답변은 간결하게. 장황한 배경 설명 자제.

7. 사후 처리

• 답변 중 위키에 추가할 가치가 있는 사실·관점이 드러나면 답변 끝에 한 줄 제안: 📝 업데이트 제안: [[페이지명]] 의 '해석' 섹션에 X 추가
• 자동 업데이트는 하지 않는다. 사용자가 명시적으로 요청 시 또는 /ingest-raw 시에만.

출력 예시

## 답변
Revit의 GCS는 Siemens D-Cubed 2D DCM을 라이선스해 내장한다. [[GCS 기하학적 구속조건 솔버]]

## 근거
- Siemens 채택: [[Revit 파라메트릭 아키텍처]] §사실
- 솔버 내부 메커니즘: [[GCS 기하학적 구속조건 솔버]] §사실 (Jacobian 랭크·뉴턴랩슨)

## 관련
- [[PCE 파라메트릭 변경 엔진]]
- [[파라메트릭 취약성 Davis 5가지]]

주의

• 벡터 검색·임베딩 사용 금지. 파일 시스템 + 키워드 grep만.
• raw/ 파일을 직접 인용할 때도 위키 페이지가 그 사실을 담고 있는지 먼저 확인. 담고 있으면 위키 쪽을 우선 인용.
• 답변에 위키의 frontmatter 메타(원칙 태그 등)를 활용하면 좋음.