/zen:pr:create

ドラフト PR を作成し、関連 Issue と連携する

---

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

引数

引数	説明
[title]	PR タイトル（省略時は自動生成）

---

Phase 1: 現在状態の確認

1.1 ブランチ確認

現在のブランチと main ブランチとの差分を確認:

git branch --show-current

main/master ブランチの場合:

エラー: 現在 {branch} ブランチにいます

PR を作成するには作業ブランチに切り替えてください。
`/zen:issue:start` で作業を開始できます。

処理を終了。

1.2 変更内容の確認

git status --porcelain
git diff --stat origin/main...HEAD
git log --oneline origin/main...HEAD

コミットがない場合:

警告: まだコミットがありません

変更をコミットしてから PR を作成してください。

処理を終了。

1.3 Issue 番号の抽出

ブランチ名から関連 Issue 番号を抽出:

パターン: {type}/issue-{number}-{slug}
例: feat/issue-17-pr-create → Issue #17

抽出できない場合は AskUserQuestion で確認:

ブランチ名から Issue 番号を特定できません

現在のブランチ: {branch}

オプション:
- Issue 番号を手動で指定
- Issue なしで PR を作成
- キャンセル

1.4 Issue 情報の取得

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

Issue がクローズされている場合:

警告: Issue #{number} は既にクローズされています

PR を作成しますか？
オプション:
- はい、作成する
- キャンセル

1.5 作業メモリの取得

Issue のコメントから作業メモリを取得:

gh api repos/{owner}/{repo}/issues/{issue_number}/comments --jq '.[] | select(.body | contains("zen 作業メモリ"))'

作業メモリが見つかった場合、以下の情報を抽出:

• 進捗状況
• 変更ファイル
• 決定事項・メモ

---

Phase 2: 品質チェック（オプション）

2.1 自動検出コマンドの確認

zen-config.yml から build/lint コマンドを取得:

commands:
  build: null  # 自動検出
  lint: null   # 自動検出

自動検出ロジック:

1. package.json の scripts から検出
2. Makefile のターゲットから検出
3. 言語固有のデフォルトコマンド

2.2 品質チェック実行の確認

AskUserQuestion で実行を確認:

PR 作成前に品質チェックを実行しますか？

検出されたコマンド:
- lint: {lint_command}
- build: {build_command}

オプション:
- すべて実行（推奨）
- lint のみ
- スキップ

2.3 チェック実行

選択されたチェックを実行:

# lint 実行例
npm run lint

エラーがある場合:

品質チェックでエラーが検出されました

{error_output}

オプション:
- エラーを無視して PR 作成
- 修正してから再実行
- キャンセル

---

Phase 3: PR 作成

3.1 PR タイトル生成

Conventional Commits 形式でタイトルを生成:

タイトル生成ルール:

1. ブランチ名の type を使用
2. Issue タイトルから scope と description を抽出

パターン: {type}({scope}): {description}
例: feat(pr): implement /zen:pr:create command

type マッピング:

ブランチ prefix	PR type
feat/	feat
fix/	fix
docs/	docs
refactor/	refactor
chore/	chore
style/	style
test/	test

3.2 PR 本文生成

プロジェクト種別（zen-config.yml の project.type）に応じたテンプレートを使用。

テンプレートファイル: templates/pr/{project_type}.md

本文に含める情報:

1. 概要（Issue タイトルまたは説明から）
2. 関連 Issue（Closes #{number}）
3. 変更内容（作業メモリから、なければ git diff から推測）
4. チェックリスト（プロジェクト種別に応じた項目）

3.3 リモートへプッシュ

ローカルブランチをリモートにプッシュ:

git push -u origin {branch_name}

3.4 ドラフト PR 作成

gh pr create --draft --title "{title}" --body "{body}"

---

Phase 4: 後処理

4.1 作業メモリの自動更新

Issue の作業メモリコメントを自動的に更新する。

4.1.1 更新情報の収集

PR 作成時に以下の情報を自動収集:

# 変更ファイルの取得
git diff --name-status origin/main...HEAD

# コミット履歴の取得
git log --oneline origin/main...HEAD

4.1.2 作業メモリコメントの取得と更新

# コメント ID を取得
comment_id=$(gh api repos/{owner}/{repo}/issues/{issue_number}/comments \
  --jq '.[] | select(.body | contains("🧘 zen 作業メモリ")) | .id')

# コメントが見つかった場合のみ更新
if [ -n "$comment_id" ]; then
  gh api repos/{owner}/{repo}/issues/comments/{comment_id} \
    -X PATCH \
    -f body="{updated_body}"
fi

4.1.3 更新内容

作業メモリに以下を自動追記:

### 進捗
- [x] 実装完了
- [x] PR 作成済み

### 変更ファイル
| ファイル | 状態 |
|---------|------|
| {path} | {status} |

### 関連 PR
- #{pr_number}: {pr_title}
- URL: {pr_url}
- 作成日時: {timestamp}

### コミット履歴
{commit_log}

ステータスの判定:

• A → 追加
• M → 変更
• D → 削除
• R → 名前変更

注意: 作業メモリコメントが見つからない場合は更新をスキップし、警告を表示する。

4.2 完了報告

ドラフト PR #{pr_number} を作成しました

タイトル: {title}
URL: {pr_url}

関連 Issue: #{issue_number}

次のステップ:
1. PR の内容を確認
2. `/zen:pr:review` でセルフレビュー
3. `/zen:pr:ready` で Ready for review に変更

---

エラーハンドリング

リモートへのプッシュ失敗

エラー: リモートへのプッシュに失敗しました

考えられる原因:
- ネットワーク接続の問題
- 認証エラー
- リモートブランチとの競合

対処:
1. ネットワーク接続を確認
2. `gh auth status` で認証状態を確認
3. `git pull --rebase origin main` で最新を取得
4. 再度実行

PR 作成失敗

エラー: PR の作成に失敗しました

考えられる原因:
- 同じブランチの PR が既に存在
- 権限不足
- ネットワークエラー

対処:
1. `gh pr list` で既存 PR を確認
2. 権限を確認
3. 再度実行

Issue が見つからない場合

警告: Issue #{number} が見つかりません

Issue なしで PR を作成しますか？
オプション:
- はい、作成する
- 別の Issue を指定
- キャンセル

---

使用可能なツール

• Bash: gh コマンド、git コマンド実行
• Read: 設定ファイル、テンプレート読み取り
• AskUserQuestion: ユーザー確認・選択