技能档案

Diagramming: Mermaid, PlantUML, D2

Diagrams as code: Mermaid, PlantUML, D2, diagram versioning, auto-generation

Documentation Docs-as-Code

角色数

8

包含此技能的角色

级别数

5

结构化成长路径

必要要求

27

其余 9 个可选

领域

Documentation

skills.group

Docs-as-Code

最后更新

2026/3/17

如何使用

选择当前级别并对比期望。下方卡片显示晋升所需掌握的内容。

各级别期望

表格展示从初级到首席的技能深度变化。点击行查看详情。

角色 必要性 描述
Game Designer Creates simple game system diagrams: core loop flowcharts, mechanic interaction schemas, game content mind maps. Uses Miro, draw.io, or Figma to visualize game design ideas. Understands basic notations for describing game flows.
Product Manager 必要 Creates diagrams to visualize product concepts: user flows, wireframes, process maps. Uses Miro, Figma, draw.io.
Security Analyst Understands the fundamentals of Diagramming: Mermaid, PlantUML, D2. Applies basic practices in daily work. Follows recommendations from the team and documentation.
Technical Product Manager 必要 Can read and create basic diagrams: flowcharts, sequence diagrams, user flows. Uses Miro, Lucidchart or draw.io for visualizing product processes. Understands UML notation at a basic level.
Technical Writer 必要 Proficient with basic diagramming tools: draw.io, Lucidchart, Miro. Can create simple diagrams: flowcharts, sequence diagrams, mind maps. Knows basic notations: UML basics, flowcharts, network diagrams.
角色 必要性 描述
Engineering Manager Uses Mermaid, PlantUML, or D2 to create process flows, org charts, and roadmap visuals. Understands when to use sequence vs. flowchart diagrams. Documents team workflows and communication paths independently.
Game Designer Creates detailed game system diagrams: state machines for AI behavior, progression flow diagrams, economic cycle schemas (sink/source). Visualizes dependencies between game systems. Uses UML to describe complex interactions.
Product Manager 必要 Creates comprehensive visualizations: service blueprints, system maps, impact maps. Uses diagrams for stakeholder communication.
Security Analyst Applies Mermaid, PlantUML, or D2 to build threat model diagrams, basic attack trees, and network topology maps. Understands trade-offs between diagram formats for security documentation. Creates incident flow visuals independently.
Technical Lead Uses Mermaid, PlantUML, or D2 for technical design documents, component diagrams, and data flow visuals. Chooses appropriate diagram types for sequence and interaction modeling. Creates clear architecture sketches for the team independently.
Technical Product Manager 必要 Creates technical diagrams for product specifications: sequence diagrams for API interactions, data flow diagrams, state machines. Uses C4 model for documenting architecture at different levels.
Technical Writer 必要 Creates complex technical diagrams: C4 model (all 4 levels), data flow diagrams, state machines, ER diagrams. Uses diagrams-as-code tools (Mermaid, PlantUML). Maintains visual consistency and diagram readability.
角色 必要性 描述
Engineering Manager 必要 Designs comprehensive process flow systems and roadmap visualizations using Mermaid, PlantUML, or D2. Creates standardized org chart and communication templates. Mentors the team on effective diagramming for stakeholder presentations and cross-team alignment.
Game Designer Designs comprehensive game system visualizations: full-game system diagrams, mechanic dependency graphs, data flow for live-ops pipeline. Creates interactive diagrams for presenting game design decisions to stakeholders. Documents architecture systematically.
Product Manager 必要 Masterfully visualizes complex concepts. Creates strategic visualizations: Wardley maps, ecosystem maps, opportunity landscapes.
Security Analyst 必要 Designs production-grade threat modeling diagrams, multi-layer attack trees, and detailed network topology maps using Mermaid, PlantUML, or D2. Optimizes diagram complexity for incident response playbooks. Mentors analysts on security diagramming practices.
Solutions Architect 必要 Designs production-grade C4 model diagrams, integration pattern visuals, and deployment architecture maps using Mermaid, PlantUML, or D2. Optimizes diagram layering for different stakeholder audiences. Mentors teams on architectural diagramming standards.
Technical Lead 必要 Designs production-grade component diagrams, detailed data flow visuals, and sequence diagrams for complex systems using Mermaid, PlantUML, or D2. Optimizes technical documentation with layered diagram views. Mentors engineers on design documentation best practices.
Technical Product Manager 必要 Designs comprehensive architectural diagrams for cross-team alignment: system context, container, and component levels. Creates dynamic diagrams for complex workflows. Defines visualization standards for teams.
Technical Writer 必要 Designs visual language and diagramming standards for the project. Implements diagrams-as-code approach: Mermaid/PlantUML in Git, auto-generation from code, CI validation. Creates interactive diagrams for the developer portal (clickable architecture maps).
角色 必要性 描述
Engineering Manager 必要 Defines diagramming strategy for team communication, process documentation, and roadmap visualization. Establishes standards for org chart maintenance, workflow diagrams, and stakeholder reporting visuals. Conducts reviews of diagram quality across the product area.
Game Designer Defines visual documentation standards for the game design team. Builds a diagram template library: economy flows, system architectures, player journey maps. Trains the team on effective visual communication of game design decisions.
Product Manager 必要 Standardizes visual standards for the division. Defines diagramming guidelines and templates.
Security Analyst 必要 Defines diagramming strategy for threat modeling, attack surface visualization, and incident response documentation. Establishes standards for security architecture diagrams, network topology maps, and compliance visuals. Conducts reviews of security diagram accuracy and completeness.
Solutions Architect 必要 Defines diagramming strategy for system architecture, C4 model adoption, and integration pattern documentation at the product level. Establishes standards for deployment diagrams, infrastructure visuals, and architecture decision records. Conducts reviews of architectural diagram consistency.
Technical Lead 必要 Defines diagramming strategy for technical design documentation, component modeling, and data flow visualization at the team level. Establishes standards for sequence diagrams, API interaction visuals, and system boundary maps. Conducts reviews of technical diagram clarity and accuracy.
Technical Product Manager 必要 Defines diagram standards and templates for the product division. Introduces diagrams-as-code approach (Mermaid, PlantUML) with versioning. Trains teams on effective visual communication of architectural decisions.
Technical Writer 必要 Defines organizational standards for technical information visualization: notations, tools, color schemes, templates. Coordinates creation of unified system landscape diagrams combining knowledge from different teams. Trains on visualization techniques.
角色 必要性 描述
Engineering Manager 必要 Defines organization-wide diagramming strategy for process documentation, cross-team communication visuals, and strategic roadmap presentation. Establishes enterprise standards for workflow and org structure diagrams. Mentors leads on effective visual communication for executive reporting.
Game Designer Shapes visual communication culture at the studio level. Creates methodology for documenting complex game systems through diagrams. Defines enterprise tools and standards for game design visualization across multiple projects.
Product Manager 必要 Uses strategic visual tools for corporate-level communication. Visualizes portfolio strategy.
Security Analyst 必要 Defines organization-wide diagramming strategy for enterprise threat modeling, security architecture documentation, and compliance reporting visuals. Establishes enterprise approaches to attack surface mapping and incident response diagramming. Mentors leads and architects on security visualization standards.
Solutions Architect 必要 Defines organization-wide diagramming strategy for enterprise architecture, C4 model governance, and integration pattern standardization. Establishes enterprise approaches to deployment and infrastructure diagramming across all product lines. Mentors leads and architects on architectural visualization maturity.
Technical Lead 必要 Defines organization-wide diagramming strategy for technical design documentation, component modeling standards, and data flow visualization patterns. Establishes enterprise approaches to sequence diagrams and system boundary mapping. Mentors leads and architects on technical diagramming excellence.
Technical Product Manager 必要 Shapes enterprise approach to visual architecture documentation. Defines catalog of diagram types for different stakeholders. Integrates diagrams into developer portal and organization's architecture repository.
Technical Writer 必要 Shapes technical knowledge visualization strategy at the company level. Defines tools and approaches for diagramming automation. Ensures visual documentation serves as living documentation reflecting the actual state of systems.

社区

👁 关注 ✏️ 建议修改 登录以建议修改
📋 提案
暂无提案 Diagramming: Mermaid, PlantUML, D2
正在加载评论...