AGENT SKILL

wizard-matt-p

インタラクティブなbashウィザードを生成し、人間だけが実行できる手順を案内します。インフラのプロビジョニング、資格情報やCIシークレットの設定、慣れていないサードパーティのダッシュボードの操作、または一度限りのマイグレーションや移行を行う場合に使用してください。エージェント自身が実行できる手順には呼び出さないでください。

License 许可
MIT
最近更新
2026-11-12
Stars
★ 0
Forks
0

01 前言 Front Matter

name
wizard-matt-p
description
インタラクティブなbashウィザードを生成し、人間だけが実行できる手順を案内します。インフラのプロビジョニング、資格情報やCIシークレットの設定、慣れていないサードパーティのダッシュボードの操作、または一度限りのマイグレーションや移行を行う場合に使用してください。エージェント自身が実行できる手順には呼び出さないでください。

02 资源文件 2

03 SKILL.md 正文

ウィザード

「ウィザード」とは、人間が手作業で行うには面倒で、毎回AIに説明するのも手間な手順を、ステップごとに案内するbashスクリプトのことです。各URLを開き、どこをクリックして何をコピーするかを正確に指示し、値を取得して適切な場所(.envやGitHubのシークレットなど)に書き込み、各段階で確認を行い、残りのステージ数を表示します。サードパーティのサービスを設定したり、一度限りの移行を実行したり、プロジェクトをある状態から別の状態に移動させたりすることがあります。

使いやすい操作は template.sh に実装済みです。ステージごとの進捗、確認、WSL を含む環境での URL 表示、秘密情報の非表示入力、.env の繰り返し実行可能な更新、gh secret / gh variable の設定、最後の要約を備えています。ここでは手順の範囲を決め、各ステージを書くことだけに集中する。 STAGES マーカーより上の共通ライブラリは編集しない。

ウィザードはデフォルトで一時的です:1回の実行向けに作られ、スクラッチや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をターゲットパスにコピーします。依存関係の順に、例のステージを1ステップごとに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に尋ねる代わりにスクリプトを実行できるようにしてください。

04 同仓库更多 Skills

seiei-sogen
seiei-sogen/agent-skills

why

「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

what-did-i-get-done

ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する

★ 0
seiei-sogen
seiei-sogen/agent-skills

unslop

あらゆる文章から AI の痕跡を削る。常に適用しなければならない。

★ 0
seiei-sogen
seiei-sogen/agent-skills

typescript-best-practices

TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

thermo-nuclear-code-quality-review

抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

technical-writing

階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。

★ 0