fireworks-tech-graph

fireworks-tech-graph 技能總覽

fireworks-tech-graph 是做什麼的

fireworks-tech-graph 是一個繪圖技能，能把系統描述轉成可直接用於正式交付的 SVG 圖與 PNG 匯出檔。它特別適合需要 fireworks-tech-graph for Diagramming 的使用者，當輸出不只是「差不多能看」，而是必須清楚、方便分享，而且風格一致時，就很有價值。

適合誰安裝

如果你經常製作架構圖、流程圖、序列圖、代理流程圖、記憶體圖或概念圖，並且希望有可重複的工作流程，就很適合安裝 fireworks-tech-graph。它對 AI／agent 建構者、技術寫作者，以及需要把粗略系統描述快速變成圖，而不想自己手動畫形狀的開發者，特別實用。

它和一般作圖方式有什麼不同

這個 repo 不只是包了一層 prompt。它還包含安裝指引、輔助腳本、驗證機制、起始模板、風格參考，以及範例 fixtures。也就是說，fireworks-tech-graph skill 不只是一次性的 prompt，而是一套包含匯出、驗證與風格控制的作圖流程。

什麼情況下最適合用

當你在意 SVG 品質、PNG 匯出，以及跨圖表的一致視覺風格時，這個技能最合適。它最適用的輸入通常能清楚拆成實體、關係、階段或泳道。若你只是想要一張粗略草圖，或只是偏示意性的圖像、沒有技術結構需求，那它就沒有那麼適合。

如何使用 fireworks-tech-graph 技能

安裝 fireworks-tech-graph

fireworks-tech-graph 的安裝方式很直接：

npx skills add yizhiyanhua-ai/fireworks-tech-graph

只有在你要更新既有安裝時，才使用更新形式：

npx skills add yizhiyanhua-ai/fireworks-tech-graph --force -g -y

不要把 npm 套件名稱傳給 skills add；這個技能期待的是 GitHub repo 來源。

先從正確的檔案開始

如果你要快速掌握 fireworks-tech-graph，請先讀 SKILL.md，再看 scripts/README.md、references/style-diagram-matrix.md，以及最接近你目標輸出的 style-specific reference。若你想走快速路線，可以先檢視 templates/architecture.svg 或 templates/agent-architecture.svg，再搭配 fixtures/ 裡一個對應的範例。

提供適合畫圖的輸入

fireworks-tech-graph 最好的用法不是丟一個模糊需求，而是先給一份精簡規格。請包含：圖表類型、受眾、主要節點、關鍵關係、風格偏好，以及匯出需求。好的輸入像這樣：「建立一張 style 7 的 API integration flow，包含 client、SDK、model runtime、tool calls 和 delivery。匯出 SVG 與 PNG。標籤保持簡短。」

善用輔助腳本提升輸出品質

如果你想要穩定結果，最好使用輔助腳本，而不是手動改匯出檔。當你需要從既有模板快速生出起始 SVG 時，scripts/generate-from-template.py 很有用；如果你已經有 SVG，想再做驗證並輸出 PNG，scripts/generate-diagram.sh 很實用。這一點很重要，因為這個技能是為最終成品而設計的，不只是概念生成。

fireworks-tech-graph 技能 FAQ

fireworks-tech-graph 只能用來畫 AI 圖嗎？

不是。fireworks-tech-graph 最擅長的是 AI 與 agent 類型的模式，但也支援一般技術圖，例如架構圖、流程圖、序列圖，以及 UML 風格的結構圖。只要你的主題是系統關係，通常都能套用。

我需要設計能力才能用得好嗎？

不需要，但你需要把結構講清楚。fireworks-tech-graph 最適合能夠明確命名元件、分組，並說明資料或控制如何在其中流動的情況。如果你的 prompt 只有「做得好看一點」，輸出品質就會不穩定。

這跟一般 prompt 有什麼不同？

一般 prompt 可能只會產生一個圖的概念。fireworks-tech-graph 則是建立在可重複的作圖工作流程上，包含模板、風格、參考資料與匯出腳本。當你需要的是可用的 SVG+PNG 檔，而不只是圖片描述時，它會更合適。

什麼情況下不該用它？

如果你要的是行銷插圖、非技術資訊圖表，或高度藝術化的構圖，就不適合用 fireworks-tech-graph。當來源資料過於模糊，無法清楚對應成節點與邊線時，它也不是好選擇。

如何改進 fireworks-tech-graph 技能

先給結構，再談風格

品質提升最大的關鍵，是先把清楚的圖模型交給技能：角色、層級、階段、工具、儲存，以及箭頭關係。對 fireworks-tech-graph 的使用來說，「backend、database、queue、worker」遠比「我的 app 架構」更有幫助。結構越清楚，版面錯誤和含糊標籤就越少。

選對風格參考

利用 repo 裡的 style references 來限制視覺結果。如果你想要 blueprint、dark terminal，或乾淨的 OpenAI-like 風格，就要直接說明，並搭配相符的 sample 或 style number。這能幫助 fireworks-tech-graph 避免把彼此不相容的視覺模式混在一起。

留意常見失敗模式

最常見的問題是標籤太擁擠、節點太多，以及方向性不明。如果第一次輸出很亂，請把系統拆成一張圖只表達一個意圖、縮短標籤，並明確指出哪些元件必須被強調。fireworks-tech-graph guide 在你從更窄的規格開始反覆迭代時，效果最好。

用有利於匯出的方式回饋

拿到第一版圖後，請用技能能直接處理的方式回饋，例如：「把 database 往下移」、「把兩個 auth 方塊合併」、「對比再深一點」、「箭頭改成由左到右」。這比單純說「讓它更乾淨」有用得多。這樣能幫 fireworks-tech-graph 產出更接近可發佈的 SVG+PNG 第二版。