SuperAPI AI 工具集

graph-easy

写作与研究

查看项目

更新于 10-15 23:57

技能介绍

用途:该技能借助 graph-easy 为任意 GitHub Flavored Markdown(GFM)文件生成 ASCII 架构图,输出为纯文本并自动布局,无需图片渲染。适用于向 README、设计规格文档添加图示,或绘制流程图、流水线、系统架构图;当用户提到 diagram、ASCII diagram、graph-easy、architecture chart 时使用。不适用于 ADR(架构决策记录),此类场景应改用 adr-graph-easy-architect。

主要能力:支持基本边 [A] -> [B]、带标签边 [A] -- label --> [B]、双向边 [A] <-> [B]、容器 ( Group: ... )、自定义标签 [n] { label: "Display Name"; };支持节点与边样式,如圆角、双边框、粗边框、点线边框,以及实线、点线、粗箭头。

使用方式:先做预检,确认 graph-easy 可用,例如 echo "[Test] -> [OK]" | graph-easy &>/dev/null && echo "✓ graph-easy ready"。渲染时,GitHub markdown 推荐使用 graph-easy --as=ascii,终端本地查看可用 --as=boxart。每个图必须包含 graph { label: "标题"; flow: south; } 或 flow: east,即带语义 emoji 的标题与明确流向。嵌入 markdown 时,每个图必须附带 <details> 源码块,保留可复现的 graph-easy DSL 源码。

限制与注意:节点内禁止使用图形 emoji,仅可用 ASCII 标记如 [x] [+] [!] [OK] [>] [*] [~] [?] [=];emoji 只能出现在 graph label 中。GitHub 会把 Unicode 制表符渲染为虚线,因此 GitHub 场景应使用 --as=ascii。单图建议不超过 7-10 个节点,过大应拆分。边标签保持 1-3 个词。嵌入后建议用 Skill(doc-tools:ascii-diagram-validator) 校验对齐。若命令未找到,说明 graph-easy 未安装,需按预检指南安装。该技能为自演进技能,遇到真实可复现的问题应即时修正文件。