Dev Workflow Skills
일상적인 개발 루프를 가속하는 스킬 모음 -- 브레인스토밍과 계획 수립부터 TDD, 디버깅, 코드 탐색, 그리고 changelog 생성 및 의존성 관리와 같은 유지보수 작업까지 지원합니다.
개요
Dev Workflow 스킬은 개발 주기 안에서 매일 함께하는 동반자입니다. 다단계 프로젝트를 관리하는 오케스트레이션 스킬이나 배포를 처리하는 클라우드 스킬과 달리, 이 스킬들은 개별 작업 수준에서 동작합니다: 에러 이해, 자료구조 선택, 테스트 계획 작성, 로그 파일 요약 등이 그 예입니다.
"TDD로 개발해줘", "이 에러 뭔지 설명해줘", "changelog 만들어줘" -- 적절한 스킬이 자동으로 활성화됩니다.스킬 카탈로그
| 스킬 | 카테고리 | 설명 |
|---|---|---|
brainstorming | 계획 | 발산/수렴 단계, 마인드매핑, 순위 매긴 결과물을 포함하는 구조화된 아이디어 도출 세션 |
writing-plans | 계획 | 마일스톤, 완료 기준, 의존성 그래프를 포함한 구현 계획 생성 |
tdd | 개발 | 테스트 주도 개발 루프: 실패하는 테스트 작성, 구현, 리팩터링, 반복 |
debugging-helpers | 디버깅 | 자동화된 가설 생성, bisect 지원, 수정 제안 |
debugging-checklist | 디버깅 | 일반적인 버그 유형(경쟁 조건, 상태 버그, off-by-one)에 대한 체계적인 단계별 체크리스트 |
git-worktrees | 버전 관리 | stash 없이 다중 브랜치 개발을 위한 병렬 git worktree 관리 |
dispatching-parallel-agents | 오케스트레이션 | 하위 작업을 병렬 에이전트에 분배하고 결과 수집 |
codebase-orientation | 탐색 | 낯선 코드베이스 파악: 디렉터리 구조, 진입점, 의존성 그래프, 핵심 추상화 |
context-compression | 컨텍스트 | 긴 대화와 대용량 파일을 핵심 정보를 유지하면서 간결한 컨텍스트 요약으로 압축 |
deep-research | 리서치 | 적대적 검증과 인용 보고서를 포함한 다중 소스 리서치 |
skill-creator | 메타 | SKILL.md, 트리거, 참조 자료를 포함하는 템플릿으로 새 CLI-JAW 스킬 생성 |
error-message-explainer | 진단 | 에러 메시지, 스택 트레이스, panic 로그를 알기 쉬운 말로 파싱하고 설명 |
config-file-explainer | 진단 | 설정 파일(YAML, TOML, JSON, INI)의 각 필드에 대한 설명 주석 추가 |
log-summarizer | 진단 | 장황한 로그 출력을 타임스탬프와 심각도별 실행 가능한 요약으로 정리 |
linter-fix-guide | 유지보수 | 린터/포매터 경고를 설명하고 코드베이스 전반에 자동 수정 적용 |
data-structure-chooser | 설계 | 접근 패턴, 제약 조건, 언어에 따라 최적의 자료구조 추천 |
dependency-install-helper | 유지보수 | 설치 실패, 버전 충돌, peer dependency 문제, lockfile 불일치 해결 |
changelog-generator | 유지보수 | Keep a Changelog / Conventional Commits 형식을 따르는 git 이력 기반 changelog 생성 |
계획 스킬
brainstorming
구조화된 아이디어 도출 세션을 실행합니다. 이 스킬은 발산 후 수렴 패턴을 사용합니다: 먼저 가능한 한 많은 아이디어를 생성한 다음, 실현 가능성, 영향력, 노력도를 기준으로 필터링하고 순위를 매깁니다.
# Start a brainstorming session
"새로운 알림 시스템을 브레인스토밍해줘"
# With constraints
"Redis 없이 실시간 알림을 구현할 방법을 브레인스토밍해줘"writing-plans
단계, 마일스톤, 파일 수준 작업, 완료 기준이 포함된 구조화된 구현 계획을 생성합니다. goal에 연결할 수 있는 마크다운 계획을 출력합니다.
# Generate an implementation plan
"OAuth2 로그인 기능 구현 계획 세워줘"
# Plan with time estimates
"이 리팩터링 플랜 만들어줘, 시간 추정도 포함해서"| 출력 섹션 | 내용 |
|---|---|
| Overview | 문제 정의, 범위, 비범위(non-goals) |
| Phases | 의존성이 있는 순서대로 정렬된 구현 단계 |
| File Plan | 파일별 변경 사항(생성/수정/삭제 주석 포함) |
| Acceptance Criteria | "완료"를 정의하는 테스트 가능한 조건 |
| Risks | 알려진 위험과 완화 전략 |
개발 스킬
tdd
전체 테스트 주도 개발 사이클을 수행합니다. Red-Green-Refactor 루프를 따릅니다: 먼저 실패하는 테스트를 작성하고, 통과시키기 위한 최소한의 코드를 구현한 다음, 테스트를 유지하면서 리팩터링합니다.
# Start TDD for a new feature
"TDD로 사용자 인증 모듈 개발해줘"
# TDD with a specific test framework
"Jest 기반으로 TDD 해줘, API rate limiter 만들어야 돼"TDD 스킬은 다음 루프를 자동으로 따릅니다:
- Red -- 원하는 동작을 설명하는 실패하는 테스트를 작성합니다
- Green -- 테스트를 통과시키기 위한 최소한의 구현을 작성합니다
- Refactor -- 중복을 제거하고, 이름을 개선하고, 헬퍼를 추출합니다
- Repeat -- 기능이 완성될 때까지 다음 동작으로 이동합니다
git-worktrees
병렬 다중 브랜치 개발을 위한 git worktree를 관리합니다. 변경 사항을 stash하거나 WIP 커밋을 하는 대신, 각 브랜치에 대해 격리된 worktree를 생성합니다.
# Create a worktree for a feature branch
"feature/notifications 브랜치로 워크트리 만들어줘"
# List active worktrees
"현재 워크트리 목록 보여줘"
# Clean up merged worktrees
"머지된 워크트리 정리해줘"dispatching-parallel-agents
독립적인 하위 작업을 병렬 에이전트에 분배하고 결과를 수집합니다. 대규모 리팩터링, 다중 파일 마이그레이션, 여러 패키지에 걸친 검사 실행에 유용합니다.
# Parallel lint + test + type-check
"lint, test, type-check 병렬로 돌려줘"
# Fan out file migrations
"이 10개 파일을 병렬로 새 API 형식으로 마이그레이션해줘"디버깅 스킬
debugging-helpers
에러 컨텍스트와 코드 구조를 기반으로 가설을 생성하고, 진단 단계를 제안하며, 수정 방안을 제시하는 자동화된 디버깅 지원 도구입니다.
# Debug a runtime error
"이 TypeError 디버깅 도와줘"
# Debug with stack trace
"이 스택 트레이스 분석해줘:
TypeError: Cannot read properties of undefined (reading 'map')
at UserList (UserList.tsx:42)"debugging-checklist
특정 버그 유형에 맞춘 체계적인 체크리스트를 제공합니다. 각 체크리스트는 가장 가능성이 높은 원인부터 낮은 원인 순으로 검증 단계를 안내합니다.
| 버그 유형 | 체크리스트 중점 |
|---|---|
| 경쟁 조건(Race condition) | 공유 상태 접근, 비동기 순서, 락 경합 |
| 상태 관리 | 오래된 클로저, 변이 vs 불변성, 리렌더 트리거 |
| Off-by-one | 루프 범위, 배열 인덱싱, fence-post 패턴 |
| 메모리 누수 | 이벤트 리스너, 클로저, 순환 참조, 타이머 |
| 네트워크 | 타임아웃, CORS, 직렬화, 재시도 로직 |
# Get a debugging checklist
"메모리 릭 디버깅 체크리스트 줘"
"race condition 체크리스트로 점검해줘"탐색 및 컨텍스트 스킬
codebase-orientation
디렉터리 구조, 진입점, 모듈 경계, 의존성 관계를 분석하여 낯선 코드베이스를 파악합니다. 간결한 오리엔테이션 문서를 생성합니다.
# Orient to a new project
"이 프로젝트 구조 파악해줘"
# Focus on a specific area
"src/api 디렉터리 구조 설명해줘"출력에 포함되는 내용:
- 주석이 달린 디렉터리 트리
- 진입점 및 빌드 설정
- 핵심 추상화와 그 관계
- 데이터 흐름 다이어그램 (해당하는 경우)
- 온보딩을 위한 권장 읽기 순서
context-compression
긴 대화 기록이나 대용량 파일 내용을 핵심 컨텍스트를 유지하면서 토큰 사용량을 줄이는 간결한 요약으로 압축합니다.
# Compress current conversation
"컨텍스트 압축해줘"
# Summarize a large file for context
"이 파일 요약해서 컨텍스트로 만들어줘"deep-research
팬아웃 웹 검색, 소스 검증, 적대적 주장 확인, 최종 인용 보고서를 통한 다중 소스 리서치를 수행합니다. 여러 소스를 교차 참조해야 하는 복잡한 기술 질문에 가장 적합합니다.
# Research a technical topic
"WebSocket vs SSE 성능 비교 리서치해줘"
# Deep dive with specific focus
"Bun vs Node.js 번들 사이즈 차이를 deep research 해줘"진단 스킬
error-message-explainer
에러 메시지, 스택 트레이스, panic 로그를 파싱한 다음 실행 가능한 수정 제안과 함께 알기 쉬운 말로 설명합니다.
# Explain an error
"이 에러 뭔지 설명해줘: ENOENT: no such file or directory"
# Explain a complex stack trace
"이 Rust panic 설명해줘:
thread 'main' panicked at 'index out of bounds: the len is 3 but the index is 5'"| 지원 형식 | 예시 |
|---|---|
| JavaScript/TypeScript | TypeError, ReferenceError, SyntaxError, unhandled rejection |
| Python | Traceback, ImportError, AttributeError, KeyError |
| Rust | panic!, unwrap 실패, borrow checker 에러 |
| Go | 런타임 panic, goroutine 트레이스, nil 포인터 역참조 |
| System | POSIX 시그널, errno 코드, segfault, OOM kill |
config-file-explainer
설정 파일을 읽고 각 필드에 용도, 유효한 값, 흔한 실수에 대한 주석을 추가합니다.
# Explain a config file
"tsconfig.json 설명해줘"
"이 docker-compose.yml 각 필드 설명해줘"
"wrangler.toml 설정 분석해줘"log-summarizer
장황한 로그 출력을 타임스탬프, 심각도, 컴포넌트별로 정리된 구조화된 요약으로 정리합니다. 이상 징후와 반복되는 패턴을 강조합니다.
# Summarize application logs
"이 로그 요약해줘"
# Filter and summarize
"ERROR 레벨 로그만 요약해줘, 최근 1시간"유지보수 스킬
linter-fix-guide
린터 및 포매터 경고를 컨텍스트에 맞게 설명한 다음 코드베이스 전반에 자동으로 수정을 적용합니다. ESLint, Prettier, Ruff, Clippy, golangci-lint 등을 지원합니다.
# Fix all linter warnings
"린터 경고 전부 고쳐줘"
# Explain a specific rule
"no-unused-vars 규칙이 왜 중요한지 설명해줘"
# Fix with scope
"src/components 폴더만 린트 수정해줘"data-structure-chooser
접근 패턴, 크기 제약, 사용 언어를 기반으로 최적의 자료구조를 추천합니다. Big-O 비교와 구현 예제를 제공합니다.
# Get a recommendation
"빈번한 삽입/삭제가 있고 정렬 상태를 유지해야 해. 어떤 자료구조가 좋아?"
# Compare options
"HashMap vs BTreeMap, 내 유즈케이스에 뭐가 맞아?"dependency-install-helper
버전 충돌, peer dependency 문제, lockfile 손상, 플랫폼별 빌드 에러를 포함한 의존성 설치 실패를 해결합니다.
# Fix install failure
"npm install 실패했어, 도와줘"
# Resolve version conflict
"peer dependency 충돌 해결해줘"
# Clean reinstall
"node_modules 완전히 초기화하고 다시 설치해줘"changelog-generator
Conventional Commits 파싱을 적용한 Keep a Changelog 형식에 따라 git 이력으로부터 changelog를 생성합니다.
# Generate changelog for latest release
"changelog 만들어줘"
# Generate for a specific range
"v1.2.0부터 v1.3.0까지 changelog 생성해줘"
# With category grouping
"changelog을 Added/Changed/Fixed/Removed로 분류해서 만들어줘"| 커밋 접두사 | Changelog 카테고리 |
|---|---|
feat: | Added |
fix: | Fixed |
refactor:, perf: | Changed |
BREAKING CHANGE: | Breaking Changes |
docs: | Documentation |
chore:, ci: | Maintenance |
메타 스킬
skill-creator
템플릿으로 새 CLI-JAW 스킬을 부트스트랩합니다. SKILL.md 오케스트레이터 파일, 트리거 패턴, 심층 가이드 문서를 위한 references/ 디렉터리를 생성합니다.
# Create a new skill
"새 스킬 만들어줘: docker-compose-helper"
# Create with trigger phrases
"'도커 컴포즈', 'docker compose'를 트리거로 하는 스킬 만들어줘"생성되는 구조:
skills/
docker-compose-helper/
SKILL.md # Orchestrator with role, triggers, and workflow
references/
compose-spec.md # Deep reference material
examples.md # Example invocations일반적인 패턴
"이 에러 explain 해줘", "TDD로 auth module 만들어줘".스킬 연계 사용
Dev workflow 스킬은 자연스럽게 조합됩니다. 일반적인 기능 개발 흐름에서 여러 스킬을 순서대로 연계하여 사용할 수 있습니다:
# 1. Brainstorm approaches
"알림 시스템 설계를 브레인스토밍해줘"
# 2. Create an implementation plan
"2번 방안으로 구현 계획 세워줘"
# 3. Develop with TDD
"TDD로 개발 시작해줘"
# 4. Debug any issues
"이 테스트 실패 디버깅해줘"
# 5. Generate changelog
"작업 내용으로 changelog 업데이트해줘"goal과 결합
더 큰 작업의 경우, 진행 상황 추적과 영속성을 위해 workflow 스킬을 goal 안에 감싸서 사용하세요:
/goal create "Implement notification system"
# The goal orchestrator will invoke brainstorming, writing-plans,
# tdd, and changelog-generator as needed throughout the lifecycle.