fireworks-tech-graph

fireworks-tech-graph 技能概览

fireworks-tech-graph 是做什么的

fireworks-tech-graph 是一款将系统描述转成可直接用于生产的 SVG 图和 PNG 导出的绘图技能。它最适合需要 fireworks-tech-graph 用于 Diagramming 的用户：输出不仅要“差不多能看”，还要清晰、可分享、风格一致，而不是靠一个通用提示词随手生成的“过得去”图。

适合谁安装

如果你经常制作架构图、流程图、时序图、Agent 图、记忆图或概念图，并且希望有一套可重复的工作流，就值得安装 fireworks-tech-graph 技能。它对 AI/Agent 构建者、技术写作者、以及需要把粗略系统描述快速变成图，而不想手工拖拽形状的开发者尤其有用。

它有什么不同

这个 repo 不只是一个 prompt 包装器。它还包含安装说明、辅助脚本、校验机制、起步模板、样式参考和示例 fixture。也就是说，fireworks-tech-graph 技能不只是“一次性出图提示词”，而是给你一整套带导出、校验和样式控制的绘图工作流。

什么时候最适合用

当你在意 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，以及最接近你目标输出的那份样式专用参考。如果你想走最快路径，可以先查看 templates/architecture.svg 或 templates/agent-architecture.svg，再配合 fixtures/ 里一个对应的示例 fixture。

提供可直接出图的输入

fireworks-tech-graph 的最佳用法不是给一个模糊请求，而是先提供一份简洁明确的规格。建议包含：图的类型、受众、主要节点、关键关系、风格偏好和导出需求。一个好的输入示例如下：“创建一个 style 7 的 API 集成流程图，包含 client、SDK、model runtime、tool calls 和 delivery。导出 SVG 和 PNG。标签保持简短。”

用辅助脚本提高输出质量

如果你想要稳定结果，最好使用辅助脚本，而不是手工改导出的文件。scripts/generate-from-template.py 适合在已知模板上快速生成起始 SVG。scripts/generate-diagram.sh 适合你已经有 SVG、但还想做校验并导出 PNG 的情况。这一点很重要，因为这个技能优化的重点是最终成品，而不只是概念生成。

fireworks-tech-graph 技能常见问题

fireworks-tech-graph 只适合 AI 图吗？

不是。fireworks-tech-graph 最擅长 AI 和 Agent 模式，但也支持通用技术图，比如架构图、流程图、时序图以及 UML 风格结构。只要你的主题本质上是系统关系，大概率都适合。

我需要设计能力才能用好吗？

不需要，但你需要把结构说清楚。fireworks-tech-graph 最适合能明确列出组件、分组，并说明数据或控制如何在它们之间流动的输入。如果你的提示词只有“做得好看一点”，输出质量会很不稳定。

这和普通 prompt 有什么区别？

普通 prompt 可能只能生成一个图的概念。fireworks-tech-graph 是围绕一套可重复的绘图工作流设计的，包含模板、样式、参考资料和导出脚本。对于需要可用的 SVG+PNG 文件，而不只是图片描述的场景，它明显更合适。

什么时候不该用它？

当你想要的是营销插图、非技术信息图，或者高度艺术化的构图时，不要用 fireworks-tech-graph。若源材料太模糊，没法稳定映射到节点和连线，它也不适合。

如何改进 fireworks-tech-graph 技能

先给结构，再谈风格

提升最明显的一步，是先给技能一个清晰的图模型：参与者、层级、阶段、工具、存储和箭头。对 fireworks-tech-graph 来说，“backend、database、queue、worker” 远比“我的应用架构”更有用。结构越清楚，布局错误和标签含糊的问题就越少。

选对样式参考

用 repo 里的样式参考来约束最终视觉结果。如果你想要蓝图风、深色终端风，或者干净的 OpenAI 风格，就要明确说出来，并配上匹配的样例或样式编号。这样能帮助 fireworks-tech-graph 避免把不兼容的视觉模式混在一起。

留意常见失败模式

最常见的问题是标签过长、节点太多，以及方向性不清楚。如果第一次输出比较乱，就把系统拆成一张图只讲一个意图，缩短标签，并明确哪些组件必须突出。fireworks-tech-graph 的效果最好是在更窄的规格上逐步迭代。

用面向导出的反馈方式迭代

第一版图出来后，要用技能能直接执行的方式给反馈：比如“把 database 往下移”、“合并这两个 auth 方框”、“用更深一点的对比度”或“让箭头从左到右”。这比“做得更干净一点”更有用。这样更容易让 fireworks-tech-graph 在第二轮就逼近可发布的 SVG+PNG。