ship について
Ship は、明示的に呼び出された場合のみ実行する、現在のブランチ向けの段階的なリリーススキルです。レビュー、コード整理、コミットとプッシュ、PR 作成を進め、マージ可能になるまで対応します。
主な機能
- 01AGENTS.md に基づく差分レビュー
- 02変更箇所のコード整理
- 03変更のコミットとプッシュ
- 04プルリクエストの作成
- 05マージ可能になるまでのフォロー
活用シーン
- 01ブランチのリリース準備
- 02レビュー済み PR の作成と公開
- 03対象範囲内の PR 指摘と CI 問題への対応
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ millionco/ react-doctor --skill shipインストール後、Claude Code で/shipを入力して読み込まれたか確認します。
詳細
Ship
現在のブランチを対象とする逐次リリースパイプラインです。明示的に呼び出された場合にのみ実行します。コミット、プッシュ、PR の作成を行います。
各ステージでは既存のスキルに処理を委任します。順番に実行し、未解決の指摘が残っている間は次に進まないでください。
このチェックリストをコピーして進捗を記録してください:
Ship progress:
- [ ] 1. Review the diff against AGENTS.md
- [ ] 2. Deslop the touched code
- [ ] 3. Commit and push
- [ ] 4. Open the PR
- [ ] 5. Babysit to merge-ready
1. AGENTS.md に基づくレビュー
まず AGENTS.md を読みます(ルールは変更されるため)。次に、このブランチの差分を /review で確認し、それらのルールに照らして判断します。実際の違反は続行前に修正してください。修正によって動作が変わる場合、またはスコープが広がる場合にのみ、ユーザーの確認を待ちます。
2. 不要なコードの整理
/deslop(../deslop/SKILL.md)を実行し、truffler による重複統合パスも含めて、機能を維持しながら最近変更されたコードを簡潔にします。コミット前に改善を適用してください。
3. コミットとプッシュ
- 意図した変更のみをステージします。シークレットは絶対にコミットしないでください。
- 公開パッケージの動作を変更した場合は、まず changeset を追加します(
/rule-validateの Changeset セクションに従ってください)。プライベート、ドキュメント/テスト/ツール関連のみの変更の場合に限り省略し、その理由を記載します。 - コミット前に、変更内容に適したリポジトリのチェックを実行します:
nr test、nr lint、nr typecheck、nr format:check。 - リポジトリのスタイルに合わせ、理由に焦点を当てた簡潔なコミットメッセージを書きます。
- ブランチをプッシュします。初回のプッシュでは
-uを指定して上流を設定します。 - Git の安全規則:
mainへの強制プッシュ、フックのスキップ、git configの変更は禁止です。
4. PR の作成
gh pr create で PR を作成します。本文は /rule-validate(../rule-validate/SKILL.md)の PR Description の構成に従って記述します:Why(変更前/変更後を含む)、What changed、Eval results(RDE を実行していない場合は表を省略)、Test plan。本文は heredoc で渡します。PR の URL を返します。
5. PR の対応
/babysit を実行し、PR をマージ可能な状態にします。意図を保ちながらマージコンフリクトを解決し、未解決のコメント(Bugbot を含む)をトリアージし、このブランチのスコープ内の CI 問題を、PR がマージ可能かつ CI がすべて成功し、コメントのトリアージも完了するまで繰り返し修正します。マージはせず、結果を報告してください。
停止条件
次の場合は一時停止してユーザーに確認してください:
- レビューまたは PR 対応で、スコープを広げる変更や意図した動作を変える変更が明らかになった場合。
- 2 つのブランチの意図が実際に衝突するマージコンフリクトがある場合。
- 最新のベースをマージした後も、このブランチのスコープ外の理由で CI が失敗する場合。