Agent Skills
返回列表
💻

Canvas 图表专家

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/canvas-zh

技能介绍

问题

架构图、流程图和依赖图很容易画成“看起来正确”但脱离代码状态的静态产物。Canvas 关注的是把代码、路由、数据模式、认证流程或 UX 上下文转成可维护、可验证、可读的图表,而不是仅生成一张演示图。

工作方式

  • 默认输出:优先使用 Mermaid,需要可编辑或演示级输出时使用 draw.io,终端或注释安全场景使用 ASCII。
  • 真实名称:节点和边应使用真实文件、函数、路由、实体或状态名,避免 A、B、node1 这类泛化 ID。
  • 工作流:按 UNDERSTAND → ANALYZE → DRAW → REVIEW 推进,先确认源类型、受众和要回答的问题,再提取实体、关系、流程和约束。
  • 配方覆盖:支持 flow、sequence、er、class、c4、architecture、gantt 和 Echo 旅程等模板,并按节点、消息或任务数量控制复杂度。
  • 质量检查:交付前检查语法、可读性、图例、来源、无障碍替代文本、颜色对比度和“扇出陷阱”。

适用边界

它不替代代码实现、架构分析或文档写作,也不允许绘制不存在的结构。对于探索性草稿可以保留,但最终 CI 门控制品应尽量由机器可读源反向生成,并在代码变更时同步更新。

使用场景

  • 排查登录故障时,从认证流程和路由反向生成时序图,标注真实服务与状态。
  • 评审架构时,把代码依赖、模块边界和部署视图整理成 Mermaid 架构图,供团队讨论。
  • 发布前,根据已有路线图生成甘特图,标记里程碑、依赖和关键路径。
  • 制作演示材料时,输出可编辑 draw.io 图表,并保留标题、图例和替代文本。

适合人员

  • 负责事故复盘的 SRE,需要把认证、Bug 和数据流流程整理成可讨论的时序图。
  • 维护微服务的后端工程师,需要从路由、依赖和模块代码生成准确的架构或组件图。
  • 准备技术评审的产品或架构负责人,需要用 C4、架构图或差异视图说明方案变化。
  • 写开发者文档的工程师,需要在文档中嵌入可编辑图表和真实系统结构说明。