GitLabマージリクエストテンプレート
GitLab固有の機能(/label、/milestone、/assignクイックアクション)に対応したマージリクエストテンプレート。
Standard Templates
詳細な説明
GitLabマージリクエストテンプレート
GitLabのマージリクエスト(MR)テンプレートはGitHubのPRテンプレートと同様に機能しますが、クイックアクション(スラッシュコマンド)という追加機能をサポートしています。MRの説明からラベル割り当て、マイルストーン設定、レビュアー割り当てを自動化できます。
テンプレート構造
## Description
<!-- 変更内容を要約してください。 -->
## Type of Change
- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Refactoring
- [ ] Documentation update
## Checklist
- [ ] コードがプロジェクトのスタイルガイドラインに従っている
- [ ] セルフレビュー完了
- [ ] テストを追加し通過している
- [ ] ドキュメントを更新した
## Testing
<!-- これらの変更をテストする方法を記述してください。 -->
## Related Issues
<!-- Closes #(issue number) -->
---
/label ~"needs review"
/milestone %current
クイックアクション
GitLabクイックアクションは/で始まるコマンドで、MR作成時に処理されます。レンダリングされた説明には表示されません。
| クイックアクション | 効果 |
|---|---|
/label ~"needs review" |
"needs review"ラベルを追加 |
/milestone %current |
現在のマイルストーンを設定 |
/assign @username |
MRをチームメンバーに割り当て |
/reviewer @username |
レビューをリクエスト |
/estimate 2h |
見積もり時間を設定 |
ファイルの配置場所
GitLabは複数のMRテンプレートをサポートしています。.gitlab/merge_request_templates/に保存します:
.gitlab/merge_request_templates/Default.md— デフォルトで使用.gitlab/merge_request_templates/Bug.md— バグ修正用に選択可能.gitlab/merge_request_templates/Feature.md— 機能追加用に選択可能
GitHubテンプレートとの違い
- GitLabは「Pull Request」の代わりに「Merge Request」用語を使用
- クイックアクションでインライン自動化が可能
- ドロップダウンセレクターで複数の名前付きテンプレートをネイティブサポート
- GitLabテンプレートはチェックボックスを含む同じMarkdown構文を使用
ユースケース
ソース管理とCI/CDにGitLabを使用し、クイックアクションによる自動ラベリングとマイルストーン割り当てで一貫したマージリクエスト説明を求めるチーム。