git-conventions

Git Conventions スキル

Instructions

このスキルは Git 操作における共通の規則とベストプラクティスを提供します。 git-commit や git-push スキルと組み合わせて自動適用されます。

正しい git の使い方

重要: すべての git コマンドは作業ディレクトリ（カレントディレクトリ）で直接実行する。

# ✅ 正しい使い方
git status
git diff
git add src/app.ts
git commit -m "message"
git push

# ❌ 禁止: git -C を使わない
git -C /path/to/repo status
git -C /Users/user/project diff

理由:

• Claude Code は常にプロジェクトルートを作業ディレクトリとして動作する
• git -C は冗長であり、パスの誤りによるリスクがある
• シンプルで読みやすいコマンドを維持する

安全規則

絶対禁止

操作	理由
git -C <path> オプション	作業ディレクトリで直接実行すること。冗長で不要
git config の更新	セキュリティリスク
main/master への force push	共同作業者への影響
--no-verify オプション	hook をスキップすべきでない
--no-gpg-sign オプション	署名をスキップすべきでない
git reset --hard の無確認実行	データ消失リスク

--amend の使用条件

以下のすべてを満たす場合のみ使用可能:

1. ユーザーが明示的に要求、または pre-commit hook がファイルを自動修正した場合
2. HEAD コミットが現在の会話で作成された（git log -1 --format='%an %ae' で確認）
3. コミットがリモートにプッシュされていない（git status で確認）

コミットが失敗または reject された場合は、絶対に --amend を使用しない。問題を修正して新しいコミットを作成する。

機密ファイル

以下のファイルは絶対にコミットしない:

.env
.env.*
.env.local
.env.*.local
credentials.json
secrets.*
*.pem
*.key
*.p12
config/local.*

検出した場合は警告を表示し、ユーザーに確認を求める。

コミットメッセージ形式

HEREDOC 形式を使用:

git commit -m "$(cat <<'EOF'
メッセージ本文

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
EOF
)"

動詞の使い分け

動詞	用途
add	完全に新しい機能
update	既存機能の改善
fix	バグ修正
refactor	機能変更なしのコード改善
docs	ドキュメントのみの変更
test	テストのみの変更
chore	ビルド、CI、依存関係の変更

並列実行の推奨

以下の読み取り系コマンドは並列実行で効率化:

# 並列実行可能
git status
git diff
git diff --staged
git log --oneline -5
git branch -vv

Examples

安全な操作フロー

# 1. 状態確認（並列）
git status & git diff & git log --oneline -3

# 2. ステージング
git add <files>

# 3. コミット（HEREDOC形式）
git commit -m "$(cat <<'EOF'
...
EOF
)"

# 4. プッシュ前確認
git log @{u}..HEAD --oneline

# 5. プッシュ
git push

危険な操作の例（禁止）

# ❌ 禁止: hook スキップ
git commit --no-verify

# ❌ 禁止: main への force push
git push --force origin main

# ❌ 禁止: 無確認の hard reset
git reset --hard HEAD~3