example-skill

サンプルスキル

目的

一貫性があり、再利用可能なスキルを作成するための、仕様に準拠したテンプレートを提供します。

使用するタイミング

• このリポジトリに新しいスキルを追加する場合。
• 必須セクションを含むひな形が必要な場合。

ワークフロー

1. 目的を1文で述べます。
2. 必要な入力のみを集めます。
3. 決定論的な手順を実行します。
4. 必要な場合にのみ、詳細なコンテキストを読み込みます：
   • references/REFERENCE.md
   • assets/output-template.md
   • agents/openai.yaml
5. 安定した形式で出力を返します。
6. 決定論的な事前チェックには scripts/example-check.sh を使用します。

入力

• タスクの目的
• 制約
• 出力先

出力

• 主な成果物
• フォローアップのチェック

例

• 必須セクションと有効なフロントマターを含む、新しいスキルのひな形を作成します。
• 詳細な内容を references/ に移すよう、既存のスキルをリファクタリングします。
• 繰り返し実行できる検証のために、scripts/ の下に決定論的なチェックを追加します。

エッジケース

• フロントマターのフィールドが不足している場合：処理を停止し、まず必須フィールドを追加します。
• name の形式が無効な場合：小文字とハイフンの形式に正規化し、ディレクトリ名と一致させます。
• リソースパスが壊れている場合：参照されているすべてのファイルが存在するようにリンクを修正します。

ガードレール

• 指示は具体的で、テスト可能なものにします。
• 不要なコンテキストの読み込みは避けます。
• 手動の手順より、決定論的なコマンドを優先します。
• SKILL.md からファイル参照までの階層は1段に保ちます。