スキル作成
4フェーズパイプライン:収集 → 精査 → 計画 → 実装
フェーズ1:収集
AskUserQuestionを使用し、4つのドメインにバッチ化された質問を行います。各ドメインにつき1回の呼び出しで、2~4の選択肢と推奨事項(最初の選択肢が (推奨))を提示します。
- 目的 — スキルはどのタスク/ドメインをカバーしますか?誰が使用しますか?
- ユースケース — このスキルをトリガーする具体的なシナリオは何ですか?どのキーワードですか?
- 構造 — スクリプトは必要ですか?参照ファイルは必要ですか?単一のSKILL.mdですか、それとも複数ファイルですか?
- ツール — どのツールや他のスキルを呼び出す、または参照すべきですか?
フェーズ2:精査
収集した要件を渡して grill-me スキルを呼び出します。skill-grill-domains.md のスキル調整済みドメイン(Intent、Scope、Design、Edge Cases)を使用するよう指示します。無関係なドメイン(Data Flow、Dependencies、Deployment、Testing)はスキップします。
フォールバック(grill-meが利用不可の場合): インラインミニ精査を実行し、AskUserQuestionを直接使用します。skill-grill-domains.md の各ドメインについて、呼び出しごとに2~4の質問をバッチ化し、推奨事項と選択肢を提示します。
フェーズ3:計画
blueprint-template.md のテンプレートを使用して、構造化されたスキル設計図を作成します。設計図は会話コンテキスト内で提示され(ディスクには書き込まれません)。ユーザーが先に進むことを承認する必要があります。ユーザーが変更を要求した場合は、修正して再提示します。
フェーズ4:実装
承認された設計図に従って、すべてのスキルファイルを作成します。完全自動化 — エージェントがすべてを記述します。
次に、quality-criteria.md の基準を使用してフェーズ4b:レビューを実行します。
- 自動検証 — 測定可能な基準(行数、説明の長さ、トリガー、参照の深さ)をチェックします。失敗がある場合は、先に進む前に修正します。
- 主観的レビュー —
AskUserQuestionを使用してチェックリストをユーザーに提示します。ユーザーが問題を指摘した場合は、修正して再検証します。
スキル構造
skill-name/
├── SKILL.md # メインの指示(必須、<100行)
├── references/ # サポートドキュメント(必要な場合)
│ └── domain-ref.md
└── scripts/ # ユーティリティスクリプト(必要な場合)
└── helper.sh
フォールバック(AskUserQuestionが利用不可の場合)
AskUserQuestion が利用できない場合は、テキストベースの質問にフォールバックします。
[ヘッダー] — [トピック] 推奨: [あなたの推奨とその理由] 代替案: (A) [選択肢] — [トレードオフ] | (B) [選択肢] — [トレードオフ]
品質基準
説明の要件、自動検証基準、主観的レビューチェックリスト、およびスクリプトの追加やファイル分割のタイミングに関するガイダンスについては、quality-criteria.md を参照してください。