docs-query
Use to ask the docs/ wiki a question, run a new task's preflight lookup, or guard right before a decision or approach ("did we already decide / already fail at this?").
- License 许可
- MIT
- 最近更新
- 2026-07-18
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- docs-query
- description
- Use to ask the docs/ wiki a question, run a new task's preflight lookup, or guard right before a decision or approach ("did we already decide / already fail at this?").
03 SKILL.md 正文
docs-query
Query 연산 — docs/ 위키에서 선행 지식을 읽고 질문에 답한다.
이 스킬은 세 시점에 호출된다:
- task-start preflight: task-start 4단계에서 이슈 원문을 질문으로 삼아 실행
- ad-hoc mid-task: 작업 중 임의 질문을 위키에 던질 때
- 결정·접근 직전 가드: 새 결정을 내리거나 새 접근을 시도하기 직전 "이미 정했나/망했나" 확인
AGENTS.md의 docs/ 위키 규칙을 따른다. 절차:
-
항상
docs/index.md에서 시작한다. 전체 위키 구조를 파악하고, 질문과 관련 있어 보이는 페이지를 목록화한다. -
관련 페이지를 읽는다: 질문 또는 새 task 이슈 원문을 기준으로 —
docs/decisions/index.md·docs/lessons/index.md앵커 표를 스캔한다.- 관련 synthesis(평면 토픽) 페이지를 읽는다.
docs/index.md만으로 부족하면rg로docs/를 검색할 수 있다.
-
가드 (결정·접근 직전 또는 새 task 이슈에 해당 결정·접근이 있을 때):
- 새 결정의 주제를
docs/decisions/index.md의 주제 앵커와 매칭한다. - 새 접근을
docs/lessons/index.md의 접근 앵커와 매칭한다. - 히트 시: "이미 정했나/망했나(+이유/제약)"를 표면화한다. 그 결정을 따르거나, 새 근거로 명시적으로 재오픈한다. 재오픈은 task-submit의 docs-ingest에서 supersede로 반영한다. 조용히 진행하지 않는다.
- 미스 시: 앵커에 없음을 확인하고 다음 단계로 넘어간다.
- 엣지 표면화: 앵커 매칭으로 찾은 페이지에
관계: contradicts나supersedes(또는상태: 대체됨)가 있으면 그 관계도 표면화한다 — "이 주제에 모순/대체 표시 있음: <대상>". 새 task가 이미 뒤집힌 결론 위에 쌓지 않도록 한다. - 매칭된 페이지가
관계: extends를 갖고 있으면 "이 결정은 기존 결정을 확장함: <대상>"으로 표면화한다. - 반대로 매칭된 페이지를 가리키는
관계: extends [[<매칭 페이지명>]]도rg등으로docs/decisions/와docs/runbooks/에서 찾아 "이 결정을 확장한 항목 있음: <출처>"로 표면화한다. 원 결론은 유지하되 후속 경계나 보완 규칙을 놓치지 않게 하기 위해서다.
- 새 결정의 주제를
-
task-start preflight로 쓰일 때: 발견을
task/index.md의 선행조회 섹션에 기록한다. 형식:- 확인한 문서
- 관련 내용과 이번 task에 주는 제약/힌트
- 가드 히트가 있으면 해당 결정·교훈도 기록
- 관련 문서가 없으면 "관련 선행 문서 없음"이라고 명시한다.
-
재사용 가치가 있는 발견은
task/docs/나task/log.md에 후보로 남긴다. 실제docs/반영은 docs-ingest에서 판단한다. 채팅에만 두지 않는다.
04 同仓库更多 Skills
ticket-incubate
Use to turn an idea that has no issue/ticket yet into an actionable GitHub issue. Grow a vague notion by divergence, narrow only the gaps via a deficit-based interview, and create the issue once the four required elements (background, goal, done criteria, out-of-scope) are filled. Triggers on "I have an idea", "let's make this a ticket", "create an issue", "interview me", or describing something to make/fix/improve without an issue number, even if the user never says the word "ticket". It is the front of the workbench lifecycle (idea -> ticket-incubate -> issue -> task-start). Distinct from brainstorming/design skills: those work out the how of what to build now; this captures the what of later work as a well-honed ticket.
task-tickets
Use to scan open workbench tickets joined with task branches and lifecycle events into unstarted / claim-attempted / in-progress / awaiting-PR / cleaned-up states. Read-only.
task-submit
Use when the user asks to submit, wrap up, or extract from a task, or when work has reached a point to open a PR.
task-status
Use to see local and remote task status at a glance and diagnose drift (unpushed, stale status, missed cleanup). When you want to know where everything stands before starting or submitting, or after a multi-device handoff.
task-start
Use when the user asks to start a task, pick up an issue, or begin a new attempt, or hands over an issue number to start work.
task-done
Use when the user asks to clean up or discard a task, or to clear the workspace after a PR is merged.