gitlab-issue

Issue スキル

glab CLI を使用した GitLab の Issue 操作です。

クイックリファレンス

操作	コマンド	リスク
Issue の一覧表示	glab issue list	-
Issue の表示	glab issue view <id>	-
Issue の作成	glab issue create	⚠️
Issue の更新	glab issue update <id>	⚠️
Issue のクローズ	glab issue close <id>	⚠️
Issue の再オープン	glab issue reopen <id>	⚠️
Issue の削除	glab issue delete <id>	⚠️⚠️
ノートの追加	glab issue note <id>	⚠️

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

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

必ず使用する場合：

• ユーザーが Issue の操作を希望している
• ユーザーが「Issue」、「バグ」、「タスク」、「チケット」または関連用語に言及している
• ユーザーが作業項目を追跡または管理したい

使用しない場合：

• ユーザーが 10 件以上の Issue に対する一括操作を希望している（代わりに gitlab-bulk を使用）
• ユーザーが Issue の検索やフィルタリングのみを希望している（代わりに gitlab-search を使用）

利用可能なコマンド

Issue の一覧表示

glab issue list [options]

オプション：

フラグ	説明
-a, --assignee=<user>	担当者で絞り込む（自分自身には @me を使用）
--author=<user>	作成者で絞り込む
-l, --label=<labels>	カンマ区切りのラベルで絞り込む
-m, --milestone=<milestone>	マイルストーンで絞り込む
-s, --state=<state>	状態で絞り込む：opened、closed、all（デフォルト：opened）
-c, --closed	クローズ済みの Issue のみを取得する
--all	すべての Issue を取得する
-P, --per-page=<n>	1 ページあたりの項目数
--confidential	機密 Issue のみで絞り込む
--search=<query>	タイトル／説明で Issue を検索する

例：

# List all open issues
glab issue list

# List issues assigned to you
glab issue list --assignee=@me

# List closed issues
glab issue list --closed

# List issues with specific label
glab issue list --label=bug

# List issues in a milestone
glab issue list --milestone="Release 1.0"

# Search issues
glab issue list --search="login bug"

# Get all issues (paginated)
glab issue list --all

Issue の詳細表示

glab issue view <id> [options]

オプション：

フラグ	説明
-w, --web	Issue をブラウザーで開く
-c, --comments	Issue のコメントを表示する
-s, --system-logs	システムのアクティビティを表示する

例：

# View issue in terminal
glab issue view 42

# Open issue in browser
glab issue view 42 --web

# View with comments
glab issue view 42 --comments

Issue の作成

glab issue create [options]

オプション：

フラグ	説明
-t, --title=<title>	Issue のタイトル
-d, --description=<desc>	Issue の説明
-a, --assignee=<users>	カンマ区切りの担当者
-l, --label=<labels>	カンマ区切りのラベル
-m, --milestone=<milestone>	マイルストーンのタイトル
--confidential	機密として作成する
--weight=<n>	Issue のウェイト（0-9）
-w, --web	作成後にブラウザーで開く
-y, --yes	確認プロンプトをスキップする

例：

# Create issue with title
glab issue create -t "Fix login bug"

# Create issue with full details
glab issue create -t "Add dark mode" -d "Implement dark mode toggle" -l "enhancement,ui"

# Create issue with milestone and assignee
glab issue create -t "Release prep" -m "Release 2.0" -a "@me"

# Create confidential issue
glab issue create -t "Security vulnerability" --confidential

# Create and open in browser
glab issue create -t "New feature" --web

Issue の更新

glab issue update <id> [options]

オプション：

フラグ	説明
-t, --title=<title>	タイトルを更新する
-d, --description=<desc>	説明を更新する
-a, --assignee=<users>	担当者を更新する
--unassign	すべての担当者を解除する
-l, --label=<labels>	ラベルを追加する
--unlabel=<labels>	ラベルを削除する
-m, --milestone=<milestone>	マイルストーンを設定する
--confidential	機密として設定する
--public	公開として設定する
--lock-discussion	ディスカッションをロックする
--unlock-discussion	ディスカッションのロックを解除する

例：

# Update title
glab issue update 42 -t "Updated title"

# Add labels
glab issue update 42 -l "priority,reviewed"

# Remove labels
glab issue update 42 --unlabel="needs-review"

# Change assignee
glab issue update 42 -a "username"

# Add to milestone
glab issue update 42 -m "Sprint 5"

Issue のクローズ／再オープン

# Close issue
glab issue close <id>

# Reopen issue
glab issue reopen <id>

Issue の削除

glab issue delete <id>

警告： Issue は完全に削除されます。注意して使用してください。

ノート／コメントの追加

glab issue note <id> -m "<message>"

例：

# Add comment
glab issue note 42 -m "Working on this now"

# Add closing comment
glab issue note 42 -m "Fixed in !123"

購読／購読解除

# Subscribe to issue notifications
glab issue subscribe <id>

# Unsubscribe
glab issue unsubscribe <id>

よくあるワークフロー

ワークフロー 1：Issue のトリアージ

# 1. List unassigned issues
glab issue list --assignee=""

# 2. View issue details
glab issue view 42

# 3. Assign and label
glab issue update 42 -a "developer" -l "bug,priority"

ワークフロー 2：Issue に取り組む

# 1. Find assigned issues
glab issue list --assignee=@me

# 2. View details
glab issue view 42

# 3. Create branch and work
git checkout -b fix/issue-42

# 4. Add progress note
glab issue note 42 -m "Started work on this"

# 5. Close when MR is merged
glab issue close 42

ワークフロー 3：バグをすばやく報告する

# Create issue with all details
glab issue create \
  -t "Login fails with special characters" \
  -d "Steps to reproduce:
1. Enter username with @ symbol
2. Click login
3. Error: 500

Expected: Login succeeds" \
  -l "bug,login"

トラブルシューティング

問題	原因	解決策
認証に失敗する	トークンが無効、または期限切れ	glab auth login を実行する
Issue が見つからない	ID が無効、またはアクセス権がない	glab issue list で ID を確認する
権限が拒否される	権限が不足している	プロジェクトの権限を確認する
クローズできない	Issue がロックされている	メンテナーにロック解除を依頼する

関連ドキュメント

• 安全対策
• クイックリファレンス