집

Skill

코드 검토

commit-standards

AsiaOstrich/universal-dev-skills

일반적인 커밋 표준에 따라 커밋 메시지를 작성하십시오. 사용 시점: 커밋 메시지 작성 시, git commit 실행 시, 커밋 내역 검토 시. 키워드: commit, git, message, conventional, 提交, 訊息, feat, fix, refactor.

...모든 것을 확장하십시오

업데이트 된 시간 2026년 6월 29일

# documentation # code-review # git # version-control # Code ReviewGit & Version ControlDocumentation # conventional-commits # commit-message

commit-standards에 대하여

'commit-standards' 스킬은 Conventional Commits 표준을 따름으로써 일관된 커밋 메시지 서식을 적용합니다. 이를 통해 커밋 메시지가 명확하고 간결하며 정보가 풍부하도록 보장합니다. 이 스킬은 메시지 작성에 체계적인 접근 방식을 제공함으로써 일관성이 없거나 모호한 커밋 메시지 문제를 해결하고, 더 체계적이고 이해하기 쉬운 커밋 이력을 조성합니다. 이 표준은 팀과 자동화 시스템 모두에게 명확한 버전 관리와 변경 내역 문서가 필수적인 소프트웨어 개발 프로젝트의 협업에 특히 유용합니다.

이 스킬은 커밋 메시지를 형식화하는 간단하고 직관적인 방법을 제공하도록 설계되었습니다. 'feat', 'fix', 'refactor' 등과 같은 미리 정의된 커밋 유형 세트를 사용하여 변경 사항을 효과적으로 분류합니다. 사용자는 제목, 본문, 푸터로 구성된 엄격한 형식을 따를 수 있으며, 제목 줄의 길이, 대소문자 사용, 구두점에 대한 구체적인 규칙이 적용됩니다. 또한 이 스킬은 다양한 개발 환경을 지원하기 위해 영어, 번체 중국어, 이중 언어 옵션을 포함한 다국어 커밋 메시지 형식을 지원합니다.

이 스킬은 커밋 메시지에 대해 일관되고 전문적인 접근 방식을 유지하고자 하는 개발자, 팀, 오픈소스 기여자에게 이상적입니다. 특히 코드 검토자, 버전 관리 관리자, 그리고 코드 변경 사항을 이해하기 위해 커밋 내역을 참고하는 모든 이해관계자에게 유용합니다. 이 스킬의 구성 시스템을 통해 프로젝트 선호도에 따라 유연하게 맞춤 설정할 수 있어, 다양한 워크플로우와 팀의 요구 사항에 적응할 수 있습니다.

자주 묻는 질문

커밋 메시지 언어는 어떻게 설정하나요?

프로젝트의 'CONTRIBUTING.md' 파일에서 커밋 메시지 언어를 설정할 수 있습니다. 설정이 없는 경우, 시스템은 기본적으로 영어를 사용합니다. 사용 가능한 옵션은 영어, 중국어(번체), 이중 언어입니다.

커밋 메시지가 표준을 따르지 않으면 어떻게 되나요?

이 스킬은 오류를 자동으로 강제 적용하지는 않지만, 일관성과 명확성을 위해 모범 사례를 권장합니다. 메시지가 형식을 준수하는지 확인하는 것은 팀의 몫입니다.

이 스킬을 소프트웨어 개발 이외의 프로젝트에도 사용할 수 있나요?

네, 주로 소프트웨어 프로젝트를 위해 설계되었지만, 명확한 버전 관리와 변경 사항에 대한 문서화가 필요한 모든 프로젝트에서 이 스킬을 활용할 수 있습니다.

이 스킬은 커밋 메시지에서 여러 언어를 지원하나요?

네, 이 스킬은 영어, 번체 중국어 및 이중 언어 커밋 메시지를 지원합니다. 'CONTRIBUTING.md' 파일에서 원하는 언어 설정을 선택할 수 있습니다.

이 스킬은 어떤 커밋 유형을 지원하나요?

이 스킬은 'feat', 'fix', 'refactor', 'docs', 'style', 'test', 'perf', 'build', 'ci', 'chore', 'revert', 'security' 등 다양한 커밋 유형을 지원합니다.

GitHub에서 보기

Commit Message Standards

This skill ensures consistent, meaningful commit messages following conventional commits.

Quick Reference

Basic Format

<type>(<scope>): <subject><body><footer>

Commit Types

English	中文	When to Use
`feat`	`新增`	New feature
`fix`	`修正`	Bug fix
`refactor`	`重構`	Code refactoring (no functional change)
`docs`	`文件`	Documentation only
`style`	`樣式`	Formatting (no code logic change)
`test`	`測試`	Adding or updating tests
`perf`	`效能`	Performance improvement
`build`	`建置`	Build system or dependencies
`ci`	`整合`	CI/CD pipeline changes
`chore`	`維護`	Maintenance tasks
`revert`	`回退`	Revert previous commit
`security`	`安全`	Security vulnerability fix

Subject Line Rules

Length: ≤72 characters (50 ideal)
Tense: Imperative mood ("Add feature" not "Added feature")
Capitalization: First letter capitalized
No period: Don't end with a period

Detailed Guidelines

For complete standards, see:

Conventional Commits Guide
Language Options

Examples

✅ Good Examples (English)

feat(auth): Add OAuth2 Google login supportfix(api): Resolve memory leak in user session cacherefactor(database): Extract query builder to separate classdocs(readme): Update installation instructions for Node 20

✅ Good Examples (中文)

新增(認證): 實作 OAuth2 Google 登入支援修正(API): 解決使用者 session 快取記憶體洩漏重構(資料庫): 提取查詢建構器為獨立類別

✅ Good Example (Bilingual)

feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。Implement Google OAuth2 authentication flow for user login.實作 Google OAuth2 認證流程供使用者登入。Closes #123

❌ Bad Examples

fixed bug                    # Too vague, no scopefeat(auth): added google login  # Past tenseUpdate stuff.                # Period, vagueWIP                          # Not descriptive

Body Guidelines

Use the body to explain WHY the change was made:

fix(api): Resolve race condition in concurrent user updatesWhy this occurred:- Two simultaneous PUT requests could overwrite each other- No optimistic locking implementedWhat this fix does:- Add version field to User model- Return 409 Conflict if version mismatchFixes #789

Breaking Changes

Always document breaking changes in footer:

feat(api): Change user endpoint response formatBREAKING CHANGE: User API response format changedMigration guide:1. Update API clients to remove .data wrapper2. Use created_at instead of createdAt

Issue References

Closes #123    # Automatically closes issueFixes #456     # Automatically closes issueRefs #789      # Links without closing

Configuration Detection

This skill supports project-specific language configuration.

Detection Order

Check CONTRIBUTING.md for "Commit Message Language" section
If found, use the specified option (English / Traditional Chinese / Bilingual)
If not found, default to English for maximum tool compatibility

First-Time Setup

If no configuration found and context is unclear:

Ask the user: "This project hasn't configured commit message language preference. Which option would you like to use? (English / 中文 / Bilingual)"
After user selection, suggest documenting in CONTRIBUTING.md:

## Commit Message LanguageThis project uses **[chosen option]** commit types.<!-- Options: English | Traditional Chinese | Bilingual -->

Configuration Example

In project's CONTRIBUTING.md:

## Commit Message LanguageThis project uses **English** commit types.### Allowed Typesfeat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security

License: CC BY 4.0 | Source: universal-dev-standards

모든 파일

3개 파일

SKILL.md 4.3k

보기

conventional-commits.md 4.6k

보기

language-options.md 3k

보기

commit-standards 설치

스킬 파일을 다운로드하여 .claude/skills/ 디렉터리에 압축을 풀어주세요.

ZIP 다운로드

저장소를 클론하고 스킬 파일을 프로젝트에 복사하세요.

git clone https://github.com/AsiaOstrich/universal-dev-skills/blob/main/skills/commit-standards/SKILL.md # Copy SKILL.md to your .claude/skills/ directory

복사

빠른 설정: skill 폴더를 .claude/skills/로 복사하면 Claude가 해당 스킬을 자동으로 감지하여 사용합니다.

저장소 AsiaOstrich/universal-dev-skills