AGENT SKILL

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/ 위키 규칙을 따른다. 절차:

  1. 항상 docs/index.md에서 시작한다. 전체 위키 구조를 파악하고, 질문과 관련 있어 보이는 페이지를 목록화한다.

  2. 관련 페이지를 읽는다: 질문 또는 새 task 이슈 원문을 기준으로 —

    • docs/decisions/index.md·docs/lessons/index.md 앵커 표를 스캔한다.
    • 관련 synthesis(평면 토픽) 페이지를 읽는다.
    • docs/index.md만으로 부족하면 rg로 docs/를 검색할 수 있다.
  3. 가드 (결정·접근 직전 또는 새 task 이슈에 해당 결정·접근이 있을 때):

    • 새 결정의 주제를 docs/decisions/index.md의 주제 앵커와 매칭한다.
    • 새 접근을 docs/lessons/index.md의 접근 앵커와 매칭한다.
    • 히트 시: "이미 정했나/망했나(+이유/제약)"를 표면화한다. 그 결정을 따르거나, 새 근거로 명시적으로 재오픈한다. 재오픈은 task-submit의 docs-ingest에서 supersede로 반영한다. 조용히 진행하지 않는다.
    • 미스 시: 앵커에 없음을 확인하고 다음 단계로 넘어간다.
    • 엣지 표면화: 앵커 매칭으로 찾은 페이지에 관계: contradicts나 supersedes(또는 상태: 대체됨)가 있으면 그 관계도 표면화한다 — "이 주제에 모순/대체 표시 있음: <대상>". 새 task가 이미 뒤집힌 결론 위에 쌓지 않도록 한다.
    • 매칭된 페이지가 관계: extends를 갖고 있으면 "이 결정은 기존 결정을 확장함: <대상>"으로 표면화한다.
    • 반대로 매칭된 페이지를 가리키는 관계: extends [[<매칭 페이지명>]]도 rg 등으로 docs/decisions/와 docs/runbooks/에서 찾아 "이 결정을 확장한 항목 있음: <출처>"로 표면화한다. 원 결론은 유지하되 후속 경계나 보완 규칙을 놓치지 않게 하기 위해서다.
  4. task-start preflight로 쓰일 때: 발견을 task/index.md의 선행조회 섹션에 기록한다. 형식:

    • 확인한 문서
    • 관련 내용과 이번 task에 주는 제약/힌트
    • 가드 히트가 있으면 해당 결정·교훈도 기록
    • 관련 문서가 없으면 "관련 선행 문서 없음"이라고 명시한다.
  5. 재사용 가치가 있는 발견은 task/docs/나 task/log.md에 후보로 남긴다. 실제 docs/ 반영은 docs-ingest에서 판단한다. 채팅에만 두지 않는다.

04 同仓库更多 Skills

YOOGOMJA
YOOGOMJA/workbench-kit

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.

★ 0
YOOGOMJA
YOOGOMJA/workbench-kit

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.

★ 0
YOOGOMJA
YOOGOMJA/workbench-kit

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.

★ 0
YOOGOMJA
YOOGOMJA/workbench-kit

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.

★ 0
YOOGOMJA
YOOGOMJA/workbench-kit

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.

★ 0
YOOGOMJA
YOOGOMJA/workbench-kit

task-done

Use when the user asks to clean up or discard a task, or to clear the workspace after a PR is merged.

★ 0