Git Workflow Skill

Git Workflow Skill

📋 目次

1. 概要
2. いつ使うか
3. ブランチ戦略
4. コミット規約
5. PR管理
6. よくある問題
7. Agent連携

---

概要

このSkillは、Gitを使った開発ワークフローの全てをカバーします：

• ✅ ブランチ戦略の選択と運用
• ✅ コミットメッセージ規約（Conventional Commits）
• ✅ PR作成・レビュー・マージプロセス
• ✅ コンフリクト解決手法
• ✅ Git hooks活用
• ✅ リベース vs マージの判断基準
• ✅ 過去の失敗パターンと対策

📚 公式ドキュメント・参考リソース

このガイドで学べること: ブランチ戦略の選択、コミット規約、PR運用、コンフリクト解決、Git hooks活用 公式で確認すべきこと: 最新のGit機能、GitHub/​GitLab新機能、セキュリティベストプラクティス

主要な公式ドキュメント

• Git Documentation - Git公式ドキュメント

  • Git Book
  • Reference Manual

• GitHub Documentation - GitHub公式ガイド

  • Pull Requests
  • Actions

• Conventional Commits - コミットメッセージ規約

  • Specification

• GitLab Documentation - GitLab公式ドキュメント

  • Git Workflows

関連リソース

• Atlassian Git Tutorials - Git学習リソース
• Oh Shit, Git!?! - Git問題解決ガイド
• Git Flight Rules - Git緊急対応ガイド

---

いつ使うか

自動的に参照されるケース

• 新しいブランチを作成する時
• コミットを作成する時
• PRを作成する時
• マージコンフリクトが発生した時
• Git操作で問題が発生した時

手動で参照すべきケース

• プロジェクト開始時のブランチ戦略決定
• Git運用ルールの見直し時
• チームメンバーへのGit教育時

---

ブランチ戦略

戦略の選択

プロジェクトに応じて最適なブランチ戦略を選択：

ブランチ命名規則

<type>/<ticket-number>-<short-description>

例:
feature/​PROJ-123-add-user-authentication
bugfix/​PROJ-456-fix-memory-leak
hotfix/​PROJ-789-critical-crash-fix

詳細: guides/​04-branch-naming.md

---

コミット規約

Conventional Commits

全てのコミットメッセージは以下の形式に従う：

<type>(<scope>): <subject>

<body>

<footer>

Type一覧

詳細ガイド: guides/​05-commit-messages.md

コミット前チェックリスト

→ checklists/​pre-commit.md

---

PR管理

PR作成時

1. タイトル: コミットメッセージ形式に従う
2. 説明: テンプレートを使用 → templates/​pull-request-template.md
3. レビュワー: 適切な担当者をアサイン
4. ラベル: 種類・優先度・ステータス

PR説明テンプレート

## 概要
<!-- 何を変更したか簡潔に -->

## 変更内容
<!-- 主な変更点を箇条書き -->
-
-

## 動作確認
<!-- テスト方法・確認項目 -->
- [ ] 単体テスト実行
- [ ] 実機での動作確認
- [ ] UIテスト実行

## スクリーンショット
<!-- 必要に応じて -->

## 関連Issue
Closes #XXX

PRレビューガイド

→ guides/​06-pr-review.md

PRマージ前チェックリスト

→ checklists/​pre-merge.md

---

よくある問題

コンフリクト解決

詳細: guides/​07-conflict-resolution.md

リベース vs マージ

詳細: guides/​08-rebase-vs-merge.md

過去のトラブル事例

→ incidents/​index.md

---

Agent連携

このSkillを使用するAgents

1. branch-creator-agent

   • イシューから自動的にブランチ作成
   • 命名規則を自動適用
   • Thoroughness: quick

2. commit-validator-agent

   • コミットメッセージ検証
   • Conventional Commits準拠チェック
   • Thoroughness: quick

3. pr-reviewer-agent

   • PR自動レビュー
   • チェックリスト確認
   • Thoroughness: medium

4. conflict-resolver-agent

   • コンフリクト分析
   • 解決方法提案
   • Thoroughness: thorough

推奨Agentワークフロー

PR作成時（並行実行）

pr-validator-agent (quick) +
commit-history-checker-agent (quick) +
branch-policy-checker-agent (quick)
→ 結果統合 → PRコメント

マージ前（順次実行）

final-review-agent (thorough)
→ test-runner-agent (medium)
→ merge-safety-checker-agent (quick)
→ マージ実行

Agentパラメータ例

Task: PRの自動レビューを実行

Agent: pr-reviewer-agent
Skill: git-workflow
Thoroughness: medium
Parameters:
  - check_commit_messages: true
  - check_branch_name: true
  - check_pr_description: true
  - auto_comment: true

---

クイックリファレンス

よく使うコマンド

# 新しいfeatureブランチ作成
git checkout -b feature/​PROJ-123-description

# コミット
git add .
git commit -m "feat(scope): description"

# mainの変更を取り込む（rebase）
git fetch origin
git rebase origin/​main

# PR用にpush
git push -u origin feature/​PROJ-123-description

トラブルシューティング

---

詳細ドキュメント

Guides（詳細ガイド）

1. GitHub Flow完全ガイド
2. Git Flow完全ガイド
3. Trunk-Based Development
4. ブランチ命名規則
5. コミットメッセージ規約
6. PRレビューガイド
7. コンフリクト解決
8. Rebase vs Merge
9. Git Hooks活用
10. トラブルシューティング

Checklists（チェックリスト）

• コミット前チェックリスト
• PR作成前チェックリスト
• マージ前チェックリスト
• リリースブランチチェックリスト

Templates（テンプレート）

• PRテンプレート
• コミットメッセージテンプレート
• Issue テンプレート

References（リファレンス）

• ベストプラクティス集
• アンチパターン集
• よくある落とし穴
• Gitコマンドリファレンス
• 元に戻すコマンド集
• ブランチ復旧方法

Incidents（過去の問題事例）

• インシデント一覧
• 2024年の主要インシデント

---

学習リソース

• 📚 Pro Git Book
• 📖 Conventional Commits

---

更新履歴

このSkill自体の変更履歴は CHANGELOG.md を参照