用途:该技能用于创建科学文档、报告、分析、方法章节,以及 README、操作指南、决策记录、项目文档等各类文档,并生成工作流、数据管道、架构、时间线、关系等图表。核心主张是把关系用 .md 文件内的 Mermaid 图表表达,优于图片:文本可在 git 中清晰 diff、无需构建步骤、可在 GitHub、GitLab、Notion、VS Code 等原生渲染、比同义散文更省 token,且后续仍可转为精美图片,但文本版本始终是事实来源。
主要能力:覆盖 24 种 Mermaid 图表类型,包括流程图、时序图、ER 图、状态图、甘特图、饼图、C4、思维导图、时间线、类图、用户旅程、象限图、需求图、桑基图、XY 图、块图、看板、架构图、雷达图、矩形树图、数据包图、Git 图、ZenUML 及复杂组合示例。提供 Markdown 与 Mermaid 两份风格指南、24 个图表类型指南(含范例、技巧与可复制模板)、9 类文档模板(决策记录、操作指南、issue、看板、演示、项目文档、拉取请求、研究论文、状态报告)及一份完整研究示例。
使用方式:先判断文档类型并优先套用模板;写 .md 前阅读 references/markdown_style_guide.md;创建图表前阅读 references/mermaid_style_guide.md,再打开对应类型文件。规则包括:每篇仅一个 H1;emoji 仅用于 H2;外部论断用脚注 [^N] 并附完整 URL;比较与结构化数据用表格;描述流程、结构或关系时加 Mermaid;每个图表加 accTitle 与 accDescr;禁用 %%{init} 与内联样式,只用 classDef;节点 ID 用 snake_case。
适用场景:任何进入版本控制的科学或技术文档、需要图表的工作流与架构说明,以及作为其他技能输出文档的文档层。
限制:雷达图须用 radar-beta 关键字、axis 与 curve 语法,且不支持 accTitle/accDescr,需在代码块上方加斜体说明段;XY 图与雷达图语法不同,勿混淆。结构性或关系性图表不应先用 Python matplotlib、seaborn 或 AI 图像生成,那些属于后续可选阶段。该技能未提供收费、价格或平台支持等具体信息。