AI 칼럼

코딩@donghyeok99운영진

Agent Skills: 스펙부터 출시까지 여섯 단계로 묶은 스킬 26개

같은 모델·같은 저장소로 비교한 실험에서 446개 테스트를 끝까지 돌려 숨은 문제를 찾아낸 스킬 묶음

작업 하나가 /spec에서 /ship까지 여섯 관문을 지나요. /build에서 나온 「테스트는 나중에」에 줄이 그어진 뒤에야 GO 도장이 찍혀요.
작업 하나가 /spec에서 /ship까지 여섯 관문을 지나요. /build에서 나온 「테스트는 나중에」에 줄이 그어진 뒤에야 GO 도장이 찍혀요.
누가
Addy Osmani가 만들고 Federico Bartoli, Joan León이 함께 관리해요. AI 코딩 에이전트에게 실제 서비스 코드를 맡기는 사람을 위한 것이에요.
언제
2026년 2월 15일에 공개됐고, 최신 릴리스는 2026년 11월 18일의 0.6.17이에요.
어디서
Claude Code, Codex, Cursor, Gemini CLI, Antigravity CLI, GitHub Copilot, OpenCode 등에서 쓰고, 스킬은 내 저장소에 Markdown으로 설치돼요.

이게 불편했어요

에이전트에게 기능을 맡기면 스펙 없이 코드부터 쓰고, 테스트는 나중에 하겠다고 하고, 돌려 보지도 않은 채 다 됐다고 해요. 그래서 일을 시킬 때마다 스펙 먼저, 테스트 먼저, 리뷰 먼저라는 말을 똑같이 다시 적어야 했어요.

그래서 이렇게 풀어요

Agent Skills는 그 잔소리를 정의·계획·구현·검증·리뷰·출시 여섯 단계의 스킬로 적어 두고, 단계마다 슬래시 명령을 붙였어요. 이 모음만의 장치는 스킬마다 들어 있는 핑계 표예요. 에이전트가 단계를 건너뛸 때 흔히 대는 말과 그 반박이 미리 적혀 있고, 스킬의 끝은 테스트 통과나 빌드 출력 같은 증거를 요구해요. 스킬이 제때 불리는지 재는 평가도 저장소 안에 함께 들어 있어요.

이걸로 만든 사람들

LinkedInOm Mishra2026-06-20

같은 모델, 같은 저장소, 같은 프롬프트로 Superpowers와 Agent Skills를 나란히 돌려 기능 하나를 만들었어요. Agent Skills 쪽은 첫 코드 변경이 4분 빨랐고, 검증을 7회 하면서 마지막에 446개 테스트 전체를 돌렸어요.

The result was a 4-minute faster first code change (8 vs 12 minutes) without affecting total execution time.
GitHub@mavericksea-ai2026-07-29

이 모음의 스킬 세 개에 평가 묶음을 만들어, 모델이 바뀐 뒤에도 스킬이 약속한 대로 듣는지 쟀어요. code-review-and-quality는 그대로였고, 나머지 둘에서는 나빠진 사례가 나왔다고 표와 함께 올렸어요.

For our first report I wrote eval suites for three skills from this repo (code-review-and-quality, git-workflow-and-versioning, documentation-and-adrs)
좋아요 0 · 댓글 11 (2026-11-20 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 1

    개발자 → Claude Code

    /spec에이전트가 목표와 사용자, 핵심 기능과 완료 조건, 기술 스택, 경계를 먼저 물어요..claude/commands/spec.md
  2. 2

    Claude Code → SPEC.md

    SPEC.md 저장목표, 명령, 프로젝트 구조, 코드 스타일, 테스트 전략, 경계 여섯 영역을 적어 저장소 루트에 둬요.skills/spec-driven-development/SKILL.md
  3. 3

    SPEC.md → tasks/plan.md

    /plan → tasks/plan.md스펙을 완료 조건과 의존 순서가 붙은 작은 작업으로 쪼개요.skills/planning-and-task-breakdown/SKILL.md
  4. 4

    tasks/plan.md → Claude Code

    /build: RED → GREEN → 커밋다음 작업 하나를 골라 실패하는 테스트, 최소 구현, 전체 테스트, 빌드, 커밋 순서로 끝내고 멈춰요..claude/commands/build.md
  5. 5

    Claude Code → code-reviewer 외 페르소나 2개

    /ship: 페르소나 3개 동시 실행code-reviewer, security-auditor, test-engineer가 각자 컨텍스트에서 같은 변경을 따로 봐요..claude/commands/ship.md
  6. 6

    code-reviewer 외 페르소나 2개 → Ship Decision: GO | NO-GO

    보고서 3개 → GO | NO-GO메인 에이전트가 보고서를 합쳐 막는 문제, 권장 수정, 롤백 계획이 든 결정문 하나를 내요..claude/commands/ship.md

넣으면 이렇게 나와요

/spec저장소 루트의 SPEC.md. 이미 있으면 덮어쓰지 않고 바뀌는 부분만 SPEC-<change-slug>.md로 써요
/build auto계획을 한 번 승인하면 모든 작업을 테스트와 작업별 커밋으로 끝내고, 실패하거나 위험한 단계에서 멈춰요
/shipShip Decision: GO | NO-GO, 막는 문제, 롤백 계획
Om Mishra의 비교 실험, 같은 프롬프트와 같은 저장소검증 7회, 마지막에 446개 테스트 전체 실행

나한테 맞을까요

이럴 때 좋아요

  • 에이전트에게 실제 서비스에 들어갈 기능을 맡기는데, 단계마다 사람이 확인하고 싶을 때
  • 스펙과 테스트 없이 코드부터 나오는 것이 불안할 때
  • 출시 전에 코드 리뷰, 보안 감사, 테스트 점검을 한 번에 돌리고 싶을 때
  • 여러 에이전트 도구를 쓰는 팀이 같은 작업 순서를 맞추고 싶을 때

이건 안 돼요

  • 스킬 하나만 npx로 설치하면 저장소의 references/ 체크리스트는 따라오지 않아요(README, 이슈 #361).
  • /spec부터 /ship까지의 슬래시 명령은 Claude Code 명령이라, GitHub Copilot에서는 스킬 이름으로 불러야 해요.
  • /build auto는 작업 사이에 사람이 끼어드는 일만 줄여요. 작업 하나가 빨라지지는 않아요.
  • 직접 돌려 본 것이 아니라 README와 저장소의 명령·스킬 파일을 읽고 정리했어요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기