---

name: conventional-commits description: Enforces conventional commit message and branch naming conventions with specific prefixes (feat, fix, docs, style, refactor, perf, test, chore). Use when creating git commits, suggesting branch names, reviewing commit messages, or when the user asks about git workflow.

Conventional Commits & Branch Naming

このスキルは、一貫性のあるgit commitメッセージとbranch名の作成を支援します。

Commit Message Prefix Rules

すべてのコミットメッセージは以下のprefixで始める必要があります：

Branch Naming Convention

ブランチ名も同じprefixを使用します：

フォーマット

Copy<prefix>/<short-description>

例

Copyfeat/user-authentication
fix/login-redirect
docs/api-documentation
style/prettier-formatting
refactor/user-validation
perf/database-optimization
test/auth-unit-tests
chore/dependency-updates

Commit Message フォーマット

Copy<prefix>: <subject>

<optional body>

<optional footer>

例（フルフォーマット）

Copyfeat: add user authentication system

Implement JWT-based authentication with refresh tokens.
Includes login, logout, and token refresh endpoints.

Closes #123

例（シンプル）

Copyfix: resolve login redirect issue

判断基準

変更内容に応じて適切なprefixを選択：

• ユーザーに見える新機能 → feat:
• バグ修正 → fix:
• README、コメント、ドキュメント → docs:
• コードフォーマット、空白、スタイル → style:
• 動作は同じだが実装を改善 → refactor:
• 速度・メモリなど性能改善 → perf:
• テストコード追加・修正 → test:
• ビルドツール、CI、依存関係 → chore:

迷った場合のフローチャート

Copyユーザーに見える変更？
├─ Yes → 新機能？
│   ├─ Yes → feat:
│   └─ No → fix:
└─ No → コードの変更？
    ├─ Yes → 性能向上？
    │   ├─ Yes → perf:
    │   └─ No → ロジック改善？
    │       ├─ Yes → refactor:
    │       └─ No → test:
    └─ No → ドキュメント？
        ├─ Yes → docs:
        └─ No → chore:

実行時のルール

Commit作成時

1. 変更内容を分析
2. 上記の判断基準に従って適切なprefixを選択
3. 簡潔で明確な説明を英語で記述
4. 必要に応じてbodyを追加

Branch作成時

1. 作業内容から適切なprefixを選択
2. スラッシュ区切りで短い説明を追加
3. ケバブケース（lowercase + ハイフン）を使用

例外

• 初回コミット: chore: initial commit
• マージコミット: prefix不要（自動生成されるため）
• Revert: revert: <元のコミットメッセージ>

参考資料

• Conventional Commits: https://www.conventionalcommits.org/