SuperAPI AI 工具集

explaining-code

通用与其它

查看项目

更新于 10-16 06:22

技能介绍

用途:帮助用户理解代码或系统如何运作,以及某项改动做了什么。先以简洁的技术散文说明行为,点名关键函数、组件、数据、API 与归属边界;对可能不熟悉的术语给出定义,保留必要细节,去掉铺垫与废话。

主要能力:按需选择最小视图。逻辑或算法用伪代码;运行时顺序用调用树;UI 归属用带状态与模块边界的组件树;文件归属用浅层文件树;交互、数据流、状态或架构用围栏图示块。图示块使用可移植的 Unicode 线绘,浅色连接线表示结构,强调字形仅用于决定性路径、状态或转换。

解释变更:变更指任何使代码行为不同的东西,如 diff、提交、PR、修复、提案或本线程刚做的工作。默认用图示块展示变更,画系统做什么而非改了哪些行。行为被替换、改道或移除时,在同一块中画 Before 与 After,保持相同视图、布局与标签,宽度约 70 列内并排,否则上下排列;小改动可用两行对齐的 Before/After。行为新增且旧状态只是缺失时只画结果。精确文本(签名、配置值、schema 字段)用聚焦 diff 块。未变部分用浅线,变更部分用强调字形,并在成因旁写出有意义的后果(延迟、计数、错误)。先用一句话陈述变更,紧接图示,随后只补充图示无法展示的原因、边界情况与风险;无可画内容(重命名、拼写修复、新常量)只写一句。

其他视图:调用树展示运行时顺序与嵌套;组件树展示 UI 归属并附必要状态、hooks、文件与包边界;浅层文件树展示职责或大范围重构形态;diff 块不必是字面源码 diff,可按调用树、组件、文件布局或状态控制流调整形状。

限制:资料未提供安装命令、平台、收费或价格信息;具体使用方式与集成细节暂未提供。