跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

markdown-mermaid-writing · 用能修改的文本图说明关系和流程

把报告和研究说明组织成 Markdown,并以 Mermaid 表达流程、时序、结构或时间线,保留可修改源文本。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

资料提交后检查字段;缺字段退回补充;完整则进入人工审核,通过后公开,未通过退回。

输出

编辑示例 · 未运行

flowchart TD
  accTitle: 资料审核流程
  accDescr: 字段不全先补充,人工审核通过后才公开
  A[提交资料] --> B{字段完整?}
  B -- 否 --> C[补充材料]
  C --> A
  B -- 是 --> D[人工审核]
  D -- 通过 --> E[公开]
  D -- 未通过 --> C

说明:提交与公开是不同状态;人工审核未结束时不可显示为已公开。

方法说明

把报告和研究说明组织成 Markdown,并以 Mermaid 表达流程、时序、结构或时间线,保留可修改源文本。

具体任务

用流程图说明资料审核:把报告和研究说明组织成 Markdown,并以 Mermaid 表达流程、时序、结构或时间线,保留可修改源文本。

整理带图的技术说明:用标题、文字和关系图逐层解释系统,选择适合的时序图、状态图或流程图。

必需材料

要解释的问题和节点关系

文档读者与目标格式

可选材料

已有 Markdown

图形风格要求

使用门槛

目标阅读器支持所选 Mermaid 类型,能检查实际渲染。

这个 Skill 额外提供的方法

让图和说明保持同一文本来源,修改节点时能追踪关系与文档变化。

编辑示例(未运行)

用流程图说明资料审核

任务:请根据下面的示例材料完成用流程图说明资料审核,把判断依据和待确认事项写清楚。

输入:
资料提交后检查字段;缺字段退回补充;完整则进入人工审核,通过后公开,未通过退回。

结果片段:
```mermaid
flowchart TD
  accTitle: 资料审核流程
  accDescr: 字段不全先补充,人工审核通过后才公开
  A[提交资料] --> B{字段完整?}
  B -- 否 --> C[补充材料]
  C --> A
  B -- 是 --> D[人工审核]
  D -- 通过 --> E[公开]
  D -- 未通过 --> C
```
说明:提交与公开是不同状态;人工审核未结束时不可显示为已公开。

让图和说明保持同一文本来源,修改节点时能追踪关系与文档变化。 该片段是编辑示例,用于说明交付形态,未运行上游技能。

首次任务

请使用「用能修改的文本图说明关系和流程」完成「用流程图说明资料审核」。
任务要求:让图和说明保持同一文本来源,修改节点时能追踪关系与文档变化。

我的必需材料:
- 要解释的问题和节点关系:[请填写或粘贴]
- 文档读者与目标格式:[请填写或粘贴]

请基于上述实际材料输出:带结构化标题、文字说明和 Mermaid 源码的 Markdown;可选使用文档模板。缺少依据的地方单列为待确认,不编造事实;未执行的操作或测试明确标为未执行。

验收要求:
1. 源码可被目标渲染器解析。
2. 节点与箭头关系准确。
3. 图外文字提供必要定义和异常说明。

验收方法

源码可被目标渲染器解析

节点与箭头关系准确

图外文字提供必要定义和异常说明

依赖与准备

需要支持 Mermaid 的 Markdown 阅读器;可选 CLI 导出图片,生成源码本身不需要外部账号。

使用边界

文本图适合表达结构与流程,不能替代需要精确几何的工程图。

某些新图类型受渲染器版本限制,需保留可阅读文字说明。

排错

图过宽手机看不清:改成纵向流或拆分子图,并保留简短文字路径。

某语法在编辑器报错:核对 Mermaid 版本与图类型支持,改用兼容语法。

固定来源

https://github.com/K-Dense-AI/scientific-agent-skills/blob/49c6e97775eaa18ba791bebe23162a70ae601c18/skills/markdown-mermaid-writing/SKILL.md