git-workflow

Git ワークフロースキル

対象外

リリース：github-release。BLOCKED-PR の診断：github-project。

GitHub 専用です。 ブランチとコミットのセクション以降にあるすべてのもの（pr-status.sh、pr-merge.sh、マージゲート、レビューのスレッド）は、GitHub GraphQL を使用します。GitLab のマージリクエストに対応する glab 呼び出しは、references/pull-request-workflow.md § GitLab: the same gate with glab に記載されています。

重要なルール（必ず守ること）

1. main に直接プッシュしない — 必ず PR を作成してください。
2. すべてのスレッドが解決する前にマージしない（references/pull-request-workflow.md）。
3. 指示がない限り、スカッシュしない — アトミックなコミット、署名、二分探索を維持します。
4. コマンド出力を貼り付けずに「テスト済み／検証済み／動作中」と言わない — そうでなければ、その旨を伝えてください。
5. インストール済みのスキル／プラグインのキャッシュパス（~/.claude/skills/、~/.claude/plugins/cache/、**/.bare/**）を編集しない — 必ずリポジトリのワークツリーを使用し、pwd で確認してください。
6. 強制プッシュは --force-with-lease を使う場合に限る — 通常の --force は使わないでください。
7. リベースの前にコミットする — add → commit → fetch → rebase → push（作業ツリーに変更があると中断されます）。
8. 論評を加えない — 変更内容を述べ、良し悪しは評価しないでください（references/no-editorializing.md）。

参照ファイル

参照先	内容のトリガー
references/commit-conventions.md	Conventional Commits、DCO サインオフ
references/pull-request-workflow.md	PR マージゲート、署名付きリベース、インライン提案を含むレビューの投稿
references/ci-cd-integration.md	CI の監視、Git ミラー
references/advanced-git.md	リベース（非対話型の rebase -i を含む）、チェリーピック、二分探索、スタッシュ、ワークツリー、reflog、プッシュ／フェッチのハング（SSH mux）、スクリプトでの Git 出力の解析（ユーザー設定に左右されない diff／log／status 出力を固定するフラグ）、シングルブランチクローンでの単一ブランチのフェッチ（refspec）
references/github-releases.md	→ github-release スキル
references/git-hooks-setup.md	フックフレームワーク、ステージごとのフック
references/claude-code-hooks.md	settings.json のマージゲート、キャッシュパスの拒否、自動 lint
references/code-quality-tools.md	shellcheck、shfmt、git-absorb、difftastic
references/merge-gate-watcher.md	ゲート待機、ハーネスによって強制終了されたウォッチャー、マージドライバーのループ、チェックの分類、古い SHA に対する再実行
references/spec-cleanup.md	ベースブランチからの計画成果物の整理
references/no-editorializing.md	自画自賛しない、当然の結果を説明しない

Conventional Commits

<type>[scope]: <description>

feat は MINOR、fix は PATCH です。タイプの一覧と DCO サインオフについては references/commit-conventions.md を参照してください。 破壊的変更：タイプの後に ! を付けるか、フッターに BREAKING CHANGE: を記載します。 ブランチ：feature/TICKET-123-description、release/1.2.0

フックの検出

ls lefthook.yml .lefthook.yml captainhook.json .pre-commit-config.yaml .husky/pre-commit 2>/dev/null || echo "No hooks"

フレームワークごとのインストールコマンドは references/git-hooks-setup.md を参照してください。

PR のマージ要件

マージする前に、現在のヘッドでスレッドが解決済みで、CI が成功し（アノテーションを含む）、リベースと署名が完了し、レビュー済みであることを確認します。レビューは人間、ボット、または pr-merge.sh --self-reviewed を使った作成者が行います。レビューは必須ですが、ボットによるレビューは必須ではなく、実際に進行中の場合に限って待機します。リベースのみで署名済みの場合は、git merge --ff-only を使います。

検証

./scripts/verify-git-workflow.sh /path/to/repository
# Gate state, next action:
./scripts/pr-status.sh [-R owner/repo] [PR] [--json] [--watch]
# Merge; refuses when the gate is shut:
./scripts/pr-merge.sh [-R owner/repo] [PR] [--dry-run|--self-reviewed]
# Many PRs (`owner/repo N` per line) to merge; stops on any NEXT it does not handle:
./scripts/pr-sweep.sh [--interval SEC] [--timeout SEC] [--attention FILE] LISTFILE
# What a repository expects, before the first artifact:
./scripts/repo-contribution-preflight.sh [--repo <dir>] [--section docs|templates|packaging|ci|tools]
# Which copy is installed here (every script answers this):
./scripts/pr-status.sh --version

---

コントリビューション： https://github.com/netresearch/git-workflow-skill