jackin-merge-pr

jackin-merge-pr

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

使用するタイミング

• オペレーターが jackin-merge-pr [<PR>] を実行して jackin❯ の PR をマージします（デフォルトでは現在のブランチの PR が対象です）。

使用しないタイミング

• PR の作成または反復 → jackin-create-pr / jackin-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 が必要な場合は、大 です。大 → 明示的な確認を 1 回求めるために一時停止します。通常 → そのまま進めます（このスキルの実行が承認となります）。
3. CI ゲート。 gh pr checks <PR> を実行します。保留中の場合は、すべて成功するまでポーリングします（--no-poll を指定した場合を除く）。チェックが 1 つでも失敗した場合は停止します。CI を信頼してください。CI では cargo xtask schema-check とテスト／clippy／fmt ジョブが実行されるため、ローカルで再実行する必要はありません。
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 を削除して監査を行います。被リンクが 1 つでも廃止済みのスラッグを参照している場合は失敗します。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 はステータスを設定します。コンテンツの移動自体はエージェントの判断で行います。CI では cargo xtask schema-check（5 アーティファクトのゲート）が実行されます。このスキルはその結果を確認するだけです。