oma-skill-creator

Skill Creator - SSL-lite スキル作成スペシャリスト

Scheduling

Goal

Scheduling-Structural-Logical スキル表現から派生した SSL-lite Markdown 構造を使用して、OMA スキルを作成、改訂、検証します。その際、成果物の読みやすさ、実行可能性、保守性を維持します。

Intent signature

• 新しい OMA スキル、エージェントスキル、スペシャリストスキル、または .agents/skills/*/SKILL.md の作成をユーザーが求めている。
• スキルをプロジェクトのスキル形式に変換、または正規化するようユーザーが求めている。
• スキルに十分なスケジューリング、構造、論理、参照、または標準的な実行の詳細があるかどうかをユーザーが尋ねている。
• ユーザーが SSL-lite、Scheduling / Structural / Logical、スキル形式、スキルテンプレート、またはスキル作成者に言及している。

When to use

• .agents/skills/{name}/SKILL.md に新しいスキルを作成する場合
• 既存の OMA スキルを SSL-lite 形式に更新する場合
• 実行中心のスキルに Canonical command path または Canonical workflow path を追加する場合
• ルーティング、実行、検証、復旧のロジックでスキルが利用可能か監査する場合
• 詳細な例を本文内に含めるか、resources/ に配置するかを判断する場合

When NOT to use

• サードパーティ製スキルを $CODEX_HOME/skills にインストールする場合 → Codex の組み込みスキルインストーラーを使用します（外部ツールであり、OMA スキルではありません）
• Codex プラグインバンドルを作成する場合 → Codex のプラグインツールを使用します（外部ツールであり、OMA スキルではありません）
• スキル作成に関係のない一般的なプロジェクト計画を作成する場合 → PM Agent を使用します
• 製品コード、インフラストラクチャ、フロントエンド、バックエンド、またはモバイルの実装を直接編集する場合 → 該当するスペシャリストスキルを使用します

Expected inputs

• skill_name：対象のディレクトリ名。oma-{domain} を推奨します
• skill_goal：スキルで追加する機能
• trigger_intents：スキルを有効化するユーザーのプロンプトまたはドメイン
• boundaries：スキルを使用すべきでない状況と、その場合に対応するスキル
• execution_model：スキルがコマンド中心、ワークフロー中心、判断中心、参照中心のいずれか
• スキルで維持すべき既存のファイル、ツール、コマンド、リソース、または標準

Expected outputs

• SSL-lite のトップレベルセクションを使用した、完全な SKILL.md
• 段階的な情報開示または決定論的な実行に必要な場合に限り、任意の resources/*.md、config/*.yaml、scripts/*、または assets/*
• 構造、ルーティング、実行のチェック、および未解決の前提条件を含む検証レポート

Dependencies

• .agents/skills/*/SKILL.md にある既存の OMA スキル規約
• resources/ssl-lite-template.md にある SSL-lite テンプレート
• resources/validation-checklist.md にある検証チェックリスト
• 近接するスキルの読み込みと出力の確認に使用するローカルファイルシステムおよび検索ツール

Control-flow features

• 新しいスキルの作成と既存スキルの更新を分岐します
• コマンド中心、ワークフロー中心、参照中心のスキル種別を分岐します
• ローカルのスキルファイルを読み書きします
• ユーザーによる編集を維持し、無関係な書き換えを避ける必要があります

Structural Flow

Entry

1. タスクが新しいスキルの作成、既存スキルの更新、スキルの監査のいずれに該当するかを特定します。
2. 表現や構造を決める前に、近接する、または類似する OMA スキルを読みます。
3. スキルの種別を、コマンド中心、ワークフロー中心、判断中心、参照中心のいずれかに分類します。

Scenes

1. PREPARE：スキルの目的、トリガーとなるインテント、境界、入力、出力、依存関係、リスクとリソースの制約を収集します。
2. ACQUIRE：類似するスキル、既存のリソース、プロジェクト規約、ユーザーが提供したソース資料を読みます。
3. REASON：SKILL.md 本文に含める内容と、resources/、config/、scripts/、assets/ に配置する内容を決定します。
4. ACT：SSL-lite テンプレートを使用してスキルを作成または更新します。
5. VERIFY：構造、ルーティング、実行、リソース、書式を確認します。
6. FINALIZE：作成・変更したファイル、検証結果、残っている前提条件を報告します。

遷移

• スキルが壊れやすいコマンドや繰り返し実行するコマンドを扱う場合は、### Canonical command path をインラインで含めます。
• スキルが主に人間の判断や調査を扱う場合は、### Canonical workflow path をインラインで含めます。
• 詳細な例が長い場合、バリエーション固有の場合、または任意の場合は、resources/ に移動し、明示的に参照します。
• 既存のスキルがある場合は、機能している内容を維持し、対象形式に必要な箇所だけを整えます。
• トリガーの説明が広すぎる場合は、スキルを作成する前に範囲を絞ります。

失敗と復旧

失敗	復旧
スキルの範囲が別のスキルと大きく重複している	明確な When NOT to use の境界を追加し、適切なスキルへ振り分けます
実行手順が曖昧である	正規のコマンドパスまたはワークフローパスをインラインで追加します
SKILL.md が長くなりすぎる	詳細な例を resources/ に移動し、References にナビゲーションを残します
信頼できる検証コマンドがない	構造を確認する grep/awk チェックと手動チェックリストによる検証を使用します
ユーザー入力の詳細が不足している	対象の動作が安全でなくなる場合を除き、控えめな仮定を置いて列挙します

完了条件

• 成功：スキルに SSL-lite のトップレベルセクションが4つあり、正規パス、明確な振り分け境界、リソースの制約、検証の証拠が揃っています。
• 部分的な成功：構造は有効ですが、コマンド、ツール、ソース資料、またはユーザーの判断が不足していることを報告します。
• 失敗：スキルファイルが作成されていないか、解消を妨げる曖昧さが明示されています。

論理操作

アクション

アクション	SSL プリミティブ	証拠
類似するスキルを読む	READ	既存の .agents/skills/*/SKILL.md
スキルの種類を選択する	SELECT	コマンド／ワークフロー／判断／リファレンス中心の分類
境界を推定する	INFER	トリガーとなる意図と、隣接するスキルとの重複
スキルファイルを書く	WRITE	新規または更新された SKILL.md
リソースを追加する	WRITE	resources/、config/、scripts/、または assets/
構造を検証する	VALIDATE	見出しと正規パスのチェック
結果を報告する	NOTIFY	変更したファイルと検証の概要

ツールと手段

• rg、find、awk、sed、git diff --check
• 手動でファイルを編集するための apply_patch
• 例としての既存の OMA スキル
• 正規のセクション構成としての resources/ssl-lite-template.md
• 受け入れ基準としての resources/validation-checklist.md

正規のワークフローパス

1. 作成前に、類似する既存のスキルを1～3件読みます。
2. 新しいスキルを、コマンド中心、ワークフロー中心、判断中心、またはリファレンス中心に分類します。
3. resources/ssl-lite-template.md をもとに SKILL.md の草案を作成します。
4. 次のいずれか1つの正規パスをインラインで含めます。
   • 壊れやすいコマンドや繰り返し実行するコマンドには、### Canonical command path
   • 判断、レビュー、設計、または調査の流れには、### Canonical workflow path
5. 長い例、プロバイダー固有の詳細、または任意のプロトコルを resources/ に移動します。
6. トップレベルの見出し、正規パスの有無、フロントマター、空白を検証します。

リソースの範囲

範囲	リソースの対象
CODEBASE	.agents/skills/*/SKILL.md、隣接するリソース、プロジェクトのスキル規約
LOCAL_FS	新しいスキルディレクトリとリソースファイル
PROCESS	検証コマンドと任意の生成／チェック用スクリプト
MEMORY	ユーザー要件、仮定、検証メモ

前提条件

• 対象となるスキル名と目的が既知であるか、安全に推定できます。
• 隣接するスキルとの重複を確認済みです。
• プロジェクトのルールで .agents/ が保護されている場合、ユーザーが .agents/skills/ 配下の変更を許可しています。

影響と副作用

• .agents/skills/ 配下にファイルを作成または変更します。
• 段階的な情報開示を支援するリソースファイルを追加する場合があります。
• 明示的に依頼されない限り、変更をステージングまたはコミットしません。

ガードレール

1. 4 つのトップレベルセクションを正確に維持してください：Scheduling、Structural Flow、Logical Operations、References。
2. 明確な name と description を含む YAML フロントマターを維持してください。ルーティングは説明の品質に左右されます。説明を編集したら oma skills audit を実行し、新しい文言が隣接するスキルと衝突しないことを確認してください（TF-IDF コサイン類似度が 60% 以上で警告、75% 以上で失敗）。
3. 具体的な「使用しない場合」の境界条件と、隣接するスキルへのクロスルートを含めてください。
4. 想定される入力、出力、依存関係、制御フロー機能を含めてください。成果物を glob で指定できる場合は、構造化された outputs: ブロックを優先してください。そうすることで oma verify がクローズチェックを実行できます。
5. 実用的な範囲で、SSL シーンの語彙（PREPARE、ACQUIRE、REASON、ACT、VERIFY、RECOVER、FINALIZE）を使って構造的なシーンを記述してください。
6. READ、SELECT、VALIDATE、INFER、WRITE、CALL_TOOL、NOTIFY、TERMINATE などの SSL プリミティブを使って論理アクションを含めてください。
7. ファイルシステム、コードベース、プロセス、認証情報、ネットワーク、ユーザーデータ、メモリのリソーススコープとリソースターゲットを含めてください。
8. 特にコマンド、ネットワーク呼び出し、認証情報、破壊的な操作、生成ファイル、長時間実行プロセスについて、影響と副作用を含めてください。
9. エージェントがすべてのリソースファイルを読み込まずに実行または推論できるよう、正規のパスを 1 つインラインで記載してください。
10. バリエーション固有の長い詳細は、メインのスキル本文ではなく resources/ に記載してください。
11. スキル内に追加の README、変更履歴、インストール用ドキュメントを作成しないでください。
12. 無関係なユーザー編集を上書きしないでください。

参考資料

• SSL-lite テンプレート：resources/ssl-lite-template.md
• 検証チェックリスト：resources/validation-checklist.md
• 共有コンテキストの読み込み：../_shared/core/context-loading.md
• 共有品質原則：../_shared/core/quality-principles.md
• スキルの有用性評価：新しいスキルを作成する場合は、.agents/eval/<skill>/ に保留タスクのフィクスチャを追加し、oma skills eval でスキルがタスクの成果を改善するか測定することを検討してください。フィクスチャのスキーマとチェッカーの種類については、web/docs/guide/skill-eval.md を参照してください。