Git Conventions スキル

Instructions

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

正しい git の使い方

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

bash

# ✅ 正しい使い方
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 の使用条件

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

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

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

機密ファイル

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

code

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

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

コミットメッセージ形式

HEREDOC 形式を使用:

bash

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

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

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

動詞の使い分け

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

並列実行の推奨

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

bash

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

Examples

安全な操作フロー

bash

# 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

危険な操作の例（禁止）

bash

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

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

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