名称: ascii-diagram-boxflow 描述: 为无渲染器环境生成纯ASCII框流图(盒子 + 箭头),包含对齐规则和复杂图的分割策略。 许可证: 完整条款见LICENSE.txt 依赖项:
- python>=3.8
何时使用此技能
关键触发规则
- 仅当用户明确提及确切技能名称时使用此技能:
ascii-diagram-boxflow。
触发短语包括:
- “ascii-diagram-boxflow”
- “use ascii-diagram-boxflow”
- “用 ascii-diagram-boxflow 画 ASCII 流程图/框图”
- “使用 ascii-diagram-boxflow 生成 box + 箭头连接图”
边界
- 仅输出ASCII。不要输出Mermaid/PlantUML。
- 建议节点数 <= 12;如果更多,分割为子图。
- 自动布局尽力而为,适用于线性和简单分支。复杂布局需要手动排序或分割。
如何使用此技能
输入
- nodes(节点列表;名称必需)
- edges(连接:从/到)
- direction(TB | LR,默认TB)
- width(默认80)
- boxWidth(默认16)
- numbering(默认false)
输出(必需)
- diagram(仅ASCII)
- layoutRules(盒子宽度 + 箭头/线规则)
- splitAdvice(如何分割复杂图)
脚本
scripts/boxflow.py: 尽力而为处理线性流和单双向分支
示例
examples/login-flow.md
质量检查清单
- 箭头方向明确;避免交叉
- 线宽
<= width;无尾随空格 - 长节点名称必须被截断或一致包裹
关键词
英文: ascii-diagram-boxflow, ascii diagram, flowchart, box, arrow, plain text, terminal 中文: ascii-diagram-boxflow, ASCII 框图, 流程图, 纯文本, 盒子, 箭头, 终端