SuperAPI AI 工具集

explaining-with-ascii

办公与效率

查看项目

更新于 10-16 06:22

技能介绍

用途:把难懂的技术概念转成简单可视化的心智模型。核心不是用 ASCII 装饰解释,而是先用图让概念可理解,再讲技术细节。教学顺序为:难懂概念→熟悉的类比(抽象时)→ASCII 心智模型→简短说明→技术词汇→具体锚点(示例、代码、文件或命令)。

适用场景:系统架构、数据流、请求生命周期、智能体与工具循环、状态机、检索与搜索、数据库与记忆、队列与异步、并发、网络、认证、部署流水线、归属边界、前后变化、方案与权衡、算法、陌生代码路径,以及用户表示困惑或要求 ASCII/可视化/简单心智模型/CEO 级/新手向/分步流程/两种方案对比/指定语言解释时。若一句话更清楚,不要强行画图。

工作流程:先确定教学目标和最小有用模型,判断重点是移动、结构、归属、顺序、重复、状态还是对比;抽象概念先用一个熟悉类比,映射不清时停止;按概念选择图形:线性流、分支决策、循环、分层、归属边界、前后对比、并排比较、状态转换、树形层级;画最小完整图,框内用清晰名词,箭头上用动词或条件,方向一致,标签简短;图后加一到三句说明中心含义,不逐箭头复述;再引入技术术语;最后落到真实文件、函数、类、配置或命令,未经验证的锚点不要编造。

响应结构按需取最小子集:简单概念用图加简短说明和例子;抽象概念加类比与术语;架构用高层图、职责摘要、必要时归属表和具体文件;对比用并排图、小表和结合用户情况的建议;调试用预期流程与实际流程对比并指出分歧点。从最高有用层级开始,不主动跳到实现细节。

限制:不要用表格重复图中已清楚表达的流程;图要单目的、方向明显、无颜色也可读、适配终端宽度;避免图放在大段文字之后、细节过多、图与文字重复、未定义术语、误导类比、未验证代码引用和装饰性 ASCII。最终自检:能否仅凭图理解主旨、是否先图后术语、说明是否比图更短、图形选择是否正确、是否删去暂不需要的细节、代码锚点是否真实、是否适应用户语言与深度。指导原则:看见→理解→命名→应用。