create-pr-text

GitHub issue から PR のタイトルと説明文を作成する。$ARGUMENTS に issue 番号(123、#123)または URL が渡される。$ARGUMENTS が空の場合はユーザーに issue 番号を質問する。

実際の PR は絶対に作成しない。 gh pr create は実行禁止。テキストの生成のみ行う。

本スキルはユーザーへの質問なしで完結する(/dev からはサブエージェントとして実行されることがある)。

1. tmp/config.json を確認する:
   • pull_request_template_path: なければプロジェクト内の PR テンプレート(pull_request_template.md, .github/pull_request_template.md 等)を探し、見つかったパスを保存する。テンプレートがあればそのフォーマットに従う
   • base_branch: なければ git remote show origin の HEAD branch を検出して保存する(以降 <base>)
2. tmp/issues/<issue番号>/ 配下に plan.md / report.md(md が無ければ html)/ checklist.html / implementation-notes.md が既にある場合はその内容を活用する(特に implementation-notes の Deviations は「計画との差分」としてレビュアに有用)
3. gh issue view で issue を取得する
4. git log <base>..HEAD --stat でコミット単位の変更概要を確認し、必要に応じて git show <hash> で個別のコミット内容を把握する
5. 結果を Write ツールで tmp/issues/<issue番号>/pr.md に書き込む(フォーマットは template.md を参照)

UI 前後比較セクション

checklist.html に「UI 撮影台本」セクションがある場合のみ、pr.md に「UI の変更」セクションを追加する(無ければセクションごと省略する)。

• 台本の各行を 1 行とするテーブルを作る: | 画面 | Before | After |
• セルは <img src="screenshots/before/<撮影名>.png" width="320"> 形式で書く(![]() は幅制御できず巨大表示になるため)。パスは pr.md からの相対パス
• 画像ファイルの存在は前提にしない。パスは台本の撮影名から機械的に組む(/dev では test と並列実行されるため、after/ は書き込み時点で未生成のことがある。test 完了時に揃う)
• before/ に対応ファイルが無い行(新規追加画面)は Before セルを —(新規) にする
• テーブル直後に HTML コメントで注記を入れる: <!-- GitHub に貼る際は画像をドラッグ&ドロップでアップロードし、src を差し替えること -->

書き方の方針

詳細は diff や issue を見れば分かるので、PR テキストは最小限に留める。冗長な説明や同じ内容の言い換えは書かない。

pr.md 本文に tmp/ 配下のファイルへの参照(パス・リンク)を書かない。 tmp/ は .gitignore 対象でレビュアは到達できない。plan.md や implementation-notes 等の内容が必要な場合はパスを示すのではなく要点を本文に転記する。例外は「UI の変更」テーブルの img src のみ(GitHub 貼り付け時に差し替える前提のプレースホルダ)。

• 概要: 1-3 行。何のための変更かが分かる程度
• 変更内容: 各項目は 1 行 50 文字程度まで。長くなる場合は言い回しを削って要点だけに圧縮する(項目を分割して箇条書きを増やすのは NG)。網羅的に列挙せず、主要な変更のみ
• UI の変更: UI 撮影台本がある場合のみ(「UI 前後比較セクション」参照)
• 関連 Issue: closes #<番号> のみ

PR テンプレートがある場合はそのセクション構成に従いつつ、各セクションは上記の粒度で簡潔に書く。