SuperAPI AI 工具集

deslop

写作与研究

查看项目

更新于 10-15 22:37

技能介绍

用途:Deslop 用于清除 AI 生成代码中的冗余内容,让代码本身表达意图,而非依赖注释。

主要能力:删除复述代码行为的“what”注释、与代码不符的过时注释、被注释掉的代码块、无上下文的陈旧 TODO、未使用的导入/变量/函数/类型,以及编译器已能推断的冗余类型断言。同时进行重构:用自解释命名替代注释、提取命名良好的函数、用提前返回扁平化嵌套、让隐式行为显式化。

使用方式:若 $ARGUMENTS 指定文件或目录则处理这些目标;否则处理自上次提交以来变更的文件,命令为 git diff --name-only HEAD;若无未提交变更,则用 git diff --name-only HEAD~1。编辑前需读取所有范围内文件。

保留项:解释非显而易见决策的“why”注释、外部约束与业务规则、监管说明、边界情况警告、公共 API 文档(godoc、JSDoc、docstrings)、许可证头。

语言特定:Go 中清理复述签名的 godoc、// handle error 噪音、无理由的 // nolint;Python 中清理无理由的 # type: ignore、与签名矛盾的过时 docstring;JS/TS 中清理无理由的 // eslint-disable 与 @ts-ignore;Rust 中清理实际被使用项上的 #[allow(dead_code)]。

限制:具备幂等性,对已干净的代码运行不产生任何编辑,不重排或重构无冗余的代码。具体安装方式与平台支持暂未提供。