关于 ascii-diagram-boxflow
ascii-diagram-boxflow 用于生成纯 ASCII 文本的方框与箭头图,仅在明确指定技能名称时使用。其脚本尽力处理简单线性流程和单个双向分支。
主要功能
- 01仅生成 ASCII 方框与箭头图
- 02支持上下或左右布局
- 03可设置宽度和框宽
- 04可选节点编号
- 05提供复杂图拆分建议
适用场景
- 01绘制简单的登录流程
- 02展示带双向分支的流程
- 03拆分超过 12 个节点的图
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ partme-ai/ full-stack-skills --skill ascii-diagram-boxflow安装后在 Claude Code 中输入/ascii-diagram-boxflow确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtexamples/login-flow.mdscripts/boxflow.py详细介绍
使用此技能的时机
关键触发规则
- 仅当用户明确提及确切的技能名称
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
行内示例
输入:nodes=[Login, Validate, Dashboard]、edges=[Login->Validate, Validate->Dashboard]、direction=TB:
+----------------+
| Login |
+----------------+
|
v
+----------------+
| Validate |
+----------------+
|
v
+----------------+
| Dashboard |
+----------------+
长名称截断(boxWidth=16):"Authentication Service" 会变成 "Authenticati..."。
质量检查清单
- 箭头方向明确;避免交叉
- 线条宽度
<= width;末尾不得有空格 - 长节点名称必须以一致的方式截断或换行
关键词
English: ascii-diagram-boxflow, ascii diagram, flowchart, box, arrow, plain text, terminal 中文: ascii-diagram-boxflow, ASCII 框图, 流程图, 纯文本, 盒子, 箭头, 终端
评论
支持 Markdown