SuperAPI AI 工具集

deslop

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:对刚刚写好的代码做一次二次清理,让代码更紧凑、更简单、更有意图,属于风格整理而非重构。

主要能力:先读取 style.md,该文件是风格规则的事实来源;找出本次会话中被修改的文件,可用时借助 git diff,否则依据近期编辑或用户明确给出的文件列表,不碰无关文件;编辑前先读取目标文件;对多个文件使用并行子代理拆分处理,单个大文件也可用一个子代理做独立的二次处理,并给每个子代理明确的文件清单;一至三个小文件可直接单次处理,不为机械满足规则而增加子代理开销。

使用方式:让子代理读取 skills/deslop/style.md,只简化其被分配的文件,严格保持行为,跳过只会增加改动量而无助于清晰度的修改,并汇报改了什么、有意跳过了什么;随后审阅子代理输出、应用改动,并自己做最终检查;最后用具体方式总结清理结果,例如“将 3 处嵌套条件拍平、重命名 2 个布尔值、替换 1 处非空断言”。

优先关注点:用守卫子句替代嵌套条件、用 if 加提前返回替代 else、无重新赋值时用 const 替代 let、用收窄或直接移除替代 ! 非空断言、用 Boolean(value) 或显式比较替代 !!value、更清晰的布尔命名如 isOpen、hasItems、canRetry、职责单一且更短小的函数、将编排函数拆分出辅助函数、把查询/数据收集与动作/副作用分离、让函数名如实描述副作用、拆分过载的 hook 或组件、用对象参数替代长位置参数、对可判别联合做穷尽处理、用提前返回拍平 React 渲染分支、逻辑只用一次时内联 JSX 处理器、多处复用时保持处理器提升。

限制:绝不改变行为,这是风格处理而非重构;风格规则与保持行为冲突时,以保持行为优先;优先小而局部的编辑,而非大范围重写;若代码只有经过更深的架构重构才能明显变干净,应停下来说明,而不是强行超出 deslop 的适用范围;跳过生成文件、第三方代码、构建产物和锁文件;除非用户要求,跳过测试;若应用某条规则会让代码更难读则跳过该规则;除非用户明确要求,保持导出与公共 API 不变;除非用户明确要求修改类型或 API,保持导出的 TypeScript 签名不变;如果代码已经足够干净,直接说明,而不是强行改动。使用前需要存在 style.md 作为风格依据,否则规则来源不明确;其具体价格、许可与平台信息暂未提供。