preflight について
preflightは、現在のブランチを対象に本番リリース前のチェックリストを作るスキルです。マージを準備する開発者向けに、差分から確認事項を抽出し、種類と確度で整理して根拠となるファイルを示します。
主な機能
- 01mainとの差分を確認
- 02本番で必要な対応を特定
- 03種類と確度で項目を分類
- 04各項目の根拠ファイルを記載
- 05差分で裏付けられた事項のみ掲載
活用シーン
- 01マージ前にDBマイグレーションや設定変更を確認
- 02ワーカーや外部サービスの本番準備を点検
- 03本番環境の確認・監視事項を整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ unlearndev/ skills --skill preflightインストール後、Claude Code で/preflightを入力して読み込まれたか確認します。
詳細
事前確認
現在のブランチについて、本番環境への反映前チェックリストを作成します。
手順
- ベースブランチとの差分を取得します:
git diff main...HEAD。 - 変更されたすべての差分を読みます。マージ後に本番環境で対応が必要な項目を確認します。例:
- 新しい環境変数/設定キー
- 新規または変更されたデータベースマイグレーション
- キューに追加される処理(ワーカーの稼働が必要)
- 新しい外部サービス、メール、ストレージ、認証情報
- それらの項目のチェックリストを作成します。主に種類ごとに分類します。作業内容に合う自由なカテゴリを使い、差分に応じて適切なラベルを選んでください。一般的なカテゴリは次のとおりですが、これらに限定されません:
- データベース — マイグレーション、スキーマ、シードデータ。
- インフラストラクチャ — キューワーカー、スケジューラー、稼働が必要なサービス。
- 設定 — 環境変数、設定キー、認証情報。
- 運用 — 本番環境で確認または監視する項目。
- 各種類の中で、確度ごとに項目を小分類します。内容に合った確度ラベルを使ってください。例:必須(対応しないと動作しない)、要確認/可能性が高い(ほぼ確実に必要だが、環境設定による)、推奨/確認すると安心(一度確認する価値があるが、すでに対応済みの場合もある)。
- 各項目について、その必要性を示す差分内のファイルを記載します(行番号は不要)。
ルール
- 差分から実際に裏付けられる項目のみを含めます。推測で項目を追加したり、リストを水増ししたりしないでください。
- 項目がない種類や確度グループは省略します。
- 対応が特に必要な種類を先に並べます。
- 各種類は実際の見出しとして表示します。種類名を単独の行に置き、その直下に種類名と同じ幅の罫線用ダッシュ(
────)を置きます。確度ラベルは通常の小見出しのままにします。 - 出力は簡潔にします。種類の見出し、確度の小見出し、項目ごとに1行のみとします。前置きやまとめは不要です。
コメント
Markdown 対応