npmパッケージにおけるエージェントスキル：ライブラリ知識をエージェントに届ける

この記事では、AIエージェントの指示のためのオープンフォーマットであるAgent Skillsを、npmパッケージを介して配布することについて説明しています。エージェントが新しいライブラリに遭遇したとき、ソースコードを探索することは効果的ですが非効率です。著者は要点を知っており、パッケージ内のskills/ディレクトリにあるSKILL.mdファイルにそれらをエンコードできます。このファイルにはYAMLメタデータと指示が含まれ、詳細は必要に応じてreferences/を参照します。例えば、@teqfw/dbには、パッケージを正しく使用する方法、プライベートAPIを回避する方法、トランザクション境界を尊重する方法、DB再構築中に仮定を立てない方法をエージェントに伝えるこのようなスキルが含まれています。スキルをnpmパッケージに同梱することで、エージェントがバージョンに一致した指示を確実に取得でき、インストール時に更新され、ロールバック時にも対応します。ただし、node_modulesにスキルがあるだけでは自動的に有効になりません。プロジェクトは、.agents/skills内のシンボリックリンクなどを通じて、どの依存関係がエージェントの動作に影響を与えるかを制御するために、スキルを明示的にリンクする必要があります。著者はこれをTeqFWパッケージ、例えば@teqfw/di、cfg、cli、log、db、@flancer32/teq-webで実装しています。制限としては、誤解釈の可能性、古くなったスキル、コンテキストの肥大化などがあり、スキルは簡潔で、コード、型、READMEを補足するものであるべきです。関連研究には、Agent SkillsリポジトリのRFCとskills-npmプロジェクトがあります。著者はこのパターンを「依存関係に束縛されたエージェントスキル」と呼んでいます。