nifdi プラグイン

nifdi ダイアグラムプラグイン: @nifdi/mcp ダイアグラムサーバーに、それを教える スキルを同梱したもの — モデルの深掘り、配置文法、実践的なレシピ、そして作ったものが意図した見た目になるように保つビルドループ。

サーバーは動詞の表面です。スキルは技術です。これらは一つのものとしてインストールされます。

インストール

claude plugin marketplace add nifdi-app/nifdi-plugin

claude plugin install nifdi@nifdi-plugin

これにより、このリポジトリがマーケットプレイスとして登録され、プラグインがインストールされます: nifdi-diagram MCP サーバー(npx -y @nifdi/mcp@<pinned> で起動)に加えて、タスクが必要とするときにクライアントが段階的に読み込むスキル群。

Claude Code ではディレクトリ設定は不要です — プロジェクトルートを自動的に注入し、ダイアグラムは作業中のリポジトリに .nifdi.svg ファイルとして保存されます。そうでないクライアントでは、NIFDI_ROOT を保存先フォルダに設定してください。

サーバー単体は、教育レイヤーなしでも、これまでとまったく同じようにインストール可能です:

claude mcp add nifdi-diagram -s project -- npx -y @nifdi/mcp@latest

この中身

.claude-plugin/plugin.json       the plugin: pins the server version, ships the skills
.claude-plugin/marketplace.json  the single-plugin marketplace
skills/nifdi/                    the core skill: the model, placement, styling, connectors, workflow
test/                            contract CI — every fenced example, through the pinned server

コアスキルの SKILL.md は、サーバー自身の指示と同じ高さにあるインデックスです。詳細は skills/nifdi/references/ にあり、クライアントは選択したパスが必要とした場合にのみ読み込みます。

素のサーバーは依然として単独で機能する

スキルはオプションのコンテキストです — 素の MCP クライアントはそれらを決して見ません。したがって、エージェントがツールを正しく使うために必要なものは、スキルだけに存在することはありません。ここにあるのは境界のないレイヤーです: モデルの深掘り、レシピ、スタイル判断、プロバイダー規約。契約 — 各ツールが何をするか、何を受け入れ、何を拒否するか — はサーバーに残り、すべてのクライアントに配信されます。

その帰結はさらに重要です: 動作の欠陥はサーバーで修正され、スキルでごまかされることは決してありません。 壊れたツールを回避する方法をエージェントに教えるスキルは、すべての素の MCP クライアントからその欠陥を隠してしまいます。CONTRIBUTING.md を参照してください。

スキルも契約である

すべてのスキル内のすべてのフェンス付き例は、公開された @nifdi/mcp を通じて CI によって実行されます — サーバーが自身の引用例に適用するのと同じ往復規律を、外部から適用したものです。XML がもはやパースできないレシピ、または主張する結果がツールの報告と一致しなくなったレシピは、ビルドを失敗させます。

スキルはテストされたサーバーバージョンを固定し、マニフェストは両方を一緒に固定するため、インストールは一貫したペアになります。スケジュールされた実行は、スキルを @nifdi/mcp@latest に対してもテストするため、レシピを無効化するサーバーリリースは、エージェントがダイアグラム作成中に発見するのではなく、ここで検出されます。

npm install && npm test

npm にないサーバービルド — ローカルチェックアウト、tarball、リリース候補 — に対して契約を実行するには、NIFDI_MCP_SPEC をそれに向けます:

NIFDI_MCP_SPEC=../nifdi-app/mcp npm run test:examples

ステータス。 @nifdi/mcp@0.1.1 — このリポジトリが固定しているバージョン — はまだ npm に公開されていません。 公開されるまで、上記のインストールコマンドと固定された CI ジョブはサーバーを解決できず、 契約は NIFDI_MCP_SPEC 経由でのみ実行されます。

コントリビューション

プロバイダー規約 — 良い AWS、Azure、GCP ダイアグラムがどのようなものか、そしてどの nifdi 語彙がそれを生み出すか — が代表的なコントリビューションの場です: 価値があり、範囲が定められており、nifdi 内部へのアクセスを必要としません。CONTRIBUTING.md に基準とローカルでのチェック実行方法があります。

ライセンス

Apache-2.0。nifdi アプリケーション自体はクローズドですが、この教育レイヤーはオープンです。