Matt Pocock의 코딩 에이전트 스킬 v1.3 업데이트 및 25개 세션 분석 프롬프트

이미지 출처: GitHub / mattpocock

타입스크립트와 AI 개발 도구 전문가인 Matt Pocock(@mattpocockuk)이 자신의 대표 오픈소스 프로젝트인 mattpocock/skills의 v1.3 릴리스 배포에 맞추어, 기존 도메인 문서 명칭을 최신 규약으로 마이그레이션하고 지난 25개 에이전트 세션의 스킬 사용 기록을 분석해 개발 워크플로우를 최적화하는 실전 프롬프트 팁을 공개했습니다.

코딩 에이전트(Claude Code, OpenAI Codex 등)의 작업 품질과 일관성을 높이기 위해 지침과 워크플로우를 모듈화하는 스킬(Skills) 생태계가 빠르게 정착되고 있습니다. 하지만 업스트림 저장소가 새 버전을 릴리스할 때 로컬 프로젝트에 적용된 기존 설정과 커스텀 수정 사항을 조율하고, 실제로 에이전트가 어떤 스킬을 유용하게 호출하고 있는지 점검하는 일은 번거로운 작업으로 남기 쉽습니다. Matt Pocock은 이러한 업데이트 및 워크플로우 점검 과정을 에이전트 자체의 진단 프롬프트로 해결하는 2단계 접근법을 제시했습니다.

1. mattpocock/skills v1.3 주요 변경점과 GLOSSARY.md 마이그레이션

이번 mattpocock/skills v1.3 릴리스(PR #1120, 커밋 006a52b)에서 가장 주목할 기술적 변화는 도메인 문서의 표준 명칭 변경입니다.

기존에 사용되던 CONTEXT.md 및 CONTEXT-MAP.md 명칭이 최신 릴리스에서 GLOSSARY.md 및 GLOSSARY-MAP.md로 공식 변경되었습니다.

• 명칭 변경의 배경: Matt Pocock은 원래 도메인 주도 설계(DDD, Domain-Driven Design)의 '바운디드 컨텍스트(Bounded Context)' 개념에 착안해 파일명을 CONTEXT.md로 명명했다고 밝혔습니다. 그러나 실제 역할이 도메인 용어집에 해당함에 따라, v1.3에서는 본래 문서 역할에 부합하도록 GLOSSARY.md 및 GLOSSARY-MAP.md로 공식 일원화했습니다.
• 영향을 받는 엔지니어링 스킬: 이번 변경은 저장소 내 주요 스킬인 domain-modeling, grill-with-docs, improve-codebase-architecture, setup-matt-pocock-skills, triage, tdd, diagnosing-bugs, ask-matt, codebase-design, wait-what, pr 전반과 루트 문서에 일괄 적용되었습니다.
• 마이그레이션 가이드: 기존 프로젝트에서 CONTEXT.md 또는 CONTEXT-MAP.md를 운용 중이었다면, git mv CONTEXT.md GLOSSARY.md(필요 시 git mv CONTEXT-MAP.md GLOSSARY-MAP.md) 명령을 통해 파일명을 직접 변경해주어야 합니다. v1.3 이후의 스킬들은 오직 GLOSSARY.md/GLOSSARY-MAP.md만을 탐색하여 참조합니다.

동시에 프로젝트의 엔지니어링 설정 스킬인 /setup-matt-pocock-skills를 통해 이슈 트래커 연동, 트리아지 라벨 규칙, docs/agents/ 하위 도메인 문서 레이아웃에 필요한 구성 변경 사항이 있는지 확인하는 단계가 필요합니다.

2. Matt Pocock이 공개한 2단계 워크플로우 최적화 프롬프트 전문

Matt Pocock이 트위터(X)를 통해 공유한 '오늘의 프롬프트(Prompt of the day)' 전문은 다음과 같습니다:

Prompt of the day:

1. Re-check mattpocock/skills for the v1.3 release. Rename CONTEXT.md to GLOSSARY.md. Check /setup-matt-pocock-skills for any required changes. Perform a diff of the skills in my repository vs Matt's.

2. Get a sense for how I use Matt's skills: scan my last 25 sessions for skill invocations. Then, recommend how this release might improve my workflow.

Enjoy v1.3, pals.

프롬프트는 크게 두 가지 핵심 단계로 구성되어 있습니다:

1. 1단계: 업스트림 정합성 확인 및 로컬 Diff 대조

   • 에이전트에게 mattpocock/skills의 v1.3 릴리스 변경 사항을 다시 확인하도록 지시합니다.
   • 프로젝트 내 CONTEXT.md를 GLOSSARY.md로 파일명을 변경합니다.
   • /setup-matt-pocock-skills 스킬을 실행해 백로그 백엔드와 트리아지 라벨 및 문서 경로 설정에 누락이나 변경 요구 사항이 있는지 점검합니다.
   • 작업자의 로컬 리포지토리에 보관된 스킬 파일들과 Matt Pocock의 최신 공식 스킬 간의 차이점(diff)을 비교 분석합니다.

2. 2단계: 최근 25개 세션 호출 분석 및 맞춤형 워크플로우 제안

   • 최근 25개의 코딩 에이전트 대화 세션 기록을 전수 조사하여 실제로 어떤 스킬이 호출(invocation)되었는지 파악합니다.
   • 분석된 실제 사용 패턴을 토대로, v1.3 릴리스의 개선 사항과 신규 기능이 작업자의 개발 워크플로우를 구체적으로 어떻게 개선할 수 있는지 맞춤형 권장 사항을 도출합니다.

3. 실무 에이전트 환경 적용 시 고려사항과 3자 Diff 전략

이 프롬프트를 실제 개발 환경에 적용할 때 실무적으로 유의해야 할 핵심 사항들이 커뮤니티 피드백을 통해 함께 논의되었습니다:

• 설치 방식에 따른 차이: mattpocock/skills는 Claude Code 플러그인 마켓플레이스를 통한 '관리형 번들(managed bundle)' 설치와 skills.sh 또는 npx skills add를 통한 '로컬 복사본(editable copy)' 설치라는 두 가지 배포 경로를 제공합니다. 마켓플레이스 번들은 자동 업데이트되지만, 로컬 프로젝트에 파일을 직접 복사해 사용하는 경우 수동 업데이트와 diff 확인이 필수적입니다.
• 로컬 패치 유실 방지와 3자 Diff(3-Way Diff): 작업자가 지난 세션들을 거치며 프로젝트 고유의 필요에 맞춰 스킬 내부를 수정한 경우, 업스트림 코드로 무작정 덮어쓰면 유용한 로컬 패치가 사라질 수 있습니다. 따라서 '이전 업스트림 버전 - 현재 로컬 수정본 - 신규 v1.3 업스트림 버전'을 대조하는 3자 diff 분석을 수행하여 의도적인 커스텀 패치를 보존하면서 v1.3 업데이트를 병합하는 것이 안전합니다.
• 스킬이 호출되지 않은 세션 분석: 단순히 스킬의 호출 횟수만 세는 것을 넘어, 에이전트가 스킬을 사용하지 않고 처음부터 수작업으로 지침을 작성하며 진행한 세션을 함께 식별하는 것이 좋습니다. 이를 통해 작업자가 아직 파악하지 못한 유용한 스킬을 발견하거나, 자주 반복되는 수작업 패턴을 새로운 스킬로 정형화할 수 있는 기회를 포착할 수 있습니다.

원문 출처

• X(트위터) @mattpocockuk 원문 포스트: Prompt of the day - skills v1.3
• GitHub mattpocock/skills 저장소: mattpocock/skills Releases & CHANGELOG