gitlab-milestone

マイルストーンスキル

glab CLI を使用した GitLab のマイルストーン管理操作です。

クイックリファレンス

操作	コマンド	リスク
マイルストーンの一覧表示	glab milestone list	-
マイルストーンの作成	glab milestone create <title>	⚠️

リスクの凡例：- 安全 | ⚠️ 注意 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危険

このスキルを使用する場面

必ず使用する場面：

• ユーザーがプロジェクトのマイルストーンを管理したい場合
• ユーザーが「マイルストーン」、「スプリント」、「イテレーション」、「リリース計画」に言及した場合
• ユーザーが作業を期間限定の区切りにまとめたい場合

使用しない場面：

• ユーザーが課題にマイルストーンを割り当てたい場合（gitlab-issue を使用）
• ユーザーがリリースを作成したい場合（gitlab-release を使用）

使用可能なコマンド

マイルストーンの一覧表示

glab milestone list [options]

オプション：

フラグ	説明
-s, --state=<state>	状態で絞り込み：active、closed、all
-P, --per-page=<n>	1ページあたりの結果数
--all	すべてのマイルストーンを取得

例：

# List active milestones
glab milestone list

# List all milestones including closed
glab milestone list --state=all

# List closed milestones
glab milestone list --state=closed

# List with more results
glab milestone list --per-page=50

マイルストーンの作成

glab milestone create <title> [options]

オプション：

フラグ	説明
-d, --description=<desc>	マイルストーンの説明
--due-date=<date>	期限（YYYY-MM-DD 形式）
--start-date=<date>	開始日（YYYY-MM-DD 形式）

例：

# Create simple milestone
glab milestone create "Sprint 1"

# Create with description
glab milestone create "Q1 Release" \
  -d "Features planned for Q1 2024 release"

# Create with dates
glab milestone create "Sprint 5" \
  --start-date=2024-02-01 \
  --due-date=2024-02-14 \
  -d "Two-week sprint"

# Create release milestone
glab milestone create "v2.0.0" \
  --due-date=2024-03-15 \
  -d "Major version 2.0 release"

一般的なワークフロー

ワークフロー 1：スプリント計画

# 1. Create new sprint milestone
glab milestone create "Sprint 12" \
  --start-date=2024-03-01 \
  --due-date=2024-03-14 \
  -d "Sprint 12 goals:
- Complete authentication feature
- Fix critical bugs
- Improve test coverage"

# 2. Assign issues to milestone
glab issue update 101 -m "Sprint 12"
glab issue update 102 -m "Sprint 12"
glab issue update 103 -m "Sprint 12"

# 3. View sprint issues
glab issue list --milestone="Sprint 12"

ワークフロー 2：リリース計画

# 1. List current milestones
glab milestone list

# 2. Create release milestone
glab milestone create "Release 1.5" \
  --due-date=2024-04-01 \
  -d "Version 1.5 release including:
- New dashboard
- Performance improvements
- Bug fixes from user feedback"

# 3. Associate issues
glab issue list --label="release-1.5" | while read issue; do
  glab issue update $issue -m "Release 1.5"
done

ワークフロー 3：スプリントの進捗確認

# 1. List sprint milestones
glab milestone list --state=active

# 2. Check open issues in sprint
glab issue list --milestone="Sprint 12" --state=opened

# 3. Check closed issues
glab issue list --milestone="Sprint 12" --state=closed

# 4. Check MRs in sprint
glab mr list --milestone="Sprint 12"

マイルストーンの命名規則

マイルストーン名でよく使われるパターン：

パターン	例	用途
Sprint N	Sprint 1, Sprint 2	アジャイルスプリント
YYYY-QN	2024-Q1, 2024-Q2	四半期計画
vX.Y.Z	v1.0.0, v2.1.0	バージョンリリース
YYYY-MM	2024-03, 2024-04	月次サイクル
機能名	"User Authentication"	機能ベースのマイルストーン

トラブルシューティング

問題	原因	解決策
認証に失敗する	トークンが無効または期限切れ	glab auth login を実行
マイルストーンが見つからない	名前が間違っている、またはクローズ済み	glab milestone list --state=all で確認
日付が無効	形式が間違っている	YYYY-MM-DD 形式を使用
アクセスが拒否される	メンテナーではない	メンテナー以上のロールが必要

関連ドキュメント

• セーフガード
• クイックリファレンス