jackin-create-pr

jackin-create-pr

jackin❯ リポジトリの小規模な修正（誤字、依存関係の更新、1行のバグ修正、ドキュメントの微調整など）について、ロードマップ項目を必要としない PR を作成します。また、ほかのスキルでも再利用する共通の PR 作成手順です。コミットはこの手順内で行い、別のコミットスキルは使いません。

jackin❯ のルールファイルは自動的に読み込まれます。PULL_REQUESTS.md、.github/ のエージェントルール、BRANCHING.md、COMMITS.md が対象です。このスキルは、それらを順番に適用し、内容を繰り返しません。詳細なルールは各ファイルを確認してください。

使用する場合

• オペレーターが jackin-create-pr を実行した場合。
• 小規模で自己完結した変更（設計を伴わず、ロードマップ項目も不要）。

使用しない場合

• ロードマップ項目に値する機能やアイデアの場合 → jackin-propose。
• 確定済みのロードマップ項目を実装する場合 → /goal Implement <slug>.md。

引数

• --branch <name> — ブランチ名を明示的に指定します。
• --auto-branch — 確認せずにブランチ名を自動で選びます。
• --title <msg> — コミットと PR のタイトルを指定します（指定がなければ、差分から Conventional Commits 形式で作成します）。

手順

1. ブランチを作成します。 main には絶対にコミットしないでください。main にいる場合は、変更内容に基づいて fix/、chore/、docs/、refactor/ のいずれかを接頭辞に付けたブランチを作成します。--auto-branch または --branch が指定されていない場合は、ブランチ名を提案して確認します。
2. コミットします。 未コミットの変更がある場合は、COMMITS.md に従ってこの手順内でコミットします。Conventional Commits 形式の件名を付け、DCO サインオフを行います（git commit -s）。すでにコミット済みの場合はスキップします。その後、git push を実行します。
3. 本文を作成します。 [bin] cargo xtask pr body --base origin/main > /tmp/pr-body.md を実行します。変更内容の分類サマリー（rust / docs / capsule / schema とファイル一覧）は 標準エラー出力 に表示されるため、確認してください。本文の骨子はファイルに出力されます。実行時に .github/PULL_REQUEST_TEMPLATE.md から読み込まれる PR テンプレートに、ローカルでの検証ブロックが選択済みで、バイト単位で正確に挿入されています。説明文はプレースホルダーのままです。ブロックの選択は次のとおりです。Checkout と isolation env は常に含めます。Rust の変更には Rust テスト、docs/** には Docs のチェックと確認、crates/jackin-capsule/ には jackin-capsule のスモークテスト（console / load の前に --capsule を指定）、バージョン付きスキーマへの変更にはスキーマ移行のスモークテストを含めます。
4. 本文を完成させて作成します。 [agent] /tmp/pr-body.md を編集し、サマリーと差分に基づいて説明文のセクション（Summary、What ships、Behavior changes）を記述します。不要な任意セクションは削除します。その後、gh pr create --body-file /tmp/pr-body.md を実行します。バイナリが本文をすでに書き出しているため、引用する heredoc は不要です。
5. 表示を確認します。 gh pr view <PR> --json body -q .body を実行し、追加した説明文が正しく表示されることを確認します（手編集による余計な \`` や $ がないこと）。問題があれば、gh pr edit --body-file` で修正します。
6. 返信します。 PR の URL を共有し、最終メッセージで「ローカルでの検証」コマンドを繰り返します。

よくある間違い

• ブランチではなく main にコミットする。
• cargo xtask pr body を使わずに、本文やテンプレートを手作業で作成する。このコマンドはテンプレートを読み込み、検証ブロックを自動で選択します。
• 説明文のプレースホルダーを埋めずに、骨子のまま投稿する。
• 本文にデプロイ済みドキュメントの URL を記載する（マージ後にリンク切れになります）。ドキュメントは名前で参照してください。

ツール

cargo xtask pr body（jackin❯ リポジトリ）は、変更内容のサマリーと、差分に基づいて「ローカルでの検証」ブロックを自動選択したテンプレートの骨子を出力します。propose と共有されています。バイナリが機械的な処理（ブロックの選択、capsule の順序、コマンドテキストの正確さ、heredoc の引用）を保証し、エージェントが説明文を記述します。