Git Workflow スキル

コミットメッセージ形式

code

<type>(<scope>): <日本語で50文字以内の説明>

<body: 変更点を箇条書き>

<footer: Closes #番号 等>

Co-Authored-By: Claude <noreply@anthropic.com>

タイプ:

タイプ	用途	例
`feat`	新機能	feat(auth): ログイン機能を追加
`fix`	バグ修正	fix(timer): タイマー停止問題を修正
`refactor`	リファクタリング	refactor(utils): ヘルパー関数を整理
`docs`	ドキュメント	docs(readme): セットアップ手順を追加
`style`	コードスタイル	style: フォーマットを統一
`perf`	パフォーマンス	perf(render): 描画速度を最適化
`test`	テスト	test(api): APIテストを追加
`chore`	ビルド・設定	chore(deps): 依存関係を更新
`ci`	CI/CD	ci(github): ワークフローを追加

スコープ例: コンポーネント名(header, modal)、機能名(auth, timer)、レイヤー名(api, ui)

Working Documents参照によるスコープ自動決定

コミット作成時、Working Documentsが存在する場合は自動参照します。

スコープの自動抽出

•現在のブランチからIssue番号を抽出（例: fix/#123-xxx → 123）
•docs/working/ ディレクトリで該当Issue番号のWorking Documentsを検索
•design.md の「変更対象ファイル」セクションから主要な変更箇所を抽出
•
スコープを自動決定:
- •単一機能の場合: 機能名をスコープに使用（例: auth, timer）
- •複数機能の場合: 最も影響が大きい機能をスコープに使用
- •共通UIの場合: ui をスコープに使用

動作例

bash

# ブランチ: fix/#123-login-validation
# Working: docs/working/20260205_123_ログインバリデーション修正/design.md
# → design.mdから「app/auth/login/page.tsx」を検出
# → スコープ: auth

git commit -m "fix(auth): ログインバリデーションを修正"

フォールバック

Working Documentsが存在しない、またはスコープが自動決定できない場合は、従来通りファイルパスから判断します。

コミット手順

bash

# 1. 変更確認
git diff --staged --stat && git diff --staged

# 2. コミット（複数行はHEREDOC使用）
git commit -m "$(cat <<'EOF'
fix(auth): ログインバリデーションを修正

- メールアドレスの正規表現を改善
- エラーメッセージ表示を追加

Closes #123

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

セマンティックバージョニング

MAJOR.MINOR.PATCH — package.jsonのversionフィールドを更新。

変更種別	バージョン	コマンド
破壊的変更	MAJOR	`npm version major`
新機能	MINOR	`npm version minor`
バグ修正	PATCH	`npm version patch`

リリースノート形式

markdown

# v0.6.0 (2026-02-01)

## 追加
- 新機能の説明

## 修正
- バグ修正の説明

## 変更
- 既存機能の変更

リリースノート自動生成

Git logからコンベンショナルコミット形式のコミットを抽出し、Markdown形式のリリースノートを自動生成します。

bash

# 前回のタグから現在までの変更を抽出
uv run scripts/generate-release-notes.py --from v0.10.0 --version v0.11.0 --output RELEASE_NOTES.md

# package.jsonのversionも更新
uv run scripts/generate-release-notes.py --from v0.10.0 --version v0.11.0 --update-package-json --output RELEASE_NOTES.md

# 2つのタグ間の差分
uv run scripts/generate-release-notes.py --from v0.9.0 --to v0.10.0 --output RELEASE_NOTES_0.10.0.md

機能:

•コンベンショナルコミット形式の自動パース（feat:, fix:, refactor: 等）
•カテゴリ別に分類（追加/修正/変更/その他）
•package.jsonのversionフィールド自動更新（オプション）

デプロイ

デプロイ前チェック:

bash

npm run lint && npm run build && npm run test

Vercel: git push origin main で自動デプロイ Firebase Hosting: npm run build && firebase deploy --only hosting

ルール

•コミットメッセージは日本語
•1コミット = 1つの論理的変更
•mainブランチへの直接コミット禁止
•デプロイ前に必ずテスト実行