Communitygithub.com

Xavier189/dig-skill

dig(探骊)— 코딩 에이전트를 위한 소크라테스식 요구사항 발굴: 가설을 세우고, 중요한 것만 질문하며, 명확해질 때까지 반복하고, 작업 시작 전에 명확성 메모를 확인합니다. Claude Code에서 최고로 작동하며, Agent Skills와 호환됩니다.

dig-skill란 무엇인가요?

Dig는 AI 코딩 에이전트(Claude Code, Cursor 등)가 사용자 요청을 받았을 때, 표면적인 요청 뒤에 숨은 진짜 요구사항을 체계적으로 발굴하기 위한 스킬입니다. '요청은 시작 단서일 뿐, 요구사항이 아니다'라는 핵심 원칙 아래, 가설 수립, 중요 질문, 반복적 발굴, 최종 명확성 메모 확인의 4단계 프로세스를 통해 작업 시작 전에 오해와 누락을 방지합니다. 특히 Claude Code의 AskUserQuestion 도구를 활용한 구조화된 질의를 지원하며, 에이전트가 무분별하게 질문을 던지는 것을 방지하기 위해 '모든 질문은 실제로 구현 방식을 바꿀 수 있는 것만 해야 한다'는 엄격한 기준을 적용합니다. 이 스킬은 에이전트가 사용자와의 협업을 통해 진정한 요구사항을 파악하고, 불필요한 수정과 오해를 최소화하는 데 결정적인 역할을 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add Xavier189/dig-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Dig — 소크라테스식 요구사항 발굴

어떤 작업이든 시작하기 전에 사용자가 진정으로 원하는 것을 표면으로 끌어올립니다. 명시된 요청은 시작 단서일 뿐, 요구사항이 아닙니다. 숨겨진 의도, 명시되지 않은 제약 조건, 그리고 조용히 여러분에게 위임된 결정들이 바로 결과물이 잘못되는 지점입니다.

<하드-규칙> 명확성 메모(4단계)가 사용자에 의해 확인되기 전까지 구현을 시작하거나, 코드를 작성하거나, 최종 계획을 제시하지 마십시오. 이미 계획 모드(또는 플랫폼의 계획 흐름)에 있다면, 계획을 작성하기 전에 dig를 완료하십시오 — 메모가 계획의 입력입니다. </하드-규칙>

사용자의 언어를 따르고, 기술 용어는 원래 형태를 유지하십시오.

모든 질문이 통과해야 하는 기준

실제로 구축할 내용을 바꿀 수 있는 질문만 하십시오. 질문하기 전에, 서로 다른 접근 방식으로 이어질 두 가지 현실적인 답변을 구체적으로 말할 수 있어야 합니다. 모든 가능한 답변이 동일한 행동으로 이어진다면, 이미 충분히 알고 있는 것입니다 — 질문하지 마십시오. 이 기준은 아래의 모든 단계보다 우선합니다: 이 기준 없이 수행된 단계는 연극에 불과합니다.

프로세스

0. 맥락 — 가설을 세우기 전에 흡수하라

관련 있는 것을 읽으십시오: 작업이 다루는 파일, 프로젝트 문서, 그리고 플랫폼이 영구 메모리를 유지한다면 저장된 장기 목표와 반복되는 선호도. 사용자의 더 큰 그림을 살펴보십시오 — 기술적으로는 올바르지만 사용자의 장기 계획과 맞지 않는 결과물도 여전히 실패입니다.

1. 가설 수립 — 사용자가 공격할 수 있는 해석을 제시하라

무엇이든 묻기 전에, 세 부분으로 구성된 작업 가설을 제시하십시오. 사용자가 한 줄을 가리키며 "아니요 — 그건 틀렸습니다"라고 말할 수 있도록 각 부분을 작성하십시오. 자가 테스트: 문장이 다른 작업의 가설에서도 변경 없이 살아남을 수 있다면, 그것은 잡문입니다 — 삭제하십시오.

  1. 당신이 실제로 원하는 것 — 명시된 요청 뒤에 있는 결과, 한두 문장으로. 요청이 해결책("Redis 캐시 추가")인 경우, 그것이 해결하려는 문제("목록 페이지가 피크 시간에 느림")를 제시하십시오 — 이 둘 사이의 간격이 바로 dig가 빛을 발하는 곳입니다.
  2. 이것이 잘못될 수 있는 지점 — 이 특정 작업이 실패하거나 오해받을 가능성이 가장 높은 한두 곳: 명명된 함정("페이지 매김된 필터링 목록은 캐싱에 최악의 경우입니다 — 키 폭발, 낮은 적중률"), 절대 일반적인 위험("범위가 확장될 수 있음")이 아닙니다.
  3. 지금 시작해야 한다면, 나는 이렇게 할 것이다… — 구체적인 스케치, 한 줄에 하나의 결정, 각 줄은 다음과 같이 표시:
    • ✅ 명시적 — 사용자가 이미 말함
    • 🔍 위임됨 — 기본적으로 X를 선택하겠지만, 사용자가 승인해야 함 (기술 선택, 구조, 트레이드오프, 되돌리기 어려운 모든 것); 추천하되, 조용히 결정하지 마십시오
    • ❓ 모호함 — 기본값조차 선택할 수 없음

전체 가설을 ~15줄 이내로 유지하십시오 — 한눈에 수정 가능해야 합니다. 스케치는 미끼입니다: 구체적인 계획이 추상적인 미지의 목록보다 더 많은 수정을 끌어냅니다.

가설을 보여주기 전에, 여섯 가지 각도에서 스트레스 테스트를 하십시오: 실제 목표(요청이 명시되지 않은 다른 것을 위한 수단인가?), 범위(사용자가 당신이 모르는 무엇이 포함되거나 제외된다고 가정하는가?), 성공 기준(둘 다 성공했다고 동의할 것인가?), 실패(무엇이 먼저 깨지고, 누가 알아채는가?), 종속성 및 제약 조건(무엇이 존재해야 하거나, 변경되지 않아야 하는가?), 장기 적합성(스케치가 사용자의 더 큰 그림과 충돌하는가?). 이들은 작성해야 할 섹션이 아니라 공격 각도입니다 — 각도당 한 줄을 절대 작성하지 마십시오. 대부분의 각도는 효과가 없을 것입니다; 1부를 뒤집거나 3부를 변경할 수 있는 두세 가지 각도가 바로 질문이 나오는 곳입니다.

스트레스 테스트 후 ~8개 이상의 해결되지 않은 포크가 남았다면, 작업이 하나의 dig에 너무 큽니다 — 질문을 계속하기보다는 하위 작업으로 분할하는 것을 제안하십시오.

2. 질문 — 가장 약한 지점에서 성장한 배치 질문

가설을 제시한 다음, Claude Code에서는 AskUserQuestion을 통해, 또는 구조화된 질문 도구가 없는 플랫폼에서는 단일 메시지에 번호가 매겨진 목록으로 질문하십시오: 배치당 최대 4개 질문, 영향도 순서로 정렬하고, 각각 구체적인 옵션과 추천을 포함하십시오. 절대 한 번에 하나의 질문을 드립퍼드하지 마십시오. 이미 열려 있다고 알고 있는 모든 것을 지금 물어보십시오 — 아래 루프는 답변에서 태어난 질문을 위한 것이지, 알려진 질문을 배급하기 위한 것이 아닙니다.

모든 질문은 다음을 충족해야 합니다:

  • 질문이 테스트하는 것을 명시하십시오 — 가설의 어떤 부분, 어떤 🔍/❓ 포크인지. 가설에 연결할 수 없는 질문("다른 것 중에 제가 알아야 할 것이 있나요?"와 같은 잡문)은 체크리스트 반사 작용입니다: 제거하십시오.
  • 위 기준을 충족하십시오 — 어떤 현실적인 답변이 접근 방식을 변경해야 합니다.
  • 해결책으로 위장된 요구사항을 거부하십시오 — "캐시 추가"를 캐시를 설계하기 전에 그것이 해결하려는 느림으로 추적하십시오.

스트레스 테스트 후 🔍 또는 ❓가 하나도 남지 않았다면, 그렇게 말하고 바로 메모로 이동하십시오 — 질문이 없는 dig는 정당한 결과이지, 수행 실패가 아닙니다.

각 배치를 이 파일 끝에 있는 얕음 대 깊음에 맞춰 조정하십시오.

3. 반복 — 답변이 가설을 더 이상 움직이지 않을 때까지 발굴하라

각 답변은 이전에는 보이지 않았던 포크를 드러낼 수 있습니다. 배치 루프는 드립퍼딩이 아닙니다: 새로운 라운드는 오직 마지막 라운드의 새로운 정보에 의해서만 정당화됩니다. 각 배치 후:

  1. 가설을 소리 내어 업데이트하되, 변경된 부분만 — "X에 대한 답변이 스케치를 변경합니다: …" 움직이지 않은 것은 절대 다시 언급하지 마십시오.
  2. 후속 질문에 대한 승인 게이트 — 새로운 질문은 그 자체 내에서 (a) 어떤 답변이 이 질문을 열었는지 — 사용자의 말을 인용하거나 밀접하게 의역 — 그리고 (b) 어떤 포크를 결정하는지 명시해야만 자격을 얻습니다. 형식: "쓰기가 즉시 보여야 한다고 말씀하셨습니다 — 이는 단순 TTL을 배제하므로: 쓰기 시 무효화, 아니면 이 쿼리에 대해 캐싱을 포기하시겠습니까?" 두 슬롯을 모두 채울 수 없다면, 체크리스트를 다시 실행하는 것이지, 흐름을 따르는 것이 아닙니다: 버리십시오.
  3. 수렴은 한 라운드의 답변이 허용 가능한 후속 질문을 열지 않고 모든 🔍/❓가 해결되거나 명시적으로 연기되었을 때 발생합니다. 수렴했음을 말하고 메모로 이동하십시오 — 철저해 보이기 위해 마지막 라운드를 늘리지 마십시오. 라운드 상한이나 할당량은 없습니다: 한 라운드면 충분한 경우가 많습니다; 게이트가 결정하고, 야망이 아닙니다.
  4. 너무 큰가요? 연속된 두 라운드가 각각 닫는 만큼의 새 포크를 열었다면, 질문을 중단하십시오 — 요청은 하나의 문장에 여러 작업이 들어 있는 것입니다. 분할을 제안하고 첫 번째 하위 작업만 dig하십시오.
  5. 탈출구 — 사용자가 "시작", "start", "just do it" 또는 이에 상응하는 말을 하면, 즉시 질문을 중단하십시오: 해결되지 않은 모든 항목을 기본값과 함께 메모의 열린 항목에 포함시키고, 평소처럼 확인을 위해 메모를 제시하십시오.

4. 종합 — 명확성 메모

사용자가 ~10초 안에 확인할 수 있는 메모를 제시하십시오. 정확히 다섯 개의 섹션으로 구성됩니다:

  • 목표 — 실제 목표, 한두 문장
  • 결정 사항 — 승인된 각 결정, 한 줄씩
  • 경계 — 명시적 제외 사항
  • 성공 기준
  • 열린 항목 — 연기된 질문, 위험, 남아 있는 가정

명시적 확인을 받으십시오. 그런 다음 인계하십시오: 대규모 빌드는 계획 모드로, 작은 작업은 직접 구현으로. 메모는 다운스트림 입력입니다.

5. 정리 — 작업보다 오래 지속되는 것을 유지하라

  • 장수명 정보만: 작업 간 목표(예: 이 작업이 서비스하는 진행 중인 사이드 프로젝트), 반복되는 선호도, 도메인 배경. 작업 로컬 정보는 안 됩니다.
  • dig당 최대 1-2개의 메모리 쓰기; 기존 메모리를 먼저 확인하고 생성보다 업데이트를 선호하십시오. 플랫폼에 영구 메모리가 없습니까? 쓰기를 건너뛰십시오.
  • 명확히 교차 프로젝트인 사실: 사용자에게 전역 명령 파일(CLAUDE.md, AGENTS.md 또는 플랫폼에 해당하는 것)에 추가하도록 제안하십시오 — 직접 전역 구성을 편집하지 마십시오.
  • 메모 지속성은 기본적으로 꺼져 있습니다. 사용자가 저장을 요청하거나(또는 하네스 통합이 요청할 때), docs/clarity/YYYY-MM-DD-<slug>.md에 task/date/status 프론트매터와 다섯 개의 메모 섹션을 고정 제목으로 작성하십시오 — 그 구조가 기계가 읽을 수 있는 계약입니다.

얕음 대 깊음 — 여기서 조정하십시오

사용자 요청: "사용자 목록 페이지가 피크 시간에 3-4초 걸립니다. 여기에 Redis 캐시를 추가해 주세요 — 구현 계획을 알려주세요."

얕음 — 각각은 전문가처럼 보이지만, 캐싱이 올바른 방법인지 여부를 변경하지는 않습니다:

  • "Redis 아니면 Caffeine?"
  • "TTL은 얼마로 할까요 — 5분 아니면 30분?"
  • "전체 페이지 응답을 캐시할까요, 아니면 사용자별 항목을 캐시할까요?"

이들은 검토되지 않은 계획 위에서 매개변수를 선택합니다; 위장된 해결책을 요구사항으로 받아들입니다.

깊음 — 각각은 결정하는 포크를 명명합니다:

  • "페이지가 피크 시간에만 느린가요, 아니면 항상 느린가요?" — 항상 느리다면 쿼리 자체를 가리키며, 인덱스가 바로 고칠 수 있습니다; 피크 시간에만 느리다면 풀/동시성을 가리키며, 캐시가 거의 도움이 되지 않습니다. Redis가 올바른 프로젝트인지 자체를 결정합니다.
  • "누군가 사용자를 편집한 후, 목록이 얼마나 오래된 상태여도 괜찮습니까?" — "즉시 최신이어야 함"은 무효화가 실제 프로젝트가 되고 쿼리 최적화가 아마 더 저렴함을 의미합니다; "몇 분은 괜찮음"은 단순 TTL이 가능함을 의미합니다. 캐시 설계의 형태 — 또는 존재 자체 — 를 결정합니다.
  • "누군가 3-4초가 어디서 오는지 측정한 적이 있습니까?" — 없다면, 스케치는 Redis가 아닌 EXPLAIN과 풀 메트릭으로 시작합니다; 30분짜리 인덱스가 영구적인 일관성 비용보다 낫습니다. 작업의 1단계를 결정합니다.

합법적인 2라운드 후속 질문, 허용되는 형식:

  • "피크 시간에만 느리고 연결 풀이 최대치에 도달한다고 말씀하셨습니다 — 이는 진단을 '느린 쿼리'에서 '연결 부족'으로 옮기므로: 풀을 늘리시겠습니까, 아니면 먼저 무엇이 연결을 잡아먹고 있는지 찾으시겠습니까?"

동작을 복사하되, 내용을 절대 복사하지 마십시오. 깊은 동작은: 의도를 추적하고, 결과에 가격을 매기고, 자신의 스케치를 공격하는 것입니다. 이 작업이 아닌 작업에 이 문자 그대로의 질문을 절대 재사용하지 마십시오.

관련 스킬