03-실전

03. 실전 — 첫 5개 명령 만들기

어떤 명령을 만들까

규칙: “내가 한 주에 3번 이상 토씨까지 똑같이 치는 자연어” 만 명령으로 만든다.

대부분의 팀이 시작할 때 만드는 5개:

1. /catchup — 직전 세션 종료 후 변경된 git 로그와 이슈를 한 페이지로 정리.
2. /pr — 현재 브랜치의 PR 본문 초안 생성.
3. /test-this — $ARGUMENTS로 받은 파일에 대해 vitest 단위 테스트 추가.
4. /explain — $ARGUMENTS 함수/파일을 다이어그램·비유로 설명.
5. /fix-lint — pnpm lint 실패 항목을 자동 수정 후 결과 리포트.

한 명령을 진화시키는 사이클

1. 자연어 1주 사용 — 매번 손으로 친다. 쓸 만한지 검증.
2. 마크다운으로 옮기기 — .claude/commands/이름.md. 인자 처리는 처음에 추가하지 말 것.
3. 인자 추가 — 같은 명령을 두 번째 시나리오에서 쓰게 되면 그때 $ARGUMENTS.
4. 권한 좁히기 — frontmatter의 allowed-tools로 최소화.
5. 스킬로 승격 — 보조 파일이 필요하거나 자동 invoke를 원하면 .claude/skills/이름/SKILL.md로 마이그레이션 (05장).

외부 컬렉션 활용

직접 만들기 전에 컬렉션을 훑는다:

• awesome-claude-code — 큐레이션 모음.
• wshobson/commands — 실무에서 검증된 명령 70+ 개.
• claude-code-templates — 카테고리별 템플릿.

다만 그대로 가져다 쓰지 말 것. 자기 리포의 컨벤션과 충돌하면 슬롭이 된다. 골격만 보고 자기 손으로 다시 적는 것이 sshh가 강조하는 원칙이다.

운영

• 명령은 git에 들어간다. 코드처럼 리뷰하라.
• “이거 더 이상 안 쓰는데” 하면 즉시 삭제. 사용 빈도가 곧 가치다.
• 한 분기마다 명령 리스트를 회고하고 절반을 삭제하는 의식을 권장(sshh 패턴).