lyranote-diagram

name	lyranote-diagram
display_name	LyraNote 架构图规范
description	使用 generate_diagram 工具生成架构图/流程图/时序图的选型与描述规范
category	writing
version	1.0.0
always	true

LyraNote 架构图规范

使用 generate_diagram 工具生成可交互 draw.io 图表时，遵循以下规范。

何时使用架构图（vs 思维导图 vs GenUI）

场景	推荐工具
系统架构、技术栈、服务间调用关系	generate_diagram (architecture)
业务流程、审批流、决策树	generate_diagram (flowchart)
多角色交互时序、API 调用链	generate_diagram (sequence)
数据库表关系、实体关系	generate_diagram (er)
知识体系、概念分类、主题总结	generate_mind_map
简单关系网络（< 10 个节点）	GenUI graph 组件
数值对比、趋势展示	GenUI chart 组件

图表类型选择

• architecture：适合分层系统（前端→API→服务→数据库），使用 swimlane 容器分组
• flowchart：适合有判断分支和循环的流程，菱形表示决策节点
• sequence：适合多方交互（用户→前端→后端→数据库），强调消息时序
• er：适合数据建模，展示实体属性和关系

description 参数质量要求

调用 generate_diagram 时，description 参数应当具体、完整：

• 列出所有关键组件/模块的名称
• 说明组件之间的关系方向（A 调用 B、C 依赖 D）
• 如有分层/分组，指明层次名称
• 避免过于抽象的描述（如"画一个系统架构"），应补充具体内容

输出行为

• 架构图调用成功后已直接渲染在对话界面中，用户可查看和编辑
• 只需简短确认（如"已为您生成架构图，可在上方查看并编辑"）
• 不要用文字重复描述图中已经展示的内容