대충 작성한 프롬프트에 「의도 확인해줘」라고 덧붙이는 것만으로 AI가 내용을 구체화하는 Claude Code Skill

이 기사의 요약 (3줄)

한 일: 「의도 확인해줘(認識合わせして)」라고 덧붙이는 것만으로 AI가 AskUserQuestion을 통해 내용을 구체화하는 Claude Code Skill을 만들어 일상 운영에 도입했다 -
결론: 프롬프트는 대충 작성해도 된다. AI가 의도를 이끌어내게 하는 편이 인지 부하(Cognitive Load)가 낮아지고 재작업도 줄어든다 -
대상 독자: AI에게 의뢰할 때 프롬프트를 정성스럽게 쓰는 것이 귀찮은 사람

대상 독자

• AI 코딩 툴에 의뢰할 때, 매번 프롬프트를 정성스럽게 쓰는 것이 귀찮은 사람
• 대충 던지면 AI가 미궁에 빠진다는 것은 알고 있지만, 전제 조건이나 제약 사항을 매번 작성하고 싶지 않은 사람
• Claude Code를 사용해 본 적이 있는 사람

「귀찮으니까 대충 던진다」 → 「AI가 폭주한다」 → 「결국 정성스럽게 다시 쓴다」의 루프에 지친 사람을 위한 기사이다.

배경: 정성스럽게 쓰는 것도, 대충 던지는 것도 둘 다 힘들다

Claude Code는 편리하지만, 의뢰가 대충 이루어지면 AI가 해석을 임의로 채워 제멋대로 달려 나간다.

의도와 다른 방향으로 진행되어 재작업이 발생하거나, 혹은 너무 안전한 쪽으로 치우쳐 아무것도 하지 않는 상황 중 하나가 되기 쉽다.

이를 방지하기 위해 사용자 측에서 프롬프트를 정성스럽게 쓰려고 하면,

매번 「목적」 「제약 사항」 「결과물」 「영향 범위」 「허용하지 않는 것」을 작성해야 한다.

작성하는 데 시간이 걸릴 뿐만 아니라, 작성하는 도중에 무엇을 전달하고 싶었는지 잊어버리기도 한다.

결국, 「정성스럽게 쓰는 것도 대충 던지는 것도 둘 다 힘들다」는 것이다.

그래서, 프롬프트를 대충 던진다 → AI가 선택지를 가지고 질문해 온다 → 선택하기만 하면 의도가 확정된다라는 운영 방식으로 완전히 전환했다.

의도를 언어화하는 부하를 AI 측으로 이양하는 형태다.

메커니즘은 ask-question이라는 Claude Code Skill로 정리했다
(처음에는 CLAUDE.md에 직접 작성했으나, 컨텍스트 압박을 피하기 위해 Skill로 분리했다).

「의도 확인해줘」라고 덧붙이기만 하면 된다

일상적인 문구로 격상시켰다

ask-question의 트리거에는 「의도 확인해줘(認識合わせして)」 「구체화해줘(詰めて)」 「ask-question」 세 가지를 등록해 두었다.

실제로 사용하는 것은 거의 「의도 확인해줘」이다.

의뢰의 서두 또는 말미에 「의도 확인해줘」라고 덧붙이는 것만으로 Skill이 기동하며, AI 측에서 결정 트리(Decision Tree)를 상류부터 한 문제씩 구체화해 온다.

프롬프트 본체는 대충 작성해도 된다.

로그를 적당히 정리해줘. 의도 확인해줘

이렇게 하면 AI 측에서

「로그 레벨의 입도는?」

「출력 대상은?」

「포맷은?」

「로테이션 방침은?」

을 차례로 물어온다.

그 후에는 선택지를 고르기만 하면 된다.

업무 도메인에서도 동일하게 적용

특정 업무 도메인(결제 처리, 배치 집계 등 도메인 고유의 제약이 많은 영역)에서도 동일한 운영 방식으로 돌리고 있다.

AI가 해당 도메인을 모르는 만큼, 선택지가 「빗나가는 것」도 있다.

그럴 때는 Other(자유 입력)로 보충하거나, 선택지를 고른 뒤에 보충 조건을 전달하면 된다.

완벽한 선택지를 기대하는 것이 아니라, 선택지를 기점으로 대화를 진행하는 것이 요령이다.

「대충 작성한 프롬프트」를 의도적으로 선택하는 이유

머릿속의 의도를 모두 언어화하는 것은 비용이 많이 든다.

작성하는 도중에 무엇을 전달하고 싶었는지 잊어버리는 경우도 있다.

대충 프롬프트를 던져 AI에게 질문하게 하면, 사용자는 「질문을 받았을 때 생각하기」만 하면 된다.

처음부터 완벽하게 의도를 언어화하는 것보다, 질문을 받은 타이밍에 부분적으로 판단하는 것이 인지 부하가 낮다.

이는 「인간이 AI에게 가르치는」 협업이 아니라, 「AI가 인간으로부터 이끌어내는」 협업 모델이다.

다음 절에서 다룰 grill-me라는 공개 Skill이 화제가 된 것도, 많은 사람이 같은 감각을 가지고 있었기 때문이라고 생각한다.

grill-me 스킬을 알아두기

ask-question Skill은 mattpocock/skills의 grill-me를 기반으로 하고 있다.

grill-me는 AI 업계에서 화제가 된 Claude Code용 공개 Skill로,

「사용자의 계획을 철저하게 캐물어서, 공통 인식을 달성할 때까지 질문을 거듭하는 것」에만 특화되어 있다.

리포지토리에서 배포되고 있으므로, 파일을 자신의 ~/.claude/skills/에 두면 그대로 동작한다.

화제가 되는 것을 보고 채용을 검토했다.

ask-question은 grill-me를 기반으로 하되, Skill 내부에서 AskUserQuestion을 적극적으로 사용하도록 유도하면서,

일상적인 운영에서 사용하는 트리거 워드(「의도 확인해줘」 등)를 추가한 것이다.

AskUserQuestion: 선택지가 포함된 질문이라는 도구

AskUserQuestion란

AskUserQuestion는 Claude Code 표준의 「선택지를 가지고 질문하기 위한 도구」다.

AI가 평문으로 "어떻게 할까요?"라고 묻는 대신,

• 질문 문구
• 2~4개의 선택지 (레이블 + 설명)

을 구조화하여 던진다.

사용자 측은 선택지에서 고르는 것만으로 답변이 완료된다.

"Other (자유 입력)"가 자동으로 추가되는 사양이기 때문에, 예상치 못한 방침도 사용자 측에서 전달할 수 있다.

실제 사용 사례를 텍스트 모크(Text Mock)로 나타내면 다음과 같다.

Q: 로그 출력 위치는 어디로 할까요?
[1] 표준 출력 + 파일 (Recommended)
→ 로컬 확인과 영속화를 양립. 가장 무난함
...

AI 측에서 "선택지를 나열하기"와 "권장안 제시하기"까지 완료되어 있으므로, 사용자는 선택만 하면 의사결정을 할 수 있다.

ask-question이 일상적인 운영에 녹아들 수 있는 이유는, 이 도구 덕분에 의사결정의 문턱이 단번에 낮아지기 때문이다.

구체적인 효과가 나타나는 지점은 다음 세 가지다.

• 사용자의 인지 부하(Cognitive Load)가 낮아짐: 평문으로 "어떻게 할까요?"라고 질문을 받으면, 사용자는 머릿속으로 선택지를 나열한 뒤 답변을 생각해야 한다. 선택지를 제시하면 나열은 이미 AI 측에서 끝난 상태이므로, 고르기만 하면 된다.
• 권장안과 함께 물을 수 있음: 각 선택지에는 description (해당 안을 선택했을 때 어떤 일이 일어나는지 · 트레이드오프(Trade-off))를 적을 수 있다. 맨 앞에 (Recommended)가 붙은 권장안을 배치하면, 사용자는 "권장안으로 할지, 아니면 다른 것을 할지"만 판단하면 된다.
• "Other"라는 탈출구가 있음: 도구 사양으로서 "Other (자유 입력)"가 자동으로 추가된다. AI가 예상하지 못한 방침도 사용자가 전달할 수 있으므로, 권장안을 강하게 제시하더라도 사용자의 재량은 상실되지 않는다.

효과가 없는 케이스

AskUserQuestion은 질문 1개당 선택지가 2~4개까지라는 제약이 있다.

망라성(Comprehensiveness)이 필요한 질문 (예: API 후보가 30개인 경우)에는 적합하지 않다.

그러한 질문은 Skill 측에서 "코드를 먼저 읽고, 유력 후보를 3개로 좁힌 뒤에 제시"하는 것과 같은 전처리가 필요하다.

운용해 본 결과의 효과와 배움

수치로 측정한 것은 아니지만, 체감되는 효과는 다음과 같다.

• 의뢰부터 구현 착수까지의 시간이 단축됨: 프롬프트를 작성하는 시간이 줄어든 비중이 크다.
• 재작업(Retake)이 줄어듦: AI가 "중요한 분기점"을 놓치지 않고 질문해 준다.
• 문서화가 부수 효과로 진행됨: Skill이 결정 사항을 Markdown으로 정리해주므로, 그대로 설계 메모가 된다.

잘 풀리지 않는 케이스도 있다.

• 자명한 의뢰에도 질문을 하는 경우가 있음: "README의 오타를 수정해줘"와 같은 명백한 의뢰에도 가끔 확인을 요청하여 번거로울 때가 있다. Skill 내에 "자명한 의뢰는 확인 불필요"라고 적어두었지만, 판단은 AI에게 맡겨져 있어 편차가 발생한다.
• 질문의 템포가 무겁다고 느끼는 사람도 있음: 팀에 도입한다면 개인의 취향에 맞춰 On/Off 할 수 있도록 만드는 것이 좋아 보인다.

요약

• 대충 작성한 프롬프트에 「의도 확인해줘」라고 덧붙이는 것만으로 AI가 의도를 끌어내 준다.
• 완벽하게 언어화하는 것보다 질문을 받았을 때 판단하는 것이 인지 부하가 낮다.
• AskUserQuestion의 선택지 제시를 통해 의사결정의 문턱이 한 단계 낮아진다.

의도의 언어화를 AI 측에 위임하는 운용 방식은, 익숙해지면 이전으로 돌아갈 수 없다. 프롬프트를 정성스럽게 쓰는 시간이 그대로 "사고의 여백"이 된다.

ask-question Skill 전문

Appendix: 실제로 운용 중인 ~/.claude/skills/ask-question/SKILL.md의 내용. 복사해서 그대로 사용할 수 있다.

ask-question/SKILL.md (클릭하여 펼치기)

---
name: ask-question
description: |
...

참고

• mattpocock/skills - grill-me: 원안이 된 Skill
• Claude Code 공식 문서: AskUserQuestion 도구 / Skill 기능 사양

Discussion