beautiful-mermaidによるMermaid図レンダリング
beautiful-mermaid v1.0.2 と bun を使用して、Mermaid .mmd ファイルをスタイル付きSVGにレンダリングします。
スキル構成
| ファイル | 目的 |
|---|---|
render-mermaid.ts | CLIツール：.mmd ファイルをSVGにレンダリング |
gemini-diagram-prompt.md | Gemini画像生成用プロンプト |
インストール
必要なのは bun のみです。beautiful-mermaid 依存関係は初回実行時にbunが自動インストールします。
# macOS
brew install oven-sh/bun/bun
# またはユニバーサルインストーラー
curl -fsSL https://bun.sh/install | bash
CLIリファレンス
render-mermaid — Mermaid .mmd ファイルをテーマ付きSVGにレンダリング
使用法:
bun run render-mermaid.ts [オプション] <入力.mmd...>
echo 'graph TD; A-->B' | bun run render-mermaid.ts -o 出力.svg
オプション:
-o, --output <ファイル> 出力ファイル（単一入力のみ）
--outdir <ディレクトリ> 複数ファイルの出力ディレクトリ
-t, --theme <名前> テーマ（デフォルト: tokyo-night）
--list-themes 利用可能なテーマを一覧表示
--help このヘルプを表示
出力デフォルト： -o または --outdir が指定されない場合、各入力ファイルの隣に <名前>.svg を書き込みます（-d は bun run によって吸収されるため、--outdir を使用してください）。
ショートカット： 短いコマンドのために MERMAID=plugins/autorun/skills/mermaid-diagrams/render-mermaid.ts を設定してください。
例
MERMAID=plugins/autorun/skills/mermaid-diagrams/render-mermaid.ts
# 単一ファイルのレンダリング（入力の隣に出力）
bun run $MERMAID diagram.mmd
# 特定の出力先にレンダリング
bun run $MERMAID diagram.mmd -o pretty.svg
# すべての .mmd ファイルを出力ディレクトリにレンダリング
bun run $MERMAID docs/diagrams/*.mmd --outdir docs/diagrams
# 異なるテーマ
bun run $MERMAID -t dracula diagram.mmd
# 標準入力からのパイプ
echo 'graph TD; A-->B-->C' | bun run $MERMAID -o quick.svg
# テーマ一覧
bun run $MERMAID --list-themes
プロジェクト図
Mermaidソースファイル（.mmd）とレンダリング出力（.svg）は docs/diagrams/ にあり、さらに1つのソースがリポジトリルートにあります：
| ソース | 説明 |
|---|---|
docs/diagrams/autofile-policy.mmd | AutoFileポリシーのフローチャート |
docs/diagrams/three-stage-autorun.mmd | 3段階オートランのフローチャート |
autorun-architecture.mmd | 完全なアーキテクチャ（beautiful-mermaidには複雑すぎる） |
再生成：
bun run $MERMAID docs/diagrams/*.mmd --outdir docs/diagrams
既知の制限
- 深くネストされたサブグラフを含む複雑な図では、dagreレイアウトのバグが発生する可能性があります。失敗した図は報告されますが、他のレンダリングを妨げることはありません。
%%{init:...}%%フロントマターは自動的に除去されます（beautiful-mermaidが独自のテーマを適用します）。
<image_generation>
Gemini画像生成
gemini-diagram-prompt.md には、Geminiが成果重視のプロジェクト概要画像を生成するためのプロンプトが含まれています。プロンプトをコピーしてGeminiの会話に貼り付けてください。
</image_generation>