スキル作成ツール

スキル作成ツール は何をしますか？

ワークフロー

1. 契約の確立。

   • 既存のスキルとそのリソースを読み込むか、新しいスキルに対する具体的な要件を収集します。
   • 実際のワークフローブランチと、同じブランチの単なる別名を区別します。
   • 完了条件: すべてのブランチに、具体的なトリガー、期待される成果、および永続化ターゲットが定義されていること。

2. 呼び出し方法の選択。

   • モデル発見可能: モデル向けのdescriptionを記述し、disable-model-invocationは省略します。
   • 手動のみ: disable-model-invocation: true を設定し、人間向けの要約を記述します。
   • 直接ツールコマンド: コマンドがモデルをバイパスする場合にのみ、command-dispatch: tool、command-tool、command-arg-mode を追加します。
   • 完了条件: フロントマターが、スキルの実際の到達方法と一致していること。

3. スキルの構造化。

   • 共有された順序付き手順をSKILL.mdにマッピングします。すべてのステップに確認可能な完了基準を設定し、最後に検証を追加します。
   • ルーティング条件はdescriptionに保持し、本文は実行から開始します。
   • ブランチ固有の詳細はreferences/に、再利用可能なヘルパーはscripts/に、出力リソースはassets/に、オプションのUIメタデータはagents/にマッピングします。
   • 完了条件: 計画されたすべてのリソースが1つの目的を持ち、SKILL.mdから直接参照されていること。

4. ドラフト作成と永続化。

   • ライブワークスペースのスキル: skill_workshopを使用して保留中の提案を作成または修正します。適用するまでライブファイルは変更しません。
   • リポジトリ所有のスキルソース: リポジトリの通常の編集およびレビューワークフローを使用します。
   • 完了条件: 提案またはソースの差分が、ステップ1のすべてのブランチを実装し、ステップ3のすべてのリソースを含んでいること。

5. 検証。

   • 次のコマンドを実行します: python {baseDir}/scripts/quick_validate.py <skill-directory>
   • 触れたすべてのヘルパーに対して、該当するフォーカステストを実行します。
   • 完了条件: フロントマターがパスし、リソースポインタが解決され、触れたすべてのヘルパーがフォーカステストに合格していること。

フロントマター

必須: name、description。

OpenClawは、metadata、homepage、license、allowed-tools、user-invocable、disable-model-invocation、command-dispatch、command-tool、command-arg-mode もサポートしています。オプションフィールドは、ランタイムの動作やディスカバリを変更する場合にのみ追加してください。