eve-skill-distillation

Eve スキルの抽出

繰り返し現れるパターンを再利用可能なスキルに変換するには、このワークフローを使用します。

抽出するタイミング

• 2つ以上のジョブでワークフローが繰り返されている。
• 同じプロジェクトに取り組む他のエージェントにも役立つ知識がある。
• 繰り返し発生する障害モードがあり、その対処法を組み込む必要がある。

ワークフロー：逐次処理ではなくオーケストレーション

複数のスキルの抽出（複数のスキルの作成、一括更新、またはその組み合わせ）を行う場合は、すべてを順番に処理するのではなく、オーケストレーターパターンを使用します。これにより、コンテキストの予算を守り、独立した作業を並列化できます。

ステップ1：パターンを特定する（オーケストレーター）

最近の作業から、抽出する価値のあるパターンをすべて特定します。それぞれについて、次の点を確認します。

• 繰り返される手順、コマンド、または障害モードに名前を付ける。
• 既存のスキルを更新するか、新しいスキルを作成するかを決める。
• まず対象のリポジトリ／パックを選ぶ。次のどれに該当するかを判断する。
  • ./private-skills/ など。ほかのプロジェクトにインポートしない、リポジトリ固有の開発ワークフロー向け（プライベート）
  • ./private-eve-dev-skills/。eve-horizon リポジトリで作業しており、スキルがプラットフォーム自体の内部開発に関係する場合（プライベート）
  • ../eve-skillpacks/eve-se/。Eve プラットフォームの作業（デプロイ、認証、マニフェスト、パイプライン）向け
  • ../eve-skillpacks/eve-work/。一般的なナレッジワーク（ドキュメント、オーケストレーション、抽出）向け
  • ../eve-skillpacks/eve-design/。アーキテクチャとデザイン思考向け

ステップ2：作業項目を計画する（オーケストレーター）

作成または更新するスキルごとに、追跡可能な作業項目を作成します。各作業項目の説明は、自己完結している必要があります。事前のコンテキストがない作業者でも実行できる内容にしてください。

各作業項目には、次の内容を含めます。

• 対象ファイルのパス（例：eve-se/eve-auth-and-secrets/SKILL.md）
• 作成か更新か
• 抽出するパターン：スキルで何を教えるか
• 作業者が読むべき資料（既存のスキル、参考ドキュメント、会話履歴など）
• 作成ルール（下記「スキル作成ルール」を参照）

後片付けの更新（README、ARCHITECTURE.md）がある場合は、すべてのスキル作業項目の完了を条件とする最終作業項目として追加します。

ステップ3：作業者に割り当てる（並列）

スキルの作業項目ごとに作業者を1人割り当てます。全員を一度に起動します。

各作業者への指示は自己完結している必要があります。作業者はオーケストレーターの会話にアクセスできません。次の内容を含めます。

• 作成または編集する対象ファイルのパス
• 作成する内容を十分に詳しく説明した、抽出対象のパターン
• 下記の作成ルール
• 更新の場合は、保持する既存ファイルの内容

ステップ4：成果を集めて仕上げる（オーケストレーター）

すべての作業者が完了するまで待ちます。その後、次を行います。

• スキルが追加または削除された場合は、パックの README と ARCHITECTURE.md の一覧を更新する。
• 新規または更新された各スキルが作成ルールに従っていることを確認する。

スキルが1つの場合の簡略手順

抽出するスキルが1つだけなら、オーケストレーターパターンを省略して直接作成します。作業者を1人だけ割り当てる手間に見合う効果はありません。

スキル作成ルール

すべての作業者（または直接作成する人）は、次のルールに従う必要があります。

• フロントマター：name と description のみを含む YAML にする。
• 文体：全体を命令形にする。「コマンドを実行する」とし、「コマンドを実行してください」とはしない。
• 簡潔さ：SKILL.md は5,000語未満にする。長い詳細は references/ に移す。
• 手順だけでなく、考え方を教える：スキルは、エージェントが「何をするか」だけでなく「なぜそうするか」も理解できるようにする。状況が変わったときにエージェントが応用できるよう、ワークフローの背後にある理由を含める。
• 流し読みしやすい構成にする：見出し、短い段落、コードブロックを使う。エージェントは読み込む前にざっと目を通す。
• エージェントやツールに依存しない表現にする：どのツールを呼び出すかではなく、何をするかを説明する。「Edit ツールを使う」ではなく「ファイルを編集する」とし、「Task サブエージェントを起動する」ではなく「バックグラウンドワーカーを起動する」とする。

再帰的な蒸留

• 重要な作業の後に、このループを繰り返します。
• 重複するスキルは複製せず、統合します。
• プラットフォームの動作の変化に合わせて、スキルを最新の状態に保ちます。
• スキルの指示が実情に合わなくなったら、更新するか廃止します。