yizhiyanhua-ai/fireworks-tech-graph

解決する課題

fireworks-tech-graph は、手作業で技術図表を描く必要性をなくします。ユーザーは自然言語（英語または中国語）でシステムアーキテクチャやフローを記述するだけで、幾何学的にチェックされた洗練された図表を SVG、PNG、インタラクティブ HTML 形式、およびセマンティック GIF アニメーションとして自動生成できます。

仕組み

このプロジェクトは、Codex や Claude Code などの AI アシスタント用のエージェントスキルとして機能します。品質を確保するために、制限付きの検証ループに従います：

1. 生成: 自然言語のプロンプトをセマンティック中間表現 (IR) に変換し、次に SVG に変換します。
2. 決定論的検証: XML 構造、マーカーの整合性、およびパスのジオメトリをチェックして、エッジの重複やウェイポイントの不正な形成などのエラーを防ぎます。
3. 知覚的検証: SVG を PNG にレンダリングし、視覚的な読み戻しを実行して、クリッピング、ラベルの衝突、およびルーティング品質を検査します。
4. ターゲットを絞った修正: エラーが見つかった場合、システムは最終的な納品前に特定の座標やラベルに対して的を絞った修正を行います。

対象者

• ソフトウェアエンジニア: C4 レビュー、クラウドデプロイメントマップ、イベント駆動アーキテクチャ図の作成用。
• AI/エージェント開発者: RAG パイプライン、マルチエージェントコラボレーション、メモリアーキテクチャの視覚化用。
• テクニカルライター: 手動描画ツールなしで、一貫性のある高品質なドキュメント用ビジュアルを生成する用。

ハイライト

• 12種類のビジュアルスタイル: 11種類のジェネレーターベースのスタイルと、1種類の AI 作成の「Dark Luxury」スタイルを含みます。
• エンジニアリングコントラクト: 特定の図表タイプ（例：C4、Cloud Fabric、Event Transit）に対して厳格なルールを適用し、技術的な正確性を確保します。
• 包括的なサポート: 14種類の UML 図表タイプと、特殊な AI/エージェントドメインパターン（例：Mem0、Tool Call フロー）をサポートします。
• セマンティックモーション: SVG を GIF に変換し、コネクタが特定のセマンティック順序で描画され、「settled-flow」タイムラインを持ちます。
• ジオメトリセーフルーティング: 決定論的な直交ルートを使用して、線の交差を回避し、曲げを最小限に抑えます。
• インタラクティブなエクスポート: パン/ズーム、テーマ切り替え、および複数のエクスポート形式を備えたオフライン HTML ファイルを生成します。