首页 > 教程资讯 > 教程详情

docu.md 发布 documd-visuals 技能包:让 AI 编码智能体在 Markdown 里按需求画图

AI 与前沿 编辑部小鹿 2026-11-17
文章分享

markdown-viewer/skills 仓库提供了一个名为 documd-visuals 的技能包。它为 docu.md Markdown 流水线准备,遵循 Agent Skills 格式,用来让 AI 编码智能体在 Markdown 文档中生成图表。据该仓库 README,技能包按「读者想看什么」组织,而不是按绘图引擎划分,包含 242 个经过验证的示例、183 个场景,覆盖 31 个目标领域,背后有 5 种渲染引擎。

按读者意图组织

README 称,图表配色来自 styles/ 下定义的 9 套主题。31 个领域分为四大类:

  • A 数据与指标(9 个):包括服务可靠性、产品指标、成本预算等
  • B 流程与系统(7 个):包括事故管理、软件设计、系统架构等
  • C 基础设施与治理(7 个):包括云架构、网络拓扑、安全合规、组织架构等
  • D 知识与表达(7 个):包括规划路线图、方案对比、对外沟通等

请求如何路由

SKILL.md 充当路由器,一次请求按三步处理:

  1. 匹配领域:SKILL.md 先把读者意图匹配到 31 个目标领域之一。
  2. 查看场景:goals/<domain>.md 列出该领域的场景和对应的示例文件。
  3. 了解引擎限制:engines/<engine>.md 说明所选引擎的限制和反模式。

推荐的 5 种引擎

  • plantuml / puml:draw-uml 1.5.2
  • vega / vega-lite:版本分别为 6.4.0 和 6.4.3
  • echarts:6.1.0
  • infographic:@antv/infographic 0.2.20
  • 内置的裸 HTML

安装方式

README 推荐运行 npx skills add markdown-viewer/skills,称这一方式适用于 Claude Code、Codex、Cursor 等多种 AI 编码智能体。手动安装有以下几种:

  • Claude Code:把 skills/documd-visuals 复制到 ~/.claude/skills/。
  • claude.ai:把技能包加入项目知识,或粘贴 SKILL.md 的内容。
  • GitHub Copilot / VS Code:放在 .github/skills/ 目录下会被自动识别。

质量检查与许可

仓库用 scripts/check-all.mjs 检查主题漂移、对比度、块渲染、块覆盖、主题使用和结构,另用 scripts/verify-examples.mjs 做完整渲染检查。

技能包 documd-visuals/ 采用 CC-BY-4.0 许可。documd CLI 与渲染引擎是另行发布的 GPL-3.0-only 作品,不在该授权范围内。安装技能不会同时安装 CLI,需要导出文件时,可单独运行 npx @markdown-viewer/documd,或用 npm install -g @markdown-viewer/documd 全局安装。

从 14 个技能合并而来

该仓库此前提供 14 个按引擎和领域命名的技能,现已合并为一个包。README 称,内容是重写而非复制。

来源