组织结构/树状图
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-diagram-orgtree。
技能介绍
层级关系,用代码画清楚
日常工作里,把组织架构、家谱、分类树画成图,要么打开 Visio / draw.io 手动拖拽,要么在 PPT 里一层层对齐文本框。改一次汇报线就要重新连线,版本散乱,团队成员也很难复用。
这个技能的思路是反过来:先把层级关系想清楚,再用 Mermaid 的 graph TD 语法写出来。图只是文本的渲染结果,修改等于改几行代码,可读、可版本管理、可评审。
它解决什么问题,怎么工作
核心能力围绕四个动作展开:
- 确定根节点与层级:先找到最顶层的节点(公司创始人、家族始祖、分类总类),再逐层向下展开,避免上来就画细节导致结构返工。
- 用
graph TD自上而下表达:声明graph TD(top-down)方向,父子节点用缩进或连接符表达,渲染后自上而下排布。 - 标注角色/职责而非仅人名:节点上写“技术总监”而不是只写“张三”,汇报线变化时节点文字不用动,图更稳定。
- 对虚线汇报用样式区分:正式汇报用实线,虚线、跨部门支援等弱关系用虚线样式,读者一眼能分辨强汇报与弱关联。
工作流程与能力一一对应,分四步:列出层级与节点 → 确定关系 → 套用 graph 语法 → 渲染校验可读性。生成后在支持 Mermaid 的编辑器里预览,检查是否有环、连线交叉、层级过深,再微调节点文本。
适用边界与注意点
这个技能面向的是层级示意图,不是精细图表工具:
- 适合组织架构、家谱、分类树、决策树这类父向子逐层展开的结构。
- 不适合矩阵式组织、虚拟团队、多人共管的复杂关系——这类图建议拆成多张分图表达。
- 不适合带照片、头像、职位卡的精修图,那属于图表美化工具的范畴。
- 涉密架构必须脱敏:输出的只是示意图,不要直接把真实姓名、内部代号写进去。
语法速查卡放在 references/速查卡.md,写图时需要确认语法就翻它。
使用场景
- 撰写公司手册时,把部门上下级汇报线画成组织架构图
- 整理家谱资料时,将祖先到后代的世系关系画成树状图
- 梳理产品分类体系时,把父子类目的层级画成分类树
- 设计审批流程时,把判断逻辑和分支画成决策树
适合人员
- 公司行政或组织发展人员,需要快速画出部门汇报结构
- 技术文档工程师,需要在文档中用 Mermaid 表达系统模块层级
- 家谱研究者,需要把世系关系整理成可读的树状图
- 产品经理,需要梳理产品分类或审批判断逻辑