커밋 메시지 작성 가이드 (한글/영어). 커밋 생성 시 자동으로 활성화되어 규칙을 준수하도록 안내합니다.
Guides git commit creation with bilingual message formatting following conventional commit rules.
/plugin marketplace add datamaker-kr/synapse-claude-marketplace/plugin install platform-dev-team-common@synapse-marketplaceThis skill is limited to using the following tools:
README.md본 스킬은 datamaker-kr organization의 Platform Dev Team에서 사용하는 커밋 메시지 작성 규칙을 안내합니다.
커밋 메시지는 한글 또는 영어로 작성할 수 있습니다.
다음 경우에는 영어로 작성할 수 있습니다:
사용자에게 언어 확인: 커밋 메시지 작성 전, 사용자가 원하는 언어가 무엇인지 확인합니다.
<타입>: <간결한 설명>
[선택] 상세 설명 (필요한 경우)
[선택] Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
커밋 메시지는 다음 타입 중 하나로 시작해야 합니다:
[티켓ID] 타입: 설명[SYN-1234] 기능: 사용자 인증 추가Claude와 협업한 커밋에는 다음을 추가합니다:
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
예시 1: 새로운 기능 추가
기능: TDD 스킬 추가
Kent Beck의 TDD 방법론과 Tidy First 원칙을 따르는 스킬 구현
- Red → Green → Refactor 사이클 가이드 포함
- 커밋 규칙 자동 검증 기능 추가
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
예시 2: 버그 수정
수정: PR 제목 생성 시 티켓 ID 보존 오류 수정
정규 표현식 패턴을 수정하여 SYN-XXXX 형식의 티켓 ID가
PR 제목 업데이트 시 유지되도록 개선
예시 3: 문서 업데이트
문서: CalVer 버전 관리 가이드 추가
YYYY.Minor.Patch 형식의 CalVer 버전 관리 체계 설명 추가
- 버전 증가 규칙 문서화
- 예시 및 확인 방법 포함
예시 4: 티켓 ID 포함
[SYN-1234] 기능: 사용자 JWT 인증 시스템 구현
JWT 기반 인증 시스템 추가
- Access Token/Refresh Token 발급 API 구현
- TokenAuthentication 미들웨어 추가
- 토큰 갱신 엔드포인트 구현
예시 5: Breaking Changes
기능: API 응답 형식 변경
API 응답을 표준화된 형식으로 변경
BREAKING CHANGE: 모든 API 응답이 다음 형식을 따름
{
"success": boolean,
"data": object,
"error": object | null
}
기존 클라이언트는 응답 파싱 로직 수정 필요
예시 1: 영어 사용
❌ feat: Add TDD skill
올바른 형식:
✅ 기능: TDD 스킬 추가
예시 2: 불명확한 설명
❌ 여러 가지 수정함
올바른 형식:
✅ 수정: PR 제목 생성 로직 개선
- 티켓 ID 보존 오류 수정
- 제목 길이 72자 제한 적용
- 특수문자 처리 개선
예시 3: 너무 장황함 (커밋 분리 필요)
❌ TDD skill을 추가하고, docs-manager도 같이 만들고, README도 업데이트하고...
올바른 형식 (3개의 커밋으로 분리):
✅ 커밋 1: 기능: TDD 스킬 추가
✅ 커밋 2: 기능: docs-manager 스킬 추가
✅ 커밋 3: 문서: README 스킬 섹션 업데이트
예시 4: 과거형 사용
❌ 기능: TDD 스킬을 추가했습니다
올바른 형식:
✅ 기능: TDD 스킬 추가
사용자가 영어로 커밋 메시지를 작성하려는 경우, 다음 규칙을 따릅니다.
Imperative mood (명령형)으로 작성
간결하고 명확하게 작성
<type>: <brief description>
[optional] Detailed explanation
[optional] Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
예시 1: 새로운 기능 추가
feat: Add TDD skill
Implement skill following Kent Beck's TDD and Tidy First principles
- Include Red → Green → Refactor cycle guide
- Add commit rule auto-verification
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
예시 2: 버그 수정
fix: Preserve ticket ID when generating PR title
Update regex pattern to maintain SYN-XXXX format ticket IDs
during PR title updates
예시 3: 문서 업데이트
docs: Add CalVer versioning guide
Document CalVer versioning scheme with YYYY.Minor.Patch format
- Include version increment rules
- Add examples and verification methods
예시 4: Breaking Changes
feat: Change API response format
Standardize API responses to consistent format
BREAKING CHANGE: All API responses now follow this format
{
"success": boolean,
"data": object,
"error": object | null
}
Existing clients need to update response parsing logic
[TICKET-ID] type: description[SYN-1234] feat: Add user JWT authentication본 스킬이 활성화되면 다음 단계를 따릅니다:
중요: 커밋 메시지 작성 전 사용자에게 언어를 확인합니다.
커밋 메시지를 한글로 작성할까요, 영어로 작성할까요? (기본: 한글)
사용자 응답에 따라:
# git status와 git diff로 변경사항 확인
git status
git diff
변경사항의 성격에 따라 적절한 타입 선택:
한글:
영어:
한글:
<타입>: <무엇을 변경했는지 간결하게>
영어:
<type>: <brief description of what changed>
공통 규칙:
복잡한 변경사항인 경우:
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
git commit -m "$(cat <<'EOF'
<커밋 메시지>
EOF
)"
datamaker-kr organization에서 사용하는 티켓 ID 형식:
SYN-XXXX: Synapse 프로젝트 관련#XXXX: GitHub Issue 번호API 변경, 데이터베이스 스키마 변경 등 하위 호환성이 깨지는 경우:
본 스킬은 다음과 같이 동작합니다:
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
Search, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, install a skill for Claude, or extend Claude's capabilities with reusable AI agent components.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.