/backlog-add

ユーザーストーリー形式で Product Backlog Item（PBI）を対話的に作成し、GitHub Projects に追加するコマンド。

手順

0. 設定の読み込み

.claude/config.local.md の ## Backlog セクションから project-number と owner を取得する。 未設定の場合は /gz:backlog-init を案内する。

1. ユーザーストーリーの収集

対話形式で以下を収集する:

PBI をユーザーストーリー形式で作成します。

  誰として？（例: ユーザー、管理者、開発者）
  > ユーザー

  何をしたい？
  > キーワードで記事を検索したい

  なぜ？（理由）
  > 読みたい記事を素早く見つけたいから

タイトルを自動生成: 「ユーザーとして、キーワードで記事を検索したい」

2. 詳細情報の収集

受け入れ条件を入力してください（1行ずつ、空行で終了）:
  > 検索ボックスにキーワードを入力して検索できる
  > 検索結果が関連度順に表示される
  > 検索結果が0件の場合メッセージが表示される
  >

追加の備考はありますか？（なければ空行）:
  > 全文検索は Phase 2 で対応
  >

3. 対象リポジトリの選択

.claude/config.local.md の ## GitHub セクションの repos から対象リポジトリを選択する。

• repos が1つの場合: 自動選択
• repos が複数の場合: 一覧表示して選択
• repos が未設定の場合: カレントディレクトリのリポジトリを使用

4. Issue の作成

gh issue create \
  --repo <owner/repo> \
  --title "<ユーザーストーリータイトル>" \
  --body "## ユーザーストーリー

<role>として、<want>したい。なぜなら<why>だからだ。

## 受け入れ条件

- [ ] <条件1>
- [ ] <条件2>
- [ ] <条件3>

## 完成の定義

- [ ] コードレビュー完了
- [ ] テスト作成・パス
- [ ] ドキュメント更新（必要な場合）

## 備考

<備考>"

5. プロジェクトへの追加

# Issue をプロジェクトに追加
gh project item-add <project-number> --owner <owner> --url <issue-url>

6. 初期フィールドの設定（オプション）

「今すぐ見積もり（Size）を設定しますか？」と確認する。

• Yes の場合:

  • Size の選択: 1 / 2 / 3 / 5 / 8 / 13
  • Ready 状態: Ready / NotReady / Draft
  • System の選択（フィールドが存在する場合）
  • gh project item-edit で各フィールドを設定

• No の場合: 未見積もり状態のまま（New Item ビューに表示される）

7. 完了表示

PBI を作成しました!

  Issue: #<number> <タイトル>
  URL: <issue-url>
  Size: <size or 未設定>
  Ready: <ready or 未設定>

続けてもう1件作成しますか？ (y/n)

• y の場合: ステップ1に戻る
• n の場合: 終了

注意事項

• ユーザーストーリーの「なぜ」は省略可能だが、入力を推奨する
• ラベルが必要な場合、Issue 作成時に --label オプションで追加可能
• 受け入れ条件は最低1つは入力するよう促す