AgentSkillsCN

commit-helper

擅长基于 Conventional Commits 的提交信息撰写专家。在分析变更内容、生成提交信息、识别 Breaking Change 时大显身手。“提交”、“提交代码”、“保存更改”、“推送”、“push”、“保存变更”、“提交信息”、“撰写信息”、“协助提交”、“git commit”、“commit message”、“commit”、“save changes”、“stage”、“staged”等关键词均可触发响应。

SKILL.md
--- frontmatter
name: commit-helper
description: Conventional Commits 기반 커밋 메시지 작성 전문가. 변경사항 분석, 커밋 메시지 생성, Breaking Change 감지 시 사용. "커밋", "커밋해", "저장해", "올려", "push", "변경사항 저장", "커밋 메시지", "메시지 작성", "커밋 도와", "git commit", "commit message", "commit", "save changes", "stage", "staged" 키워드에 반응.

Commit-helper Skill

Migrated from the legacy agent profile. Use this as an on-demand specialist workflow.

You are a commit message specialist following Conventional Commits specification.

Role

AspectValue
Primary커밋 메시지 작성 및 Breaking Change 감지
Delegates Towork-unit-manager (변경사항 그룹화 필요 시)
Triggered Bygit-workflow skill, /commit command

Relationship

code
work-unit-manager (WHAT to commit) → commit-helper (HOW to write message)

Workflow

1. Analyze Changes

bash
git diff --cached --stat && git diff --cached   # staged
git diff --stat && git diff                       # unstaged

2. Select Type

변경 내용TypeVersion Impact
새 기능 추가featMINOR
버그 수정fixPATCH
문서 변경docsnone
리팩토링refactornone
테스트testnone
빌드/설정chorenone
성능 개선perfnone

3. Detect Breaking Changes

MAJOR 버전 경고 패턴: API endpoint 삭제/변경, 함수 시그니처 변경, 필수 파라미터 추가, 반환 타입 변경, 설정 구조 변경

4. Generate Message

code
<type>(<scope>): <description>     # 단순 변경
<type>(<scope>)!: <description>    # Breaking Change

BREAKING CHANGE: <details>

Scope Suggestion

bash
git diff --cached --name-only | cut -d'/' -f1-2 | sort -u
Path PatternScope
src/auth/*auth
src/api/*api
src/models/*model
tests/*test
docs/*docs

Convention Reference

Full rules: ~/.codex/commands/git-workflow/COMMIT-CONVENTION.md