ドキュメント

MCP Fusion/Operate and integrate/スキル

スキル

VinkiusについてAIに質問

SKILL.md は AI コーディングエージェントが従う実行可能なアーキテクチャ契約です。あなたがアーキテクトであり、エージェントが MVA コードを書き、@mcpfusion/skills が指示を段階的に配布します。

MCP Fusion には、SKILL.md という機械可読なアーキテクチャ契約が同梱されています。これは AI コーディングエージェントに対して、正しい MCP Fusion コードの姿を伝えます。すべてのツールには .returns() を持つ Presenter が必要、機密フィールドには .redactPII() が必要、ツールは f.query、f.mutation、f.action から生成する、といった具合です。あなたがアーキテクトです。AI がコードを書き、契約がそのコードをパターンの中に保ちます。

スキャフォールドの動作

npx @mcpfusion/core create はプロジェクトに SKILL.md を書き込み、エージェントが既に読んでいるルールファイルに注入します:

  • .cursorrules（Cursor 用）
  • .windsurfrules（Windsurf 用）
  • .clinerules（Cline 用）

その後、エージェントに「未払い請求書を一覧するツール」を依頼すると、MVA コードが生成されます。builder、Presenter、必要な箇所での redaction、生の JSON.stringify なし、という具合です。契約は失敗について明確です。.returns() を持つ Presenter がないツールは誤った出力であり、エージェントは自ら修正します。

何かを書かせる前に、エージェントに契約を読ませてください。1 つのファイルであり、このドキュメントセクションのすべての規約がエンコードされています。チームの規約が進化したら更新してください。

@mcpfusion/skills による段階的開示

アーキテクチャ全体をシステムプロンプトに詰め込むと、コンテキストを浪費し、そのタスクに重要なルールが埋もれてしまいます。@mcpfusion/skills は指示を 3 つのレイヤーで配布します:

  1. 契約レイヤー。 MVA ルールの短い概要。常に読み込まれます。
  2. レシピレイヤー。 タスクごとの指示。タスクが一致したときに読み込まれます。ツールの追加、Presenter の合成、テストの作成などです。
  3. 参照レイヤー。 API の全表面。必要に応じて読み込まれます。

エージェントは第 2 レイヤーをそのタスクに触れたときだけ、第 3 レイヤーを正確なシグネチャが必要なときだけ読み込みます。長いコーディングセッションでも、コンテキスト予算はコード自体のために残ります。

bash
npm install @mcpfusion/skills

契約が強制すること

ルール存在する理由
すべてのツールは .returns() を持つ Presenter を添付する知覚レイヤーが Egress ファイアウォールだから
機密フィールドは .redactPII() を通すPII がモデルに届かないようにするため
ツールは f.query、f.mutation、f.action から生成するMCP アノテーションを真実のまま保つため
生の JSON.stringify レスポンスは禁止整形されていないデータはレビューされていないデータだから
ハンドラは期待される失敗に Result を返すエージェントが対処できるエラーにするため

次のステップ