/zen:issue:list

GitHub Issue の一覧を表示

---

このコマンドを実行したら、以下のフェーズを順番に実行してください。

Phase 1: 引数のパース

ユーザーが指定したフィルタ条件を判定:

入力	種類	処理
なし	デフォルト	オープンな Issue を表示
open	状態フィルタ	オープンな Issue を表示
closed	状態フィルタ	クローズした Issue を表示
all	状態フィルタ	すべての Issue を表示
#123 または 123	Issue 番号	特定 Issue の詳細を表示
その他	ラベルフィルタ	指定ラベルの Issue を表示

---

Phase 2: Issue 一覧の取得と表示

2.1 Issue 番号指定の場合（#123 または 123）

特定の Issue 詳細を取得して表示:

gh issue view {number} --json number,title,body,state,labels,assignees,milestone,createdAt,updatedAt

以下の形式で表示:

┌─────────────────────────────────────────────────────────────┐
│  Issue #{number}: {title}                                   │
└─────────────────────────────────────────────────────────────┘

【状態】{state}
【ラベル】{labels}
【担当者】{assignees}
【マイルストーン】{milestone}
【作成日】{createdAt}
【更新日】{updatedAt}

───────────────────────────────────────────────────────────────
{body}
───────────────────────────────────────────────────────────────

【次のアクション】
- /zen:issue:start {number}  この Issue の作業を開始
- /zen:issue:close {number}  完了状態を確認

2.2 状態フィルタの場合（open, closed, all）

# open（デフォルト）
gh issue list --state open --json number,title,labels,assignees,createdAt --limit 20

# closed
gh issue list --state closed --json number,title,labels,assignees,createdAt --limit 20

# all
gh issue list --state all --json number,title,labels,assignees,createdAt --limit 20

2.3 ラベルフィルタの場合

gh issue list --label "{label}" --json number,title,state,labels,assignees,createdAt --limit 20

---

Phase 3: 結果の整形と表示

3.1 一覧表示のフォーマット

Issue が存在する場合:

┌─────────────────────────────────────────────────────────────┐
│  Issue 一覧（{filter}）                                      │
└─────────────────────────────────────────────────────────────┘

  #{number}  {title}
             ラベル: {labels}  担当: {assignees}  {createdAt}

  #{number}  {title}
             ラベル: {labels}  担当: {assignees}  {createdAt}

  ... (他 {count} 件)

───────────────────────────────────────────────────────────────
  合計: {total} 件の Issue

【操作】
- /zen:issue:list #{number}  詳細を表示
- /zen:issue:start {number}  作業を開始
- /zen:issue:create          新規 Issue を作成

3.2 Issue が存在しない場合

┌─────────────────────────────────────────────────────────────┐
│  Issue 一覧（{filter}）                                      │
└─────────────────────────────────────────────────────────────┘

  Issue が見つかりませんでした。

【操作】
- /zen:issue:create <説明>  新規 Issue を作成
- /zen:issue:list closed    クローズした Issue を表示

---

Phase 4: GitHub Projects 情報の補足表示（オプション）

zen-config.yml が存在し、Projects 連携が有効な場合は Projects の情報も表示。

4.1 設定ファイルの確認

cat zen-config.yml 2>/dev/null || cat .claude/zen:config.yml 2>/dev/null

4.2 Projects 情報の取得

設定から project_number と owner を取得し、Issue の Projects ステータスを補足表示:

gh project item-list {project_number} --owner {owner} --format json

一覧表示に Status 列を追加:

  #{number}  {title}                                    [{Status}]
             ラベル: {labels}  担当: {assignees}  {createdAt}

---

使用可能なツール

• Bash: gh issue list, gh issue view, gh project item-list
• Read: zen-config.yml の読み取り

言語対応

ユーザーの入力言語を検出して、適切な言語でメッセージを表示:

• 日本語入力 → 日本語で表示
• 英語入力 → 英語で表示

使用例

/zen:issue:list              # オープンな Issue を一覧
/zen:issue:list open         # オープンな Issue を一覧（明示的）
/zen:issue:list closed       # クローズした Issue を一覧
/zen:issue:list all          # すべての Issue を一覧
/zen:issue:list bug          # "bug" ラベルの Issue を一覧
/zen:issue:list enhancement  # "enhancement" ラベルの Issue を一覧
/zen:issue:list #42          # Issue #42 の詳細を表示
/zen:issue:list 42           # Issue #42 の詳細を表示