# Yellow Seed Agentusagewidget Git Commit > 適切な粒度でのコミット作成 - Skill: `tomevault-io/yellow-seed-agentusagewidget-git-commit` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/yellow-seed-agentusagewidget-git-commit` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/yellow-seed-agentusagewidget-git-commit/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/yellow-seed-agentusagewidget-git-commit --- # 適切な粒度でのコミット作成 変更内容を分析し、機能や目的ごとに適切な粒度で分割して複数のコミットを作成します。各コミットはConventional Commits形式の日本語メッセージで作成されます。 ## コミット粒度の原則 ### 良いコミット粒度の特徴 | 特徴 | 説明 | | ------------ | ---------------------------------------- | | 単一目的 | 1つのコミットは1つの目的を持つ | | 機能的独立性 | 独立してレビュー・revert可能 | | テスト可能 | コミット時点でテストが通る | | 適切なサイズ | 通常は数十～数百行程度 | | 自己完結 | コミットメッセージで変更内容が理解できる | ### 避けるべきコミット | タイプ | 問題点 | | -------------- | ------------------------------------ | | 巨大コミット | レビューが困難、問題特定が難しい | | 混合コミット | 複数の無関係な変更が含まれる | | 不完全コミット | テストが失敗する、ビルドエラーがある | | 曖昧コミット | 何をしたのか不明確 | ## コミット分割の判断基準 ### 分割すべき変更 以下の異なる種類の変更は**別々のコミット**に分割します： 1. **機能追加** vs **バグ修正** vs **リファクタリング** 2. **ドキュメント** vs **実装コード** 3. **テストコード** vs **プロダクションコード**（機能が複雑な場合） 4. **設定ファイル** vs **アプリケーションコード** 5. **異なる機能・モジュール**の変更 6. **依存関係追加** vs **コード変更** ### まとめて良い変更 以下は**同じコミット**にまとめます： 1. **関連するテストとコード**（単純な機能の場合） 2. **同じ機能の関連ファイル**（モデル、ビュー、コントローラーなど） 3. **同時に必要な変更**（APIとそのクライアント） 4. **型定義とその使用箇所** 5. **リネームとその参照更新** ## コミット作成手順 ### 1. 変更内容の分析 ```bash # 現在の変更を確認 git status # 詳細な差分を確認 git diff # ステージングされた変更を確認 git diff --cached ``` ### 2. セルフレビュー（ブランチ差分チェック） **コミット前の必須プロセス**として、変更内容を客観的に確認します。 ```bash # self-review スキルを使用 "コミット前にセルフレビューをお願いします" ``` 詳細な手順とチェックリストは [self-review/SKILL.md](../self-review/SKILL.md) を参照してください。 ### 3. 変更の分類 変更されたファイルを以下のカテゴリに分類： - **機能追加**: 新しい機能の実装 - **バグ修正**: 既存の不具合修正 - **リファクタリング**: 動作を変えない改善 - **ドキュメント**: READMEやコメントの更新 - **テスト**: テストコードの追加・修正 - **設定**: 設定ファイル、環境変数の変更 - **依存関係**: ライブラリの追加・更新 ### 4. コミット順序の決定 以下の順序でコミットを作成すると理解しやすい： 1. **基盤・設定**: 依存関係追加、設定ファイル変更 2. **リファクタリング**: コード構造の改善 3. **バグ修正**: 既存の問題修正 4. **機能追加**: 新機能の実装 5. **テスト追加**: 新しいテストの追加 6. **ドキュメント**: 説明文書の更新 ### 5. 部分的なステージングとコミット ```bash # ファイル単位でステージング git add path/to/file1.py path/to/file2.py # ファイルの一部をインタラクティブにステージング git add -p path/to/file.py # コミット実行 git commit -m "$(cat <<'EOF' feat: 機能の要約 詳細な説明... 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 EOF )" ``` ## コミットメッセージ形式 各コミットは**commit-message**スキルの形式に従います： ``` :