02-구조

02. 구조 — 파일 형식과 인자

파일 형식

---
description: "변경된 파일에 대해 PR 본문 초안을 만든다."
allowed-tools: ["Read", "Bash(git diff*)", "Bash(git log*)"]
---

# /pr

다음 단계를 따라라:

1. `git diff --stat origin/main...HEAD`로 변경 범위 파악.
2. 각 변경 파일에 대해 1줄 요약.
3. 다음 형식으로 PR 본문 출력:
   - **Why**: 한 단락
   - **What**: 불릿 5개 이내
   - **Test plan**: 체크박스 리스트

사용자 추가 지시: $ARGUMENTS

요점:

• frontmatter는 선택. 없으면 모든 도구가 사용 가능.
• $ARGUMENTS — /pr 큰 리팩터링 강조해줘 라고 부르면 큰 리팩터링 강조해줘가 치환된다.
• 본문은 그냥 마크다운. 모델이 따르는 지시문이다. 여기에 어떤 도구 호출을 권하는지, 출력 형식이 어떤지를 적는다.

디렉토리 트리 패턴

David Taylor의 Hugo 사이트 예 (sources/02-claude-code-deep/slash-commands/cloudartisan-custom-slash-commands.md):

.claude/commands/
├── posts/
│   ├── new.md           → /project:posts:new
│   ├── publish.md       → /project:posts:publish
│   └── check_links.md   → /project:posts:check_links
├── projects/
│   └── new.md
└── site/
    ├── preview.md
    └── deploy.md

네임스페이스를 도메인으로 묶는 게 모델이 어떤 명령을 골라야 할지 알아내는 데에도 도움이 된다.

권한 통합

frontmatter의 allowed-tools는 그 명령이 활성화된 동안만 적용된다. settings.json의 글로벌 화이트리스트와 머지된다 — 더 좁은 쪽이 우선. 위험한 명령(Bash(git push *))을 한 명령에서만 일시적으로 허용하고 싶을 때 유용하다.