关于 ascii-diagram-boxflow
ascii-diagram-boxflow 是仅在用户明确提及技能名称时使用的 ASCII 框图生成技能，面向需要纯文本流程图的场景。它接收节点和连接关系，并提供布局规则及复杂图拆分建议。
主要功能
- 01仅输出 ASCII 图
- 02支持上下或左右布局
- 03设置宽度与框宽
- 04复杂图拆分建议
适用场景
- 01绘制简单线性流程图
- 02呈现单一分支的流程
- 03将复杂流程拆分为子图
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/ascii-diagram-boxflow确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
LICENSE.txtagents/openai.yamlexamples/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
质量检查清单
- 箭头方向明确；避免交叉
- 行宽
<= width；行尾不得有空格 - 长节点名称必须保持一致地截断或换行
关键词
英文： ascii-diagram-boxflow, ascii diagram, flowchart, box, arrow, plain text, terminal 中文： ascii-diagram-boxflow, ASCII 框图, 流程图, 纯文本, 盒子, 箭头, 终端
常见陷阱 (Gotchas)
- 版本兼容性：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
- 配置文件格式：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
- 环境变量：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
- 依赖冲突：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
- 性能陷阱：大数据量场景下注意性能优化，避免 N+1 查询等常见问题
使用流程
步骤 1：环境准备
确保开发环境已安装必要的依赖和工具。
步骤 2：配置初始化
根据项目需求进行基础配置。
步骤 3：核心功能使用
按照示例代码实现核心功能。
步骤 4：测试验证
运行测试确保功能正常。
步骤 5：部署上线
完成开发后进行部署和监控。
评论
支持 Markdown