SuperAPI AI 工具集

deslop

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:在不改变运行时行为的前提下,缩小代码接口、删除冗余代码并澄清注释。

主要能力:按三类处理冗余——接口膨胀(导出过多、参数对象过宽、契约薄弱)、结构性冗余(死代码、过期开关、多余适配器/辅助函数)、注释冗余(复述代码、过期注释、术语不一致)。

使用方式:先分类要清理的冗余并只读取对应参考文档(interface-simplicity.md、cruft-removal.md、comment-clarity.md,路径基于 ${CLAUDE_SKILL_ROOT}/references/)。随后锁定不变量:除非用户明确要求,运行时行为与外部可见输出保持等价;公共接口只缩小或更清晰,不无依据扩大;新抽象须证明复用价值,否则优先直接组合。接着执行硬性护栏:删除无使用或按契约已过时的死代码;合并无价值的包装器/适配器;缩小导出面并收紧消费端类型/契约;用显式控制流替代过度技巧;删除或重写复述明显代码的注释,保留解释意图、约束和非显然权衡的注释;保持 API、类型与注释术语一致。最后验证行为安全:运行受影响区域的针对性测试与类型检查/静态检查;若行为可能变化,明确说明并在扩大范围前停下等待用户确认。

报告:输出接口缩减、冗余删除、注释清理、行为安全检查、残余风险五部分摘要。

退出标准:触及范围的公共表面积更小或更清晰;范围内确认的死代码被删除;剩余注释提供非显然价值;提供验证证据。

限制:资料未提供具体安装命令、平台支持、收费方式或性能数据;行为等价性依赖测试与静态检查覆盖,未覆盖处存在残余风险。