メインコンテンツまでスキップ

generate-domain-model-from-code plugin

generate-domain-model-from-code Skillと、出力・保護ファイル・実行の終了を検査するhooksをまとめたpluginです。対象形式はCodexとClaude Codeです。

渡す情報​

Skillには対象コードと調査範囲を渡します。利用環境にPython 3.9以上、Mermaid CLI、起動可能なブラウザーが必要です。配布物にはこれらの外部ツールを含めません。

依頼例​

注文と支払いのコードから、根拠付きのドメインモデル図を作ってください。
PNGとHTMLカタログまで生成し、未確認の関係は確認事項として残してください。

進め方​

  1. 導入を始めるで生成と導入の違いを確認します。
  2. python3 utils/plugins/generate-domain-model-from-code/build.py --agent codex --output /tmp/domain-model-codex で対象Agentの配布物を生成します。Claude Code用は --agent claude-code にします。
  3. 生成した配布物を対象Agentで読み込みます。Codexのhooksは利用者が信頼するまで実行されません。
  4. 対象コードを指定してSkillを実行し、検査済みのカタログを確認します。

hooksはSkillの実行中に出力の検査、保護ファイルの編集の制止、応答終了前の確認を行います。scripts/gate.py が同梱したSkillのランタイムへ渡すため、出力の契約はSkill側で一元管理します。自動のSkill起動と、生成したpluginが実クライアントで有効になることは別々に確認します。

成果物の例​

新しいサブエージェントが正本から両Agent向けの配布物を生成しました。各95ファイルの内容とZIP展開後の内容が正本と一致し、配布物内のhookコマンドが検査の省略指定と保護ファイルの編集を制止することを隔離環境で確認しています。

この例の到達点は配布物の生成・内容検証と、隔離環境でのhookコマンドの実行です。実クライアントへの導入・有効化とイベント配送は未確認です。コードからカタログを作る実行例はSkillガイドで確認できます。

確認するポイント​

対象Agentのmanifest・hooksを選んでいるか、同梱Skillが正本と一致するかを確認します。配布物の生成・コマンドによるhooks検査と、実クライアントでの導入・有効化は区別します。

正本を読む​

plugin定義とビルド処理とSkill正本を参照してください。