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を使用し、クイックアクションによる自動ラベリングとマイルストーン割り当てで一貫したマージリクエスト説明を求めるチーム。

試してみる — PR Template Builder

フルツールを開く