Feishu PlantUML Generation Skill

PlantUML vs Mermaid Selection

Diagram Type Determination

Safe Subset Rules

Must Follow

• Wrap with

  @startuml

  /

  @enduml

  (use

  @startmindmap

  /

  @endmindmap

  for mind maps)
• Do not use leading indentation — Feishu Board treats indented lines as independent lines, causing parsing failure. All code must be written flush left (except content inside package/class)
• Avoid

  skinparam

  style directives
• Avoid

  !define

  preprocessing/macro directives
• Avoid color, font, alignment controls
• Avoid direction control directives (e.g.,

  left to right direction

  )

Syntax for Each Diagram Type

Activity Diagram/Flowchart

@startuml
start
:步骤1;
if (条件?) then (是)
:步骤2;
else (否)
:步骤3;
endif
stop
@enduml

Sequence Diagram

@startuml
participant 用户
participant 系统
用户 -> 系统: 请求
系统 --> 用户: 响应
@enduml

Class Diagram

@startuml
class 用户 {
id : int
name : string
login()
}
class 订单 {
id : int
amount : float
}
用户 --> 订单
@enduml

+

-

#

~

Use Case Diagram

@startuml
actor 用户
(登录)
(注册)
用户 --> (登录)
用户 --> (注册)
@enduml

Component Diagram

@startuml
package "前端" {
[Web App]
[Mobile App]
}
package "后端" {
[API Server]
[Database]
}
[Web App] --> [API Server]
[Mobile App] --> [API Server]
[API Server] --> [Database]
@enduml

ER Diagram

@startuml
entity 用户 {
*id : int
name : varchar
email : varchar
}
entity 订单 {
*id : int
user_id : int
amount : decimal
}
用户 ||--o{ 订单
@enduml

Mind Map

@startmindmap
* 主题
** 分支1
*** 子分支1
*** 子分支2
** 分支2
@endmindmap

Usage Process

1. Analyze User Requirements: Determine the diagram type
2. Generate PlantUML: Follow the safe subset
3. Output Code Block: Output only one code block
4. Explain Changes: Briefly explain if there are downgrades or removals

Import to Feishu Document

Method 1: Direct Paste to Feishu Board

1. Insert a board in Feishu Document
2. Click "PlantUML"
3. Paste the generated code

Method 2: Import via Markdown

```plantuml
@startuml
...
@enduml
```

feishu-cli doc import

Output Specifications

• Output only one PlantUML code block
• Briefly explain modifications outside the code block (if any downgrades)
• Do not output redundant pseudo-code
• Do not include leading indentation when outputting

Frequently Asked Questions

Rendering Failure

1. Check for leading indentation
2. Check for unsupported syntax
3. Simplify diagram complexity

ArchiMate Not Supported

Permission Requirements

• board:board

  - Board read/write (PlantUML is imported via Board API)

• docx:document

  - Document read/write (required when importing via Markdown)