AgentSkillsCN

visual-communicator

强制执行视觉沟通标准。当您需要解释复杂逻辑、架构、工作流程,或当用户要求绘制示意图时,可启用此技能。

SKILL.md
--- frontmatter
name: visual-communicator
description: Enforces Visual Communication Standards. Use this skill when explaining complex logic, architectures, workflows, or when the user asks for diagrams.

Visual Communicator Skill

Purpose

To ensure that complex ideas are always accompanied by visual representations using Mermaid diagrams, adhering to the standard defined in GEMINI.md.

Trigger Conditions

  • User asks for an explanation of code, architecture, or flow.
  • You are writing a spec or implementation_plan.
  • User explicitly asks for a diagram.

Decision Logic: Which Diagram?

ScenarioDiagram TypeSyntax
Logic/Process/Decision TreeFlowchartgraph TD
API Calls/Protocol/InteractionsSequencesequenceDiagram
Data Models/Classes/DB SchemaClassclassDiagram
State Changes/LifecycleStatestateDiagram-v2
Timeline/RoadmapGanttgantt

Execution Rules

  1. Always Visualize: Do not just explain with text; show it with a diagram first.
  2. Syntax Safety:
    • Quote labels with special chars: id["Label (Info)"].
    • Avoid HTML in labels if possible.
  3. Context Placement:
    • If writing an Artifact (markdown), embed the diagram directly.
    • If chatting, provide the diagram in the chat response.

Example Templates

Flowchart

mermaid
graph TD
    A[Start] --> B{Condition?}
    B -- Yes --> C[Process]
    B -- No --> D[End]

Sequence

mermaid
sequenceDiagram
    participant U as User
    participant S as Server
    U->>S: Request
    S-->>U: Response