wizard について
wizardは、手間のかかる手動手順を段階的なBashスクリプトにまとめるスキルです。共通テンプレートを使い、ブラウザー上の操作を案内して値を収集し、`.env`やGitHub secretsなどに書き込みます。
主な機能
- 01手順を順序付きの段階に分割
- 02URLを開いて操作を案内
- 03公開値とシークレット値を収集
- 04`.env`やGitHub secrets、variablesへ書き込み
- 05対話フローを実行せずスクリプトを検証
活用シーン
- 01サードパーティサービスの設定を案内
- 02`.env`に書き込む設定値を収集
- 03GitHub Actions用のシークレットと変数を準備
- 04繰り返し使えるプロジェクト設定スクリプトを作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/wizardを入力して読み込まれたか確認します。
同梱ファイルtemplate.sh
詳細
ウィザード
ウィザードとは、手作業では面倒で、毎回 AI に説明し直すのも面倒な手順を、人間が一つずつ進められるようにする bash スクリプトです。各 URL を開き、何をクリックして何をコピーするかを正確に案内し、値を取得して適切な場所（.env、GitHub のシークレット）に書き込み、各段階で確認を取り、残りの段階数を表示します。サードパーティーサービスの設定、単発のマイグレーションの実行、プロジェクトの状態の移行などに使えます。
使いやすい UX はすでに template.sh で実現されています。段階ごとの進捗表示、確認ゲート、クロスプラットフォーム対応の URL 起動（WSL を含む）、非表示のシークレット入力、冪等な .env の更新、gh secret／gh variable への書き込み、最後の概要表示に対応しています。あなたの担当は、手順の範囲を定めて各段階を作成することだけです。 STAGES マーカーより上のライブラリは、どのウィザードでも同一です。この一貫性こそが重要なので、決して手作業で編集しないでください。
ウィザードは通常、一度きりの実行を前提としています。作業用の場所や scripts/ に保存し、作業が終わったら削除します。リポジトリに残すべき再利用可能なセットアップ手順をユーザーが希望する場合にのみ、コミットしてください。
手順
1. 手順の範囲を定める
人間が行う必要のある手作業の各ステップと、その過程で取得する各値を洗い出します。まずリポジトリを確認してください。いきなり質問してはいけません。
- セットアップの場合：
.env、.env.example、.env.*、README、docker-compose*、フレームワークの設定、.github/workflows/*を確認します（secrets.*／vars.*の参照はすべて、ウィザードで用意する必要がある値です）。 - マイグレーションや移行の場合：現在の状態、移行先の状態、その間にある取り消し不能な操作を確認します。
次に、段階を順番に並べたリストと、各段階で取得する値をユーザーに提示して確認します。ユーザーは追加、削除、並べ替えを行う場合があります。
完了条件： 各段階の名前と順序が決まっており、取得する値ごとに、（a）人間がどこで取得するか、（b）どこに書き込むか（.env、GitHub のシークレット、両方、または書き込みなし — 操作のみの段階もあります）、（c）シークレットか公開情報か（シークレットの場合は非表示入力）が分かっています。
2. 各段階の手順をマッピングする
各段階について、人間がたどる正確な手順を記述します。どの URL を開き、そこで何を行い、値がどこに表示され、どの変数に設定するかを示してください。例：「ダッシュボード → 開発者 → API キー → テストキーを表示 → コピー」。現在の UI や正確なコマンドが分からない場合は、その旨を伝えてユーザーに尋ねるかドキュメントを確認してください。存在しない可能性のある手順を決して作り上げてはいけません。
完了条件： どの段階も、初めての人が実行できる具体的な手順を示しています。
3. ウィザードを作成する
template.sh を対象のパスにコピーします。サンプルの段階を置き換え、依存関係の順に各ステップを stage として記述します。ライブラリのヘルパー（stage、say／step、open_url、ask／ask_secret、write_env、set_secret／set_var、pause／confirm）を使い、TOTAL_STAGES を記述した段階の数に設定します。
テンプレートが定める基準を守ってください。値を尋ねる前に URL を開き、シークレットには ask_secret を使い、永続化する値はすべて write_env で書き込み、CI で実際に必要な値だけに set_secret を使い、取り消し不能な操作の前には confirm で確認します。各 stage では画面がクリアされ、現在のステップだけが表示されます。人間が必要とする情報がスクロールして見えなくならないよう、段階ごとに目的を一つに絞ってください。マーカーより上のライブラリには手を加えないでください。
4. 検証して引き渡す
bash -n <script>を実行します。利用できる場合はshellcheckも実行します。chmod +x <script>を実行します。- 最初から最後まで自分で実行してはいけません。ブラウザーが開き、人間の入力待ちになるためです。代わりに静的に追跡します。ステップ 1 で洗い出したすべての値が取得され、ステップ 1 で指定した場所に保存されること、そして各
set_secretの名前が CI のsecrets.*参照と完全に一致することを確認します。 - 実行方法をユーザーに伝えます。再利用可能なセットアップ手順であれば、コミットして README からリンクし、次の人が AI に尋ねる代わりにスクリプトを実行できるようにします。
Adapted from mattpocock/skills, MIT © 2026 Matt Pocock. Keep this line if you copy this file.