元スキル作成器
このスキルを使って、再利用可能なワークフローを、実行可能・検収可能・移行可能なスキルパッケージに変換します。成果物は「長いプロンプト」ではなく、デフォルトのエントリは軽量に、詳細は必要に応じてロードされ、検証方法が再現可能な能力パッケージです。
中核契約
- ユーザーの実際のワークフローから出発し、個人的な好みのテンプレートからは始めない。
- ファイルを書く前に、そのタスクがスキル化に値することを証明する。一度きりのタスクを無理にスキルパッケージにしない。
SKILL.mdにはルーティング面のみを保持する:トリガー、最初のアクション、段階的ロード、ハードストップ、検証。- 詳細な調査、プロダクト設計、パッケージ計画、トリガー評価、検収方法、テンプレートは
references/、assets/、evals/、scripts/に格納する。 - 曖昧な意図を補完したり、ユーザーに複数回の選択を促したり、まずMVPをロックしてから一括生成する必要があるスキルは、Codex
request_user_input/ Claude CodeAskUserQuestionなどのホストネイティブな決定面を設計すること。Markdown選択カードはあくまでフォールバックの待機UIであり、実際の確認を偽装してはならない。 - 画像、動画、プレゼンテーション、ドキュメント、レポート、ダッシュボード、その他のレンダリング成果物は、優先的にImage2/ホストネイティブ機能をチェックする。MCP、スクリプト、SVG、静的プレビューはフォールバックまたは補助的なルートであり、フォールバックの証拠が必須。
- 外部の素材は品質原則としてのみ抽象化すること。他者の命名、ページ構造、ビジュアルシステム、プロンプト、サンプル、またはビジネス上のレトリックを複製してはならない。
- 毎回のデリバリーはクローズドループにする:実行証拠、レビュー所見、
writeback/proposal/none-with-reason/blockedの決定を記録し、再利用可能な学びを対応するreference、template、validator、eval、exampleに書き戻す。
段階的ロード
現在のフェーズで必要なファイルのみを読み込む:
| 現在のフェーズ | 読み込むファイル | 使用タイミング |
|---|---|---|
| 意図とドメイン調査 | references/intent-domain-research.md、assets/domain-research-brief-template.md | ユーザー入力が曖昧、ドメインが未知、戦略的判断のように見える、または一度きりのプロンプトの可能性がある場合。まずドメイン調査ブリーフを作成し、証拠が不足している場合は research-needed とマークする。 |
| 表面と成果物チェーン | references/experience-surface-model.md | スキルがファイル、メディア、スクリーンショット、プレゼンテーション、レポート、ダッシュボード、その他の可視成果物を生成する場合。 |
| プロダクト化設計 | references/product-design.md | パッケージ内のファイル構成、3分で見える結果、ユーザージャーニー、初回公開サーフェスを決定する必要がある場合。 |
| 実行契約 | references/skill-contract.md | 候補スキルパッケージに書き込む、または変更を加える前に使用する。 |
| ソース抽象境界 | references/source-abstraction-boundary.md | 外部事例、内部サンプル、競合素材を使用する場合、まず抽象化してから書き直す。 |
| パッケージ計画 | assets/package-plan-template.md | 編集前に SKILL.md、リファレンスファイル、アセット、スクリプト、評価、サンプルをマッピングする。 |
| マルチモーダル/ツールルート | references/multimodal-tooling.md、assets/multimodal-prompt-brief-template.md | スキルがImage2、ホストメディア機能、MCP、ローカルレンダラー、スクリプトに依存する場合。まずローカル機能リストとマルチモーダルブリーフを記録する。 |
| インタラクティブな決定とMVPゲート | references/interactive-mvp-product-skill.md | スキルが曖昧な意図で複数の決定をユーザーに提示する、スタイル/カバー/ファーストビュー/MVPをロックしてから一括生成する、またはCodex、Claude Codeのホスト間で確認フローを再利用する必要がある場合。 |
| 評価設計 | references/evaluation-method.md、evals/trigger-eval.json | トリガー評価、出力評価、ベースライン比較、回帰、検収チェックを設計する場合。 |
| リリースゲート | references/release-gate.md、assets/acceptance-run-template.md | 配布、移行、または他者へのデリバリーが可能だと主張する前に使用する。 |
| クローズドループガバナンス | references/closed-loop-governance.md、assets/loop-run-record-template.md | 検収、障害、振り返り、ドリフト、リリース準備、またはユーザーが「クローズドループ」を要求した場合。実行記録と書き戻し決定を必ず記述すること。 |
assets/ 内の .md ファイルは人間が記入するワークテンプレート、.json ファイルはスクリプトや検証が読み取る構造データです。対応する成果物を作成するときだけ読み込みます。scripts/ は検証、変換、パッケージング時にのみ実行し、スクリプトの内容を会話のコンテキストに貼り付けないでください。
ワークフロー
- 分類:
new-skill、refactor-skill、evaluate-skill、package-plan、またはnot-a-skillを判定する。 - フェッチと調査:パッケージの決定、成果物の表面、ツールルート、検収基準を変える証拠のみを収集する。
- 設計:成果物、トリガー境界、入出力、ローカル能力ルート、インタラクティブ決定面、MVPロックゲート、パッケージ構造、公開失敗パターンを決定する。
- 構築:現在の目標に触れるために最小限のファイルセットのみを作成または変更する。
- 検証:パッケージ検証、クローズドループ検証、ドメイン検証を実行する。構造の証拠、成果物の証拠、実行の証拠、人間による確認がそれぞれ何を証明したかを報告する。
- クローズドループ:実行記録を記入する。
writeback、proposal、none-with-reason、blockedのいずれかを決定する。再利用可能な学びのみをルールに書き戻し、チャットの要約をクローズドループと偽装してはならない。
パッケージ構造
デフォルトファイル:
SKILL.md:軽量エントリ。トリガーと実行契約を担当。references/:ドメインルール、プロダクトモデル、能力ルート、ソース抽象、評価方法、リリースゲート。assets/:記入可能なテンプレート、ワークシート、構造データ、プロンプトブリーフ。scripts/:決定論的な検証、変換、レンダリング、パッケージチェック。evals/:トリガー評価と回帰テストケース。examples/:小さくて現実的な入出力サンプル。プライベートな履歴、内部スコア、偽の実行証拠は書かない。
新しいファイルは、具体的な障害を防止する場合、またはスキルを通しやすくする場合にのみ追加する。調査ノートを保存するためだけにリファレンスファイルを追加してはならない。
ハードストップ
以下の状況では処理を停止し、ブロック理由を説明する:
- タスクが一度きりのプロンプトであり、再利用可能なワークフローではない。
- ドメインの表面が推測に基づいており、ユーザー資料、ローカル証拠、現在のソース証拠による裏付けがない。
- マルチモーダルスキルに、ローカル機能リストと出力証拠のルートがない。
- ユーザーの複数回の意思決定やMVP確認が必要だが、ネイティブ選択ツール、フォールバック待機UI、確認状態フィールド、一括生成停止ルールがない。
- パッケージがファイル生成に依存しているが、ファイル、スクリーンショット、メディア、レンダリング結果が存在することを証明する方法がない。
- トリガースコープが別のアクティブなスキルパッケージと重複しているが、ルーティング境界がない。
- 設計がプライベートな評価履歴、内部振り返り、実装の傷跡を露出させたり、外部プロジェクトの模倣と見なされる可能性がある。
検証
パッケージのルートディレクトリで以下を実行:
python scripts/check_meta_skill_package.py .
python scripts/check_closed_loop.py .
生成されたパッケージに独自のスクリプトがある場合は、実際の成果物に対しても実行する。検証時は、構造チェック、生成成果物の証拠、実行/ツールの証拠、人間による検収を明確に区別すること。一つのレベルの合格ですべての合格を代替できない。
最終報告
日本語で報告:変更したファイル、パッケージ決定、トリガー境界、段階的ロード図、検証コマンド、証明レベル、クローズドループ決定、残存リスク。小さな前後比較または出力の断片を示し、ユーザーがこのスキルパッケージが本当に使いやすくなったかを判断できるようにする。