merge-pr

merge-pr

jackin' のマージ前ゲートをフェイルクローズで順に実行し、ロードマップ項目をドキュメントに移してから、スカッシュマージします。自動読み込みされる .github/ のエージェントルールと PULL_REQUESTS.md を再利用し、順に実行しますが、内容を再記述することはありません。

使用する場合

• オペレーターが /jackin-dev:merge-pr [<PR>] を実行して jackin' の PR をマージする場合（デフォルトは現在のブランチの PR）。

使用しない場合

• PR の作成や反復修正 → /jackin-dev:create-pr / /jackin-dev:propose。

引数

• --no-poll — 保留中の CI を待たず、停止して報告します。
• --admin <check> — 名前を指定した失敗チェックのバイパスを許可します（影響範囲の広い変更に対する確認は引き続き必要です）。

危険信号 — 停止

• この PR に対する明確な承認がなく、影響範囲が広い → 停止し、先に確認します。
• 必須の CI チェックが失敗している → 停止します（--admin <check> と確認なしで --admin によるバイパスはできません）。
• PR のマージまたは進行時にロードマップ項目が廃止されていない、またはステータスが変更されていない → 停止し、先に修正します。

手順

1. PR を特定します。 現在のブランチの PR、または引数で指定された PR を使います。gh pr view と gh pr diff を読みます。
2. 影響範囲を分類します。 差分がバージョン管理対象のスキーマ、認証／セキュリティ領域、.github/workflows/** に触れる場合、または強制プッシュ／--admin が必要な場合は高です。高の場合は、明示的な確認を一度得るまで保留します。通常の場合は続行します（このスキルを呼び出すことが実行の承認です）。
3. CI ゲート。 gh pr checks <PR> を実行します。保留中のチェックがあれば（--no-poll が指定されていない限り）すべて成功するまでポーリングします。失敗したチェックがあれば停止します。cargo xtask schema-check とテスト／clippy／fmt のジョブを実行する CI を信頼し、ローカルでは再実行しません。
4. ロードマップ項目の廃止。 この PR は、ロードマップ項目の最後の部分を提供しますか？
   • はい → [bin] cargo xtask roadmap retire <slug> --plan を実行すると、作業リスト（ページの内容、すべての被リンク（grep <slug>）、および meta.json のエントリー）が出力されます。[agent] 判断を伴う移動を行います。オペレーター向けの詳細は guides/／commands/ へ、設計の詳細は reference/ へ移し、roadmap/index.mdx に ## Completed の箇条書きを追加して、被リンクの参照先を変更します。docs: でコミットします。[bin] cargo xtask roadmap retire <slug> --apply を実行すると、meta.json のエントリーを削除し、.mdx を削除して監査を実行します。被リンクのいずれかが削除済みのスラッグを指したままの場合は失敗します。bun のドキュメントゲートを実行し、プッシュします。
   • 一部のみ → cargo xtask roadmap retire <slug> --partial を実行して **Status**: Partially implemented に設定し、ページは残します。残りのフェーズを明記し、コミットしてプッシュします。
5. メタデータを整合させます。 タイトルと本文は最終的な差分に合っていますか？スカッシュマージではタイトルが履歴にそのまま記録されます。古くなっている場合は gh pr edit で修正し、返信で変更を伝えます。
6. スカッシュマージします。 本文ファイルを作成します（チェックリストなしの文章による要約）。cargo run -p jackin-pr-trailers -- --body-file でトレーラーを追加してから、gh pr merge <PR> --squash --body-file を実行します。タイトルに (#N) が含まれていることを確認します。
7. 報告します。 マージされた SHA と、廃止処理の内容を報告します。

よくある間違い

• 以前のセッションでの「すべてをすぐマージして」という指示を承認として扱うこと — その承認は引き継がれません。
• CI が保留中または失敗している状態でマージすること、またはチェックごとの明示的な許可なしで --admin によるバイパスを行うこと。
• Status: Resolved のロードマップページを残し、ドキュメントへの移行を行わないこと。
• スカッシュタイトルに (#N) の接尾辞や DCO／Co-authored-by トレーラーがないこと。

ツール

jackin-pr-trailers が含まれます。cargo xtask roadmap retire <slug> --plan はエージェントに廃止作業リストを提示します。--apply は機械的な削除と監査を行い、リンク切れがある場合は失敗します。--partial は Status を設定します。コンテンツの移動はエージェントが判断します。CI は cargo xtask schema-check（5 アーティファクトゲート）を実行します。このスキルはその結果を読み取るだけです。