ASCII框图流生成器Skill：在没有渲染器的终端里，用纯文本画出清晰的框流图
- 纯 ASCII 输出：只产出由「盒子 + 箭头」组成的纯文本框图，不依赖任何图形渲染器，粘贴到哪里都能看。
- 三大输出：每次调用都会返回
diagram（ASCII 图）、layoutRules（盒子宽度与箭头/线规则）、splitAdvice（复杂图如何拆分的建议）。 - 参数可控：支持
nodes、edges、direction（TB/LR）、width（默认 80）、boxWidth（默认 16）、numbering（默认 false）。 - 明确的边界：建议节点数不超过 12，超过则拆分为子图；自动布局对线性流和简单分支最擅长，复杂布局需人工排序或拆分。
- 按名称精确触发：只有用户明确提及
ascii-diagram-boxflow时才会启用，不会误触其他绘图技能。
该技能叫什么？如何一键安装 AI 技能提升开发效率？
基本信息
| 项目 | 内容 |
|---|---|
| 技能中文名 | ASCII框图流生成器Skill |
| 技能英文名 | ascii-diagram-boxflow |
| 技能ID | 12783 |
| 运行依赖 | python >= 3.8 |
| 核心脚本 | scripts/boxflow.py |
| 示例文件 | examples/login-flow.md |
| 许可证 | 完整条款见 LICENSE.txt |
它解决什么问题
在真实的一线工作里，很多地方根本渲染不了 Mermaid 或 PlantUML：SSH 登录后的终端、纯文本工单系统、只能贴文本的邮件、代码文件顶部的注释块、不支持图形的聊天窗口、老旧的 Wiki。此时你最需要的不是一张漂亮的图，而是一段能用等宽字体对齐显示、靠字符本身就能表达流程走向的 ASCII 框图。这个技能就是为这类场景准备的：它把「节点 + 连接关系」转换成对齐规范的 ASCII 框流图，并额外给出布局规则和拆分建议，让图在纯文本环境里也能保持可读。
一键安装的思路与步骤
- 确认运行前提：本地 Python 版本不低于 3.8，这是技能详情中唯一声明的依赖项。
- 获取技能包：在支持技能（Skill）机制的客户端或平台中，通过技能市场、技能仓库或工作区的技能管理入口搜索名称
ascii-diagram-boxflow并添加安装。具体入口地址与安装命令因平台而异，以官方说明为准。 - 核对文件是否落位：安装成功后确认技能目录中存在
scripts/boxflow.py（生成脚本）与examples/login-flow.md（示例），这两个文件是否齐全，是判断安装是否完整最直接的依据。 - 验证是否生效：对 AI 说出触发短语，例如「用 ascii-diagram-boxflow 画一个登录流程图」。如果返回结果里同时包含
diagram、layoutRules、splitAdvice三部分，说明技能已正确加载；若只得到一段普通文字描述或 Mermaid 代码，则说明技能未被触发，需要检查名称拼写与安装状态。
「一键安装」的真正价值在于：装好一次之后，后续所有纯文本绘图需求都可以用一句话触发，不必再临时找在线绘图站、手写对齐、反复数空格。
该技能的主要功能和特点
- 只输出 ASCII，绝不跑偏：技能边界明确要求仅输出 ASCII，不输出 Mermaid / PlantUML。这保证了结果在任何纯文本环境中都不会变成一堆无法解析的代码。
- 盒子 + 箭头标准构图：以矩形盒表示节点、以箭头表示流向，输出的是最朴素也最通用的框图形态。
- 两种布局方向：
direction支持TB（自上而下，默认）与LR（从左到右），纵向流程图用 TB，横向流程条用 LR。 - 宽度可约束：
width（默认 80）控制整体行宽，正好贴合经典终端与多数代码规范的行宽限制；boxWidth（默认 16）控制单个盒子的宽度。 - 可选编号：
numbering（默认 false）打开后可为节点编号，便于在文档、工单或会议纪要中逐条引用「第 3 步」。 - 附带布局规则说明：
layoutRules会明确盒子宽度的算法与箭头/线的绘制规则，让你知道图为什么长这样，也方便你手动微调。 - 附带拆分建议：
splitAdvice针对复杂图给出如何切分成多个子图的建议，这是很多简单 ASCII 绘图工具不具备的能力。 - 内置质量检查清单：要求箭头方向明确、避免交叉，线宽不超过
width，无尾随空格，长节点名称必须被截断或一致包裹。 - 精确触发，不打扰：仅当用户明确提及确切的技能名称时才启用，避免在其他对话中被误调用。
和普通工具比强在哪：在线 ASCII 绘图站需要打开浏览器、手动拖拽、逐个字符对齐；通用大模型虽然能画，但常给出 Mermaid 或宽度超出行限的半成品。这个技能把「宽度约束 + 盒子宽度规则 + 拆分策略 + 质量清单」固化进了生成流程，输出更规范、更可复用。
如何使用该技能？
分步使用指南
- 显式点名技能：在提问中带上
ascii-diagram-boxflow，例如「用 ascii-diagram-boxflow 画一个部署流程框图」。只说「画个流程图」通常不会触发它。 - 给出节点列表（
nodes）：节点名称是必需项，逐个列出，建议控制在 12 个以内。 - 给出连接关系（
edges）：以「从 → 到」的形式描述连线，支持线性流和单向/双向分支。 - 指定方向（
direction）：纵向用TB（默认），横向用LR。 - 按需调整宽度（
width/boxWidth）：贴进代码注释或工单时若超宽，可把width调小；节点名较长时把boxWidth调大，避免名称被截断。 - 决定是否编号（
numbering）：需要按步骤引用时设为 true。 - 读取三份输出：
diagram直接使用；layoutRules用于核对对齐是否合理；splitAdvice用于判断是否需要拆图。 - 过一遍质量检查清单：箭头方向是否明确、是否存在交叉线、每行宽度是否不超过
width、有没有尾随空格、长名称是否被截断或一致包裹。 - 复杂图先拆分：节点超过 12 个时，先按
splitAdvice切成「主流程 + 子流程」若干张图，再分别生成。
输入示例（登录流程，对应 examples/login-flow.md 同类场景）
nodes: Login Page, Credentials, Validate, Session, Error
edges: Login Page -> Credentials, Credentials -> Validate, Validate -> Session, Validate -> Error
direction: TB
width: 80
boxWidth: 18
numbering: false
输出示例（diagram 部分示意）
+----------------+
| Login Page |
+----------------+
|
v
+----------------+
| Credentials |
+----------------+
|
v
+----------------+
| Validate |
+----------------+
/ \
/ \
v v
+------------+ +------------+
| Session | | Error |
+------------+ +------------+
同时返回的 layoutRules 会说明本次使用的盒子宽度与箭头/线规则；若校验节点数为 20 个，splitAdvice 则会建议将其拆成「主流程 + 异常分支」两张子图再分别生成。
实用提示：等宽字体下中文通常占两个字符宽度，节点名混用中英文时可能出现细微偏移。此时优先选用短名或英文名，或统一用 boxWidth 包裹成等宽盒子，让每一行的视觉宽度保持一致。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| ascii-diagram-boxflow（本技能） | 无渲染器环境的纯 ASCII 框流图生成 | 盒子+箭头构图、TB/LR 方向、宽度与盒宽控制、编号、布局规则、拆分建议 | 需 python>=3.8，安装技能包后按名称触发；以官方说明为准 | 终端、代码注释、工单、纯文本笔记、邮件 | 优势：输出即纯文本、宽度可控、自带拆分建议与质量清单；不足：自动布局对复杂图仅尽力而为，节点建议不超过 12 个 |
| Mermaid | 文本描述的图形 DSL | 流程图、时序图、甘特图等，需渲染器解析成图 | 需支持 Mermaid 的编辑器、文档平台或网页渲染 | 支持渲染的 Markdown 文档、在线文档平台 | 优势：图形美观、类型丰富；不足：在终端、纯文本工单、无渲染环境下不可读 |
| PlantUML | 基于文本的 UML 绘图语言 | UML 全系列图与部分流程图，需 Java 环境与渲染服务 | 需安装 Java 与 PlantUML，或依赖在线渲染服务 | 架构设计文档、UML 建模 | 优势：建模能力强、生态成熟；不足：依赖重、纯文本环境下源码不适合直接阅读 |
| Graphviz（dot） | 自动布局的图形绘制工具 | 用 dot 语言描述图，由引擎自动计算布局并输出图片 | 需安装 Graphviz 工具链并调用命令行 | 大规模节点关系图、依赖分析 | 优势：自动布局算法强、可处理大量节点；不足：输出的是图片而非纯文本，无法直接贴进终端与注释 |
选型建议：目标环境能渲染图形时，Mermaid 与 PlantUML 的观感更好；节点规模很大且需要自动布局时 Graphviz 更合适；但当你的交付介质是纯文本且必须保持字符级可读时，ASCII 框图方案（本技能）是更契合的选择。
该技能的典型应用场景与实际体验情况
场景一：运维在 SSH 终端里梳理故障链路
运维工程师排查线上问题时只能看到终端，想给同事说明「请求 → 网关 → 服务 A → 数据库」的链路。用本技能直接生成 ASCII 框图，粘贴到终端会话或值班群里即清晰可见。实际体验是几乎零上手成本，一句话即出图；注意把节点名控制在短名称，避免在窄终端里换行。
场景二：开发在代码注释与 README 中写流程图
很多团队禁止在源码注释里放图片链接。开发者可以用 TB 方向生成紧凑框图，把 width 压到 60 左右以贴合代码风格，直接放进文件头注释。实际体验上，layoutRules 能帮助确认对齐规则一致，减少多人协作时的格式走样。
场景三：产品/测试在工单系统里描述流程
工单系统通常不支持图形渲染。产品经理把「用户提交申请 → 审核 → 通过/驳回 → 归档」写成 nodes 与 edges，开启 numbering 后即可按编号在评论中引用具体步骤。实际体验中，编号功能显著降低了来回确认的成本。
场景四：纯文本笔记与不支持图形的对话窗口
在只支持文本的笔记工具或聊天窗口中，ASCII 图是唯一可靠的流程图形式。节点多时按 splitAdvice 拆成主图与子图，逐张贴上。注意自动布局对交叉较多的复杂关系只能尽力而为，复杂结构建议先人工排序再生成。
整体体验小结：上手难度低（会列节点和连线即可）；出图速度快、格式规范；主要注意事项是三件事——节点数控制在 12 以内、中英文混排注意等宽对齐、复杂图先拆分再生成。
该技能能为用户带来的价值
- 提升效率：把「找工具 → 手动拖拽 → 数空格对齐」的多步操作压缩成一次描述，几分钟的排版工作变成一句话触发。
- 降低门槛：不需要掌握 Mermaid、PlantUML 或 dot 语言的语法，只要能用自然语言说清楚「谁连到谁」，就能得到可用的图。
- 提高交付质量：内置的宽度约束与质量检查清单（箭头明确、避免交叉、无尾随空格、长名称截断或包裹）让输出在团队内保持一致的规范度。
- 扩大可用范围：让流程图能出现在终端、代码注释、工单、邮件这些原本「画不了图」的地方，减少信息在传递过程中的损耗。
- 长期可维护：
layoutRules与splitAdvice让图具备可复现、可拆分、可交接的属性，文档沉淀比一次性截图更有长期价值。
常见问题 FAQ
Q1：这个技能怎么安装？安装后怎么确认能用？
先确认本地 Python 版本不低于 3.8，然后在支持技能机制的客户端或平台中搜索 ascii-diagram-boxflow 添加安装，具体入口与命令以官方说明为准。安装后检查 scripts/boxflow.py 与 examples/login-flow.md 是否存在；再对 AI 说「用 ascii-diagram-boxflow 画一个登录流程图」，能返回 diagram、layoutRules、splitAdvice 三部分即为生效。
Q2：我直接说「画个流程图」为什么没有触发？
该技能设有严格的触发规则：仅当用户明确提及确切技能名称 ascii-diagram-boxflow 时才使用。请使用完整名称提问，例如「使用 ascii-diagram-boxflow 生成 box + 箭头连接图」。
Q3：收费吗？
技能详情中未标注任何价格信息，许可证条款需参考随包的 LICENSE.txt 完整说明。是否收费取决于你获取该技能的渠道与平台策略，请以官方说明为准。
Q4：它适合谁用？会不会画不了大图？
适合运维、后端开发、产品经理、测试，以及任何需要在纯文本环境表达流程的人。它的自动布局对线性流和单向/双向分支效果最好，建议节点数不超过 12 个；超过时按 splitAdvice 拆成多张子图，或先人工排序再生成，复杂布局不保证一次到位。
Q5：和 Mermaid、PlantUML 相比怎么选？
如果目标环境能渲染图形、你更看重美观与图种丰富度，选 Mermaid 或 PlantUML；如果交付介质是终端、代码注释、工单、邮件等无法渲染的纯文本场景，且要求宽度可控、字符级可读，选本技能更合适。两者并不冲突，很多团队会同时使用：设计文档用 Mermaid，代码注释与工单用 ASCII 框图。