レポートコンパイルエージェント - 分析結果のMarkdownファイルを統合HTMLレポートに変換。/compile-report [出力パス] で呼び出し。

name: compile-report description: レポートコンパイルエージェント - 分析結果のMarkdownファイルを統合HTMLレポートに変換。/compile-report [出力パス] で呼び出し。 user_invocable: true

Report Compiler Agent

分析結果のMarkdownファイルを統合HTMLレポートに変換するエージェントです。

目的

このエージェントは以下の機能を提供します：

Markdownの自動検出・統合 - 各ディレクトリ内のすべてのMarkdownファイルを動的に検出し統合
Mermaid図のレンダリング - Mermaid図をインライン埋め込み
GraphDB可視化 - D3.jsインタラクティブグラフを埋め込み
目次生成 - 自動的にサイドバー目次を生成
スタイリング - プロフェッショナルなスタイルを適用（ライト/ダークテーマ）
レスポンシブ - モバイル/印刷対応
重複除去 - ファイル名の命名規則が異なる重複ファイルを自動的に除去

前提条件

Python 3.9+
markdown パッケージ
pymdown-extensions パッケージ
（オプション）mermaid-cli（Mermaid図の検証用）

実行プロンプト

あなたはレポートをコンパイルする専門家エージェントです。以下の手順でHTMLレポートを生成してください。

Step 1: 環境確認

# 必要なパッケージの確認
source .venv/bin/activate
pip install markdown pymdown-extensions

Step 2: Mermaid図の検証（推奨）

レポート生成前にMermaid図の構文エラーをチェックします。

# mmdc がインストールされている場合
/fix-mermaid ./reports

注意: Mermaidの予約語問題

以下の単語はMermaidのsequenceDiagramで予約語として解釈されるため、participant名として使用しないでください：

予約語	代替案
`BOX`	`BoxAPI`, `BoxPlatform`, `BoxWebhook`
`box`	同上

例:

# NG
participant BOX as BOX Platform

# OK
participant BoxPlatform as BOX Platform

Step 3: レポートコンパイルスクリプトの実行

source .venv/bin/activate && python scripts/compile_report.py \
  --input-dir ./reports \
  --output ./reports/00_summary/full-report.html \
  --title "リファクタリング分析レポート"

Step 4: 出力形式

統合HTMLレポート

<!DOCTYPE html>
<html>
<head>
    <title>リファクタリング分析レポート</title>
    <script src="mermaid.min.js"></script>
    <script src="d3.v7.min.js"></script>
    <style>/* プロフェッショナルスタイル */</style>
</head>
<body>
    <nav class="sidebar"><!-- サイドバー目次 --></nav>
    <main class="main-content">
        <section id="summary"><!-- エグゼクティブサマリー --></section>
        <section id="analysis"><!-- 分析結果 --></section>
        <section id="evaluation"><!-- MMI評価 --></section>
        <section id="design"><!-- 設計書 --></section>
        <section id="stories"><!-- ドメインストーリー --></section>
        <section id="graph">
            <!-- ナレッジグラフ -->
            <!-- D3.jsインタラクティブビューア -->
        </section>
    </main>
</body>
</html>

Step 5: コマンドオプション

オプション	説明	デフォルト
`--input-dir`	入力ディレクトリ	./reports
`--output`	出力HTMLファイル	./reports/00_summary/full-report.html
`--title`	レポートタイトル	リファクタリング分析レポート
`--theme`	テーマ (light/dark)	light

機能詳細

Markdownファイルの自動検出

スクリプトは各レポートディレクトリ（00_summary, 01_analysis, 02_evaluation, など）から自動的にすべてのMarkdownファイルを検出します。

動作:

優先ファイルリストに従って順序を決定
ディレクトリ内の他のMarkdownファイルを自動検出
ファイル名の命名規則の違い（target-architecture.md vs target_architecture.md）による重複を自動除去
サブディレクトリ（visualizations/など）も検索対象

対応するファイル構造:

reports/
├── 00_summary/          # エグゼクティブサマリー
├── 01_analysis/         # システム分析（全ファイル自動検出）
├── 02_evaluation/       # MMI評価
├── 03_design/           # 設計（API、ScalarDB含む全ファイル）
├── 04_stories/          # ドメインストーリー（個別ストーリー含む）
├── 05_estimate/         # コスト試算
└── graph/               # ナレッジグラフ（サブディレクトリ含む）

GraphDB可視化の統合

reports/graph/visualizations/graph.htmlが存在する場合、自動的にインタラクティブグラフをレポートに埋め込みます。

機能:

ノードのドラッグ移動
マウスホイールでズーム
ノードホバーで詳細表示（名前、タイプ、グループ）
ノード検索
凡例表示（Domain/Entity/Term）

前提:

/build-graph でGraphDBが構築済み
/visualize-graph で可視化ファイルが生成済み

Mermaid図のレンダリング

Markdownファイル内のmermaidブロックを自動的に<div class="mermaid">に変換し、Mermaid.jsでレンダリングします。

対応図:

flowchart / graph
sequenceDiagram
classDiagram
stateDiagram
erDiagram
gantt
xychart-beta

非対応:

radarChart（xychart-betaで代替）

出力ファイル

reports/
└── 00_summary/
    └── full-report.html   # 統合HTMLレポート (約450KB)

使用例

例1: 基本的なコンパイル

/compile-report

例2: カスタムタイトルとダークテーマ

/compile-report --title "My Project Report" --theme dark

例3: ブラウザで開く

open reports/00_summary/full-report.html

トラブルシューティング

Mermaid図が表示されない

ブラウザのコンソールでエラーを確認
/fix-mermaidで構文エラーをチェック
予約語（BOX等）を使用していないか確認

GraphDBビューアが表示されない

reports/graph/visualizations/graph.htmlの存在を確認
/visualize-graphを実行してファイルを生成

日本語が文字化けする

HTMLファイルがUTF-8で保存されているか確認
ブラウザのエンコーディング設定を確認

ナビゲーション

Skillsとは？

リンク

compile-report