https://github.com/dotoricode/prompt-grill
https://github.com/dotoricode/prompt-grill
claude-code claude-code-skill developer-tools prompt-engineering
Last synced: 12 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/dotoricode/prompt-grill
- Owner: dotoricode
- License: mit
- Created: 2026-05-10T14:31:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-11T01:54:04.000Z (about 1 month ago)
- Last Synced: 2026-05-11T03:37:36.005Z (about 1 month ago)
- Topics: claude-code, claude-code-skill, developer-tools, prompt-engineering
- Language: JavaScript
- Homepage:
- Size: 24.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ko.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# prompt-grill
[English](README.md)
흐릿한 작업 요청을 에이전트가 실제로 실행할 수 있는 구조화된 프롬프트로 바꿔주는 Claude Code 스킬. 빠진 슬롯을 질문으로 채운 뒤 XML 형식의 5슬롯 프롬프트를 만들어 냅니다.
## 왜 만들었나
매번 같은 방식으로 시간을 낭비했습니다. "이 모듈 리팩터해줘"라고 입력하면 에이전트가 추측으로 달려들고, 중요한 제약 사항을 빠트렸다는 걸 10분 후에 깨닫는 식이었습니다. 프롬프트 절반은 성공 기준이 없었고, 대부분은 핵심 제약이 빠져 있었습니다.
그래서 `prompt-grill`을 만들었습니다. 요청을 다섯 슬롯(목표, 컨텍스트, 제약, 성공 기준, 출력 형식)으로 채점하고, 빈 슬롯만 물어봅니다. 질문은 짧고 한 번에 하나씩입니다. 구조화된 프롬프트가 나올 때쯤이면 빠트렸을 내용이 이미 채워져 있습니다.
지금은 거의 매일 씁니다. 빠트릴 뻔했던 슬롯을 다섯 번 중 네 번은 잡아냅니다.
## 작동 방식
`/prompt-grill 흐릿한 요청`을 입력하면:
1. 요청을 읽고 5개 슬롯을 0~2점으로 채점합니다.
2. 코드베이스를 탐색해서 코드로 답할 수 있는 슬롯을 먼저 채웁니다.
3. 빈 슬롯이 남아 있으면 가장 약한 슬롯 하나를 질문합니다. 딱 하나만.
4. 5라운드 또는 슬롯이 모두 채워질 때까지 반복합니다.
5. XML 프롬프트를 코드 블록으로 출력합니다. 명확히 하지 않은 슬롯은 `(미지정 — 실행 중 명확히 할 것)`으로 표시합니다.
6. 이 프롬프트로 바로 실행할지, 슬롯 하나를 수정할지, 프롬프트만 받아 갈지 물어봅니다.
## 왜 XML인가
앤트로픽의 프롬프트 엔지니어링 가이드는 XML 태그를 구분된 섹션을 표시하는 가장 깔끔한 방식으로 권장합니다.
`## 제약`으로 시작하는 줄은 사용자가 붙여 넣은 내용과 혼동될 수 있습니다. `...`는 그렇지 않습니다.
실행 게이트에서 슬롯 하나를 수정할 때, 스킬은 해당 태그만 다시 씁니다. 나머지는 그대로입니다.
## 5개 슬롯
| 슬롯 | 태그 | 무엇을 담나 |
|------|-----|------------|
| 목표 | `` | 한 문장으로 된 결과물, 수식어 없이 |
| 컨텍스트 | `` | 파일, 현재 상태, 의존성, 환경 |
| 제약 | `` | 절대 조건, 비목표, 보존할 것 |
| 성공 기준 | `` | 완료 여부를 확인할 수 있는 조건 |
| 출력 형식 | `` | 결과물의 형태 (diff, 파일, 목록, 계획서…) |
## 트리거
- `/prompt-grill`
- `prompt-grill`
- "프롬프트 다듬어줘", "grill 후 변환", "AI가 알아듣게 바꿔줘"
자동 트리거는 없습니다.
## 설치
Claude Code 스킬 디렉토리에 클론합니다:
```bash
git clone https://github.com/dotoricode/prompt-grill.git ~/.claude/skills/prompt-grill
```
커스텀 경로를 쓴다면 목적지를 바꿉니다:
```bash
git clone https://github.com/dotoricode/prompt-grill.git ~/.claude-personal/skills/prompt-grill
```
이후 Claude Code에서 `/skills`를 실행합니다. 목록에 `prompt-grill`이 보이면 완료입니다.
## 스킬 동작 계약
- 한 번에 하나의 질문. 여러 개를 한꺼번에 묻지 않습니다.
- 코드가 답할 수 있는 건 코드를 먼저 읽습니다.
- 명확히 하지 않은 슬롯은 추측하지 않고 미지정으로 표시합니다.
- "지금 실행" 승인 없이는 실제 작업을 시작하지 않습니다.
## 관련 스킬
- [`grill-me`](https://github.com/mattpocock/skills) by Matt Pocock — 이 스킬이 기반으로 삼은 인터뷰 패턴.
- [`cerberus`](https://github.com/dotoricode/cerberus) — prompt-grill(헤드 1), grill-me(헤드 2), 의도 검증(헤드 3)을 하나의 3단계 검증 워크플로우로 연결한 스킬.
## 라이선스
MIT. [`LICENSE`](./LICENSE) 참고.