SuperAPI AI 工具集

ascii-art-diagrams

办公与效率

查看项目

更新于 10-15 21:09

技能介绍

用途:在 Markdown 文件中创建 ASCII 图形或文本示意图前,必须加载此技能。它提供一套强制工作流,用于产出对齐正确、结构规范的图表,保证列位置、连接点和边框一致。\n\n主要能力:工作流分为 PLAN、DRAW、VERIFY 三阶段,必须按顺序执行,不得跳过。PLAN 阶段要求确定最大宽度(默认 80 字符,最大 100 字符)、元素数量、框标签、嵌套内容总宽度,并计算尺寸;对含分支或多个垂直元素的图,必须建立列标尺并标记各垂直线、分支、容器位置。DRAW 阶段只允许使用 +、-、|、>、<、^、v 及少量斜杠 / \,禁止使用圆角、实线、花式箭头等 Unicode 字符;并遵守 Junction 规则:每个接入或离开水平线的 |,在精确列位置必须有 +。VERIFY 阶段包括 Unicode 扫描、连接点列计数核对、框宽度与内边距一致性检查、箭头连通性检查,以及最终人工通读。\n\n使用方式:技能附带 scripts/grid.py 与 scripts/verify.py。grid.py 以 1-based 列定位构建图形,可 import 后使用 g.put(L, col, text)、g.fill、g.hline、g.ruler、g.build 等方法;verify.py 为强制运行工具,可对管道输出、按标题提取、按第 N 个代码块或指定文件进行验证,支持 --columns 与 --quiet,退出码 0 表示通过,1 表示失败。推荐流程为:完成 PLAN、用 grid.py 写脚本、将输出管道给 verify.py、失败则修改重试、通过后仍须人工执行 Step 5,再写入目标文件。若脚本报告失败,必须在继续前修复。\n\n适用场景:适合需要在 Markdown 中绘制含多个方框、分支、嵌套容器的流程图、状态机图等文本示意图的场合。\n\n限制:不得跳过任何阶段或步骤,除非用户明确允许;不得仅做表面验证或缩写验证步骤;未完成 VERIFY 不得展示图表,未经确认不得进入下一张图。简单单列图(如线性流程图)可手绘,但复杂图强烈建议使用 grid.py。若有步骤可跳过,必须先确认允许跳过哪些步骤,不确定时应询问澄清。REFERENCE.md 仅作辅助资源,不能替代工作流。