AI 코딩에서 요구사항을 정하고 계획·구현·검토를 나누면 변경 내용을 확인하기 쉬워집니다. 영상은 Addy Osmani의 agent-skills를 사용해 개발 과정을 정리하는 예시를 소개합니다. 스킬은 절차를 안내하지만 오류가 없는 코드를 보장하지 않습니다.
설치 전에 확인할 것
공식 저장소는 Claude Code, Codex, Antigravity 등 환경별 설치 방법을 구분합니다. 영상의 플러그인 명령은 당시 Claude Code 기준이므로 현재 사용하는 도구와 버전의 안내를 확인하세요. 설치 전에 저장소와 권한을 살펴보고 기존 스킬·설정과 중복되지 않게 합니다.
원문은 오류 해결을 위해 Git 전역 설정을 바꾸는 명령도 제시합니다. 전역 설정은 다른 프로젝트에도 영향을 주므로 원인을 확인하기 전에 일괄 적용하지 말고 사용하는 환경의 공식 문제 해결 안내를 먼저 보세요.
영상에서 소개한 여섯 단계
1. 요구사항을 명확히 합니다
무엇을 만들고 누가 사용하며 어떤 결과가 나와야 하는지 정리합니다. 영상의 예시는 카페 매출 CSV를 읽어 결제 수단별 합계와 일일 보고서를 만드는 작업입니다.
/spec 카페 매출 정산 프로그램을 만들고 싶어. CSV 파일에서 당일 매출 데이터를 읽어와서 카드와 현금을 구분해 합산하고, 일일 마감 보고서를 생성하는 사양서를 작성해줘.
이 명령은 영상의 예시입니다. 현재 사용하는 도구가 해당 명령을 지원하는지 확인하고 실제 입력 형식과 오류 기준을 추가하세요.
2. 계획을 나눕니다
입력 확인, 집계, 결과 출력과 검증을 작은 작업으로 분리하고 의존 관계를 정리합니다. 사용자의 결정이 필요한 부분은 구현 전에 확인합니다.
3. 구현하고 테스트합니다
작은 기능을 구현한 뒤 예상 결과와 실제 결과를 비교합니다. 테스트 우선 접근을 선택할 수 있지만 테스트 통과만으로 모든 오류가 없다고 단정할 수는 없습니다.
4. 오류를 재현하고 수정합니다
문제가 발생한 조건과 로그를 확인한 후 원인을 좁힙니다. 수정 뒤 기존에 실패한 사례와 관련 동작을 다시 확인하세요.
5. 변경을 검토합니다
요구사항, 파일 변경, 개인정보와 권한, 테스트 결과를 살펴봅니다. 에이전트가 작성한 검토 내용도 사람이 근거와 함께 확인해야 합니다.
6. 운영 적용을 판단합니다
배포 환경과 복구 방법, 실제 데이터 접근 범위를 확인하고 필요한 승인 후 적용합니다. 영상의 /spec, /plan, /build, /test, /review, /ship은 Claude Code용 진입 명령으로 설명됩니다. 공식 저장소는 다른 도구에서 이 명령이 동일하게 보이지 않을 수 있다고 안내합니다.
기존 프로젝트라면 읽기 전용 분석과 작은 변경부터 시작하세요. 이 글은 영상과 공개 문서를 정리했으며 현재 스킬을 재설치하거나 프로그램을 실행한 결과는 아닙니다.
다음 한 걸음
내 환경에서 막힌 부분은 실행 단계와 함께 질문해 주세요. 바꿔 만든 결과도 함께 나눌 수 있습니다.