| name | git-workflow |
| description | Git運用・ブランチ戦略・コミット規約・PR管理の包括的なガイド。ブランチ戦略の選択、コミットメッセージ規約、コンフリクト解決、Git hooks活用など、Gitに関する全ての判断基準と手順を提供します。 |
Git Workflow Skill
📋 目次
- 概要
- いつ使うか
- ブランチ戦略
- コミット規約
- PR管理
- よくある問題
- Agent連携
概要
このSkillは、Gitを使った開発ワークフローの全てをカバーします：
- ✅ ブランチ戦略の選択と運用
- ✅ コミットメッセージ規約（Conventional Commits）
- ✅ PR作成・レビュー・マージプロセス
- ✅ コンフリクト解決手法
- ✅ Git hooks活用
- ✅ リベース vs マージの判断基準
- ✅ 過去の失敗パターンと対策
📚 公式ドキュメント・参考リソース
このガイドで学べること: ブランチ戦略の選択、コミット規約、PR運用、コンフリクト解決、Git hooks活用
公式で確認すべきこと: 最新のGit機能、GitHub/GitLab新機能、セキュリティベストプラクティス
主要な公式ドキュメント
関連リソース
いつ使うか
自動的に参照されるケース
- 新しいブランチを作成する時
- コミットを作成する時
- 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一覧
| Type | 説明 | 例 |
|---|
feat | 新機能 | feat(auth): add biometric authentication |
fix | バグ修正 | fix(ui): resolve layout issue on iPad |
refactor | リファクタリング | refactor(network): simplify API client |
perf | パフォーマンス改善 | perf(images): implement lazy loading |
test | テスト追加・修正 | test(login): add unit tests for validation |
docs | ドキュメント | docs(readme): update installation steps |
chore | ビルド・設定等 | chore(deps): update dependencies |
ci | CI/CD | ci(github): add caching to workflow |
詳細ガイド: guides/05-commit-messages.md
コミット前チェックリスト
→ checklists/pre-commit.md
PR管理
PR作成時
- タイトル: コミットメッセージ形式に従う
- 説明: テンプレートを使用 → templates/pull-request-template.md
- レビュワー: 適切な担当者をアサイン
- ラベル: 種類・優先度・ステータス
PR説明テンプレート
## 概要
<!-- 何を変更したか簡潔に -->
## 変更内容
<!-- 主な変更点を箇条書き -->
-
-
## 動作確認
<!-- テスト方法・確認項目 -->
- [ ] 単体テスト実行
- [ ] 実機での動作確認
- [ ] UIテスト実行
## スクリーンショット
<!-- 必要に応じて -->
## 関連Issue
Closes #XXX
PRレビューガイド
→ guides/06-pr-review.md
PRマージ前チェックリスト
→ checklists/pre-merge.md
よくある問題
コンフリクト解決
詳細: guides/07-conflict-resolution.md
リベース vs マージ
| 状況 | 推奨 | 理由 |
|---|
| featureブランチの更新 | Rebase | 履歴を綺麗に保つ |
| mainへのマージ | Merge (Squash) | PRの履歴を保持 |
| 公開済みブランチ | Merge | 履歴改変を避ける |
詳細: guides/08-rebase-vs-merge.md
過去のトラブル事例
→ incidents/index.md
Agent連携
このSkillを使用するAgents
-
branch-creator-agent
- イシューから自動的にブランチ作成
- 命名規則を自動適用
- Thoroughness:
quick
-
commit-validator-agent
- コミットメッセージ検証
- Conventional Commits準拠チェック
- Thoroughness:
quick
-
pr-reviewer-agent
- PR自動レビュー
- チェックリスト確認
- Thoroughness:
medium
-
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
クイックリファレンス
よく使うコマンド
git checkout -b feature/PROJ-123-description
git add .
git commit -m "feat(scope): description"
git fetch origin
git rebase origin/main
git push -u origin feature/PROJ-123-description
トラブルシューティング
詳細ドキュメント
Guides（詳細ガイド）
- GitHub Flow完全ガイド
- Git Flow完全ガイド
- Trunk-Based Development
- ブランチ命名規則
- コミットメッセージ規約
- PRレビューガイド
- コンフリクト解決
- Rebase vs Merge
- Git Hooks活用
- トラブルシューティング
Checklists（チェックリスト）
Templates（テンプレート）
References（リファレンス）
Incidents（過去の問題事例）
学習リソース
更新履歴
このSkill自体の変更履歴は CHANGELOG.md を参照
