[개발 일기] AI 워크플로우(3) - 반복하는 절차를 스킬로 만들기

muchan
muchan
∙∙조회 2

AI 워크플로우 (1) - 초기 세팅에서 정리한 Claude·Codex 협업 흐름을 실제로 돌리기 위해 만든 스킬 이야기입니다.


스킬이란

Claude Code의 스킬은 특정 작업의 순서와 규칙을 파일로 묶어 둔 것입니다.
.claude/skills/<스킬 이름>/SKILL.md에 절차를 적어 두면, Claude가 그 작업을 할 때 불러와서 적힌 순서대로 진행합니다. 쉽게 말하면 AI에게 주는 업무 매뉴얼입니다.

무슨 작업이었나

워크플로에서 Codex가 끼어드는 두 지점을 각각 스킬로 만들었습니다.

css
Claude 계획 → [Codex 계획 검토] → 사람 승인 → Claude 구현
→ [Codex 변경 리뷰·테스트 작성] → Claude 검증 → PR → 사람 병합

스킬시점하는 일
codex-plan-review구현 전Codex가 작업 계획을 읽기 전용으로 검토하고 차단 이슈 / 추가 제안으로 답한다. 차단 이슈가 있으면 계획을 고쳐 다시 검토받는다
codex-verify구현 후Codex가 diff를 리뷰하고 회귀 테스트를 작성한다. Claude가 Unity로 검증하고, 실패하면 Codex가 원인을 분석한다. 재검증은 최대 2회
bash
.claude/skills/
├── codex-plan-review/
│   ├── SKILL.md          # 절차와 보고 형식
│   └── prompt.md         # Codex에게 보낼 고정 프롬프트
└── codex-verify/
    ├── SKILL.md
    └── prompts/
        ├── review-and-tests.md
        └── failure-analysis.md

스킬마다 절차(SKILL.md) 와 Codex에게 보낼 프롬프트를 따로 두었습니다.

왜 스킬로 만들었나

이 흐름은 feat·bug 이슈마다 반복됩니다. 절차를 말로만 지시하면 AI가 그때그때 조금씩 다르게 할 수 있고, Codex에게 보내는 내용이 달라지면 검토 결과도 들쭉날쭉해집니다.

그래서 프롬프트를 파일로 고정하고 {이슈번호}, {계획 초안} 같은 빈칸만 채우게 했습니다. 보내는 형식이 같으니 받는 답의 형식도 같아집니다.