/zen:workflow

zen ワークフロー全体のガイドを表示

---

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

Phase 1: 現在の状態を確認

1.1 初期化状態の確認

プロジェクトルートに zen-config.yml が存在するかチェック:

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

存在しない場合:

⚠️ zen workflow が初期化されていません

まず /zen:init を実行してセットアップを完了してください。

ここで終了し、以降のフェーズは実行しない。

1.2 現在のブランチと作業状態の確認

git branch --show-current

ブランチ名から作業中の Issue を検出:

• パターン: {type}/issue-{number}-{slug}
• 例: feat/issue-123-add-feature → Issue #123

作業中の Issue がある場合は後で「次のステップ」に反映。

---

Phase 2: ワークフロー全体図を表示

以下の図を表示:

🧘 zen workflow

┌─────────────────────────────────────────────────────────────┐
│                     ワークフロー全体図                        │
└─────────────────────────────────────────────────────────────┘

  /zen:issue:list (Issue 確認)
        │
        ▼
  /zen:issue:create (新規 Issue 作成)
        │                              Status: Todo
        ▼
  /zen:issue:start <番号> (ブランチ作成)
        │                              Status: In Progress
        ▼
  ┌─────────────────────┐
  │     実装作業        │
  │  └─ /zen:issue:update │ (作業メモリ更新)
  └─────────────────────┘
        │
        ▼
  /zen:lint (品質チェック)
        │
        ▼
  /zen:pr:create (ドラフト PR 作成)
        │
        ▼
  /zen:pr:review (セルフレビュー)
        │
        ▼
  /zen:pr:ready (レビュー待ちに変更)
        │                              Status: In Review
        ▼
  PR マージ → Issue 自動クローズ       Status: Done

┌─────────────────────────────────────────────────────────────┐
│  Status 遷移: Todo → In Progress → In Review → Done        │
└─────────────────────────────────────────────────────────────┘

---

Phase 3: コマンド一覧を表示

以下の一覧を表示:

┌─────────────────────────────────────────────────────────────┐
│                     コマンド一覧                             │
└─────────────────────────────────────────────────────────────┘

【セットアップ】
  /zen:init            初回セットアップウィザード
  /zen:workflow        このガイドを表示

【Issue 管理】
  /zen:issue:list      Issue 一覧を表示
  /zen:issue:create    新規 Issue を作成
  /zen:issue:start     Issue の作業を開始（ブランチ作成）
  /zen:issue:update    作業メモリを更新
  /zen:issue:close     Issue の完了状態を確認

【PR 管理】
  /zen:pr:create       ドラフト PR を作成
  /zen:pr:ready        Ready for review に変更
  /zen:pr:review       マルチレビュアーレビュー

【ユーティリティ】
  /zen:lint            品質チェックを実行
  /zen:template:reset  テンプレートを再生成

---

Phase 4: 次のステップを提案

Phase 1 で確認した状態に基づいて、次のアクションを提案。

4.1 作業中の Issue がある場合

┌─────────────────────────────────────────────────────────────┐
│                     現在の作業状況                           │
└─────────────────────────────────────────────────────────────┘

  現在のブランチ: {branch-name}
  作業中の Issue: #{issue-number}

  【次のステップ】
  1. 実装を続ける
  2. /zen:issue:update で作業メモリを更新
  3. 完了したら /zen:lint で品質チェック
  4. /zen:pr:create でドラフト PR を作成

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

gh issue view {issue-number} --json title,body,state

4.2 作業中の Issue がない場合

┌─────────────────────────────────────────────────────────────┐
│                     クイックスタート                         │
└─────────────────────────────────────────────────────────────┘

  【新しいタスクを始める】
  1. /zen:issue:list で既存 Issue を確認
  2. /zen:issue:create <説明> で新規 Issue を作成
     または
     /zen:issue:start <番号> で既存 Issue の作業を開始

  【例】
  - /zen:issue:create ログイン機能を追加
  - /zen:issue:start 42

---

Phase 5: 追加情報の表示（オプション）

プロジェクトの状態に応じて追加情報を表示。

5.1 オープンな Issue の数

gh issue list --state open --json number --jq 'length'

5.2 オープンな PR の数

gh pr list --state open --json number --jq 'length'

結果を表示:

┌─────────────────────────────────────────────────────────────┐
│                     プロジェクト状況                         │
└─────────────────────────────────────────────────────────────┘

  オープン Issue: {count} 件
  オープン PR: {count} 件

---

使用可能なツール

• Bash: gh コマンド、git コマンド実行
• Read: zen-config.yml の読み取り
• Glob: ファイル存在確認

言語対応

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

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