ワークフロー
- リポジトリの状態を調査します:
git status --short、git diff --cached、git diff。また git log --oneline -10 で既存のスタイルに合わせます。
- 何もステージングされていない場合、関連する変更を明示的なパスでステージングします(無関係または機密ファイルがある場合は
git add -A は避けてください)。.env、シークレット、.venv は決してステージングしないでください。
- 変更に明らかに無関係な関心事が含まれている場合は、それらを個別のコミットに分割します。
- 以下の形式に従ってメッセージを作成し、
git commit でコミットします。
git status を実行してコミットが成功したことを確認します。
- ユーザーが
--push を指定した場合のみプッシュします: git push を実行します(上流ブランチが設定されていない場合は git push -u origin <branch> を使用)。強制プッシュは決して行わないでください。
メッセージ形式
<type>(<optional scope>): <description>
<optional body>
<optional footer>
- タイプ:
feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。
- 説明: 命令形、小文字、末尾にピリオドなし、最大約72文字。
- スコープ: 影響を受ける領域の短い名詞(例:
cli、server、translate)。不明な場合は省略します。
- 本文: 理由を説明し、約72文字で折り返します。些細な変更の場合は省略します。
- 破壊的変更: タイプ/スコープの後に
! を追加し、BREAKING CHANGE: フッターを付けます。
ルール
- 明示的に依頼されない限り、修正、リベース、または履歴の書き換えを行わないでください。
- フックをスキップしないでください(
--no-verify)。
- フックが失敗した場合は、問題を修正して新しいコミットを作成してください。
- 変更がない場合はコミットせず、その旨を伝えてください。