atomic-commits

アトミックコミット

複数の git 変更を、適切な git 履歴を維持できるよう、整理されたアトミックなコミットにまとめます。

ワークフロー

1. 変更を分析する

git status
git diff --stat
git diff

2. 変更を論理的にグループ化する

種類ごとに分類します：

• feat：新機能
• fix：バグ修正
• refactor：コードの改善
• docs：ドキュメント
• test：テストの変更
• chore：メンテナンス

3. 段階的にコミットする

論理的なコミットごとに、対象のファイルをステージングします：

git add path/to/related/files
git commit -m "feat: add user authentication"

git add path/to/other/files
git commit -m "fix: correct null check in validator"

4. プッシュする

git log --oneline -10  # Verify commits
git push origin <branch>

コミットの順序

1. ドキュメント（リスクが最も低い）
2. テスト（検証の準備）
3. バグ修正（独立した修正）
4. 機能（主な変更）
5. リファクタリング（改善）

コミットメッセージの形式

<type>(<scope>): <description>

[optional body]

種類：feat、fix、docs、style、refactor、test、chore

例

ログインページ、アバターの修正、README の更新、新しいテストに変更がある場合：

git add README.md
git commit -m "docs: update README with login instructions"

git add tests/login.test.ts
git commit -m "test: add login component tests"

git add src/components/Avatar.tsx
git commit -m "fix: correct avatar display on retina screens"

git add src/pages/Login.tsx src/components/LoginForm.tsx
git commit -m "feat: add login page with validation"

git push origin feature/login

ヒント

• 各コミットは単独でレビューできるようにします
• 各コミット後も、コードベースが正常に動作する状態を保ちます
• 迷った場合は、コミット数を減らすより増やすことを優先します
• ファイルの一部を対話的にステージングするには、git add -p を使用します

高度なパターンについては、references/advanced.md を参照してください。