mermaid

Mermaid スキル

公式の Mermaid CLI で解析・レンダリングして、Mermaid 図をすばやく検証するには、このスキルを使用します。

前提条件

• Node.js と npm（npx 用）。
• 初回実行時に、Puppeteer を介してヘッドレス Chromium がダウンロードされます。Chromium が見つからない場合は、PUPPETEER_EXECUTABLE_PATH を設定してください。

ツール

図を検証する

./tools/validate.sh diagram.mmd [output.svg]

• Mermaid のソースを解析してレンダリングします。
• 終了コードが 0 以外の場合、Mermaid の構文が無効です。
• beautiful-mermaid を使用して ASCII プレビューを出力します（ベストエフォートです。すべての図の種類に対応しているわけではありません）。
• output.svg を省略すると、SVG は一時ファイルにレンダリングされた後、破棄されます。

ワークフロー（簡易版）

1. 図を Markdown に配置する場合：まず単独の diagram.mmd として作成します（このツールはプレーンな Mermaid ファイルのみを検証します）。
2. diagram.mmd を作成または更新します。
3. ./tools/validate.sh diagram.mmd を実行します。
4. CLI に表示されたエラーを修正します。
5. 検証に成功したら、Mermaid ブロックを Markdown ファイルにコピーします。