Skip to content
cccskills
FreePublished on GitHub

mermaid

Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图,或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图,并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型,再生成可渲染、结构清晰的 Mermaid 代码,并在必要时附上简短说明或迭代建议。

不适用于追求高保真视觉设计稿的场景。

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md5.3 KB
  • references/diagram-selection.md3.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Mermaid

专门用于把结构、流程、关系和时间顺序整理成 Mermaid 图。

设计模式

本 skill 主要采用:

  • Generator:根据用户需求或现有文本直接生成 Mermaid 图
  • Reviewer:先判断该用哪种图,再决定是否需要补最小必要信息

Gotchas

  • 不要一上来就默认 flowchart,先判断是否更适合时序图、状态图、ER 图或甘特图
  • 不要把段落原文整段塞进节点,节点文字要短、可扫描
  • 不要为了“信息完整”把一张图画得过满;必要时提醒用户拆成两张图
  • 不要输出明显无法渲染的 Mermaid 代码;交付前自查括号、连线、缩进和子图闭合
  • 在 flowchart 中,如果节点文本里包含 /plan-ceo-review 这类带斜杠的字符串,不要写成 E1[/plan-ceo-review<br/>CEO视角审视产品],要写成 E1["/plan-ceo-review"<br/>CEO视角审视产品],否则容易触发语法错误
  • 如果用户只说“画个 Mermaid 图”但材料很少,先基于现有信息做一个合理初稿,不要过度追问
  • 如果需求本质上是“做一张好看的配图”而不是 Mermaid 语法图,明确说明边界

工作流

复制此清单并跟踪进度:

绘图进度:
- [ ] 步骤 1:理解目标
- [ ] 步骤 2:选择图类型
- [ ] 步骤 3:抽取关键节点与关系
- [ ] 步骤 4:生成 Mermaid 代码
- [ ] 步骤 5:自查可读性与语法
- [ ] 步骤 6:交付并说明

Step 1: 理解目标

先判断用户要表达的核心是什么:

  • 流程推进:某件事按步骤如何发生
  • 结构分层:系统、模块、组织或页面如何组成
  • 交互时序:角色或服务之间如何来回通信
  • 状态变化:对象如何在不同状态间切换
  • 数据关系:实体与字段之间如何关联
  • 项目安排:任务、时间、依赖如何分布
  • 用户体验路径:用户在一段旅程中的动作和感受

如果用户给的是文章、方案、PRD、会议纪要或口头描述,先提炼成“节点 + 关系 + 顺序/层级”。

Step 2: 选择图类型

优先根据表达目标选择图类型。需要时读取 references/diagram-selection.md。

快速判断:

  • 讲步骤和分支:flowchart
  • 讲服务/角色之间的调用顺序:sequenceDiagram
  • 讲状态切换:stateDiagram-v2
  • 讲数据库或业务实体关系:erDiagram
  • 讲排期、里程碑、依赖:gantt
  • 讲用户体验过程:journey
  • 讲对象/模块的静态关系:classDiagram
  • 讲 git 分支关系:gitGraph

如果用户指定了图类型,优先尊重;仅在明显不合适时再说明替代建议。

Step 3: 抽取关键节点与关系

生成前先做轻量结构化:

  • 列出 3 到 9 个关键节点
  • 明确节点之间的主关系:顺序、包含、依赖、调用、状态转移、拥有
  • 保留主线,删掉次要修饰语
  • 给节点命名时优先短中文或稳定英文术语

如果一张图超过 12 个核心节点,优先压缩、分组,或建议拆图。

Step 4: 生成 Mermaid 代码

默认直接输出 fenced code block,例如:

flowchart TD
    A[开始] --> B[分析需求]
    B --> C{选择图类型}
    C -->|流程| D[输出 flowchart]
    C -->|时序| E[输出 sequenceDiagram]

生成时遵循这些规则:

  • 节点 ID 保持简短稳定,如 A、svc_api、user
  • 节点文案面向阅读,ID 面向语法,不要混用
  • 一张图只表达一个核心问题
  • 合理使用子图、注释方向和分组,但不要堆技巧
  • 如无特别要求,流程图默认用 TD
  • 需要强调判断分支时,用菱形条件节点
  • 需要强调系统边界时,用 subgraph

Step 5: 自查可读性与语法

交付前至少自查这些点:

  • 图类型声明是否正确
  • 节点 ID 是否重复
  • 连线语法是否闭合
  • 文案是否过长
  • flowchart 节点文本里若包含以 / 开头的路径或命令,是否已经用引号包住显示文本
  • 是否有无意义的交叉线和重复节点
  • 中文内容是否能在 Mermaid 中稳定显示

如果图较复杂,先保证“能渲染 + 看得懂”,再追求细节丰富。

Step 6: 交付并说明

默认交付内容:

  1. Mermaid 代码块
  2. 一句说明图表达了什么
  3. 如图较复杂,再给一句可选迭代方向

如果用户要求“只给 Mermaid 代码”,就不要附加多余解释。

输出要求

  • 优先直接输出可复制的 Mermaid fenced code block
  • 如用户给了现成文本,必要时先给 1 句“我将其整理为某某图”
  • 不要输出大段 Mermaid 教程,除非用户明确要学语法
  • 不确定时,先给一个能工作的简洁版本,再说明可继续细化

参考资料

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

为照片、身份证、护照、学位证、毕业证、资格证、营业执照等证件或证书扫描件及 PDF 添加本地文字水印。用户提出照片加版权水印、身份证或学历证件添加“仅限某用途”水印、资质文件批量加水印、生成水印预览,或需要保持头像、二维码、印章等区域可辨认时使用。支持 JPEG、PNG、WebP 和 PDF,默认先预览、保留原件并清除图片元数据。不用于去除水印、伪造或篡改证件内容,也不用于仅设计 Logo 水印素材。

The English summary is being prepared. Showing the original description.

chujianyun/skills749Updated Oct 16, 2026

AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践;也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作,除非目标是给 AI coding agent 提供项目上下文。

The English summary is being prepared. Showing the original description.

chujianyun/skills749Updated Oct 16, 2026

Agent 设计顾问与审查工具。基于 12-Factor AgentOps 最佳实践,用于:(1) 探讨 Agent 架构设计方案;(2) 审查现有 Agent/Skill/工作流的设计,发现问题,给出改进建议。触发词:审查我的 agent、帮我分析这个 skill、agent 设计、agent 优化、帮我 review 这个工作流、这个 agent 有什么问题、怎么设计 agent、agent 架构咨询。

The English summary is being prepared. Showing the original description.

chujianyun/skills749Updated Oct 16, 2026

喔图(alltuu.com)云摄影相册批量下载工具。当用户需要从 alltuu.com / m.alltuu.com 相册批量下载原图时使用此技能。支持下载原图(6720x4480 级别),自动处理签名URL,并发下载。适用于 alltuu.com/album/ 相册链接。

The English summary is being prepared. Showing the original description.

chujianyun/skills749Updated Oct 16, 2026

文章解读助手。对用户提供的文章(URL、Markdown、PDF、粘贴文本)进行结构化解读,输出包含总览、关键要点、个人启发、批判性思考和延伸思考的 Markdown 报告。触发词:文章解读、解读文章、帮我解读、读一下这篇、分析这篇文章、article interpretation。

The English summary is being prepared. Showing the original description.

chujianyun/skills749Updated Oct 16, 2026

baize

Free

将公开或用户有权访问的 Wiki 完整转换为面向 Agent 的离线知识 Skill,并按原 Wiki 层级保存 Markdown、生成检索索引和逐文档哈希清单,支持无变化不落盘的手动或自动增量更新。当用户要求把 Wiki、文档站或帮助中心做成 Skill、同步已有 Wiki Skill、保持文档目录树或设置 Wiki Skill 自动更新时使用;不用于只摘要单篇网页或绕过登录、付费墙和访问控制。

The English summary is being prepared. Showing the original description.

chujianyun/skills749Updated Oct 16, 2026

See all skills by chujianyun

Report a problem with this skill