mattpocock/skills

해결하는 문제

이 프로젝트는 AI 코딩 에이전트가 소프트웨어 개발에서 흔히 발생하는 실패 패턴을 방지하기 위해 조합 가능한 소규모 '스킬'(프롬프트 기반 지침)의 컬렉션을 제공합니다. TDD, 도메인 모델링, 체계적인 디버깅과 같은 엄격한 공학적 원칙을 AI 지원 개발 프로세스에 적용함으로써 '바이브 코딩'을 넘어서는 것을 목표로 합니다.

작동 방식

이 스킬들은 Claude Code나 Codex와 같은 코딩 에이전트에 설치 가능한 지침으로 구현됩니다. 사용자가 호출하는 스킬(워크플로우를 조율)과 모델이 호출하는 스킬(재사용 가능한 엄격함을 제공)로 분류됩니다.

주요 워크플로우는 다음과 같습니다:

• 일치성: 코드 작성 전에 에이전트가 요구사항을 이해하고 있는지 확인하기 위해 '그릴 세션'(/grill-me)을 사용합니다.
• 공유 언어: 인간과 AI 간의 공통 도메인 모델을 구축하기 위해 CONTEXT.md 파일을 생성하여 부가적인 설명과 토큰 사용량을 줄입니다.
• 피드백 루프: /tdd 스킬을 통해 빨강-초록-리팩터링 루프를 구현하여 코드의 정확성을 보장합니다.
• 아키텍처: /improve-codebase-architecture와 같은 도구를 사용해 모듈의 깊이를 높이고 소프트웨어 엔트로피를 줄일 기회를 탐색합니다.

대상 사용자

AI 코딩 에이전트를 사용하며 높은 코드 품질, 아키텍처의 무결성, 에이전트와의 정확한 일치를 유지하고자 하는 소프트웨어 엔지니어.

주요 특징

• 엔지니어링 중심 접근법: TDD, ADR, 코드베이스 설계 원칙을 에이전트 워크플로우에 직접 통합합니다.
• 유연한 설치: Claude Code용 매니지드 번들 또는 다른 에이전트용 skills.sh를 통해 편집 가능한 파일을 지원합니다.
• 도메인 모델링: CONTEXT.md에서 용어를 명확히 하고 공통된 어휘를 유지하기 위한 도구를 제공합니다.
• 포괄적인 툴셋: 트리아주, 사양 생성, 버그 진단을 위한 전용 스킬은 물론, 인간 전용 작업용 인터랙티브한 bash 위저드 생성 기능도 포함합니다.