SuperAPI AI 工具集

banish

通用与其它

查看项目

更新于 10-15 21:46

技能介绍

用途:banish 用于处理代码中的注释。它把指定文件或当前 diff 交给一个不带代码情感偏向的审阅者 Comment Reaper,再根据其返回结果执行删除,并修复部分问题。

主要能力: 一是删除不值得保留的注释,仅删除注释,不改动应用代码; 二是保留许可证头、公共 API 契约、外部怪癖说明、格式化指令、纯风格抑制和约束链接等应保留内容; 三是处理 RESHAPE 标记,即用重命名、提取、收窄类型、加守卫或删除死路径等最小改动,让行为本身变得明显; 四是把“不要移除”“保持顺序”等约束尽量转成代码层面的强制手段,如类型、测试、运行时断言或 lint 规则; 五是输出报告,列出删除数、恢复数、重跑次数及未决项。

使用方式:默认作用于调用者指定的文件或 diff,否则使用当前分支与基准分支(默认 main)之间的 diff,包含工作区。流程为:读取本技能目录下的 references/comment-reaper.md,按该内容启动一个子代理并附上范围;在 Claude Code 中若存在名为 comment-reaper(或插件形式 fr:comment-reaper)的已安装代理则优先使用,否则在其他平台以该参考文件启动通用子代理。随后审计报告、处理 RESHAPE、编码约束并报告。

限制:只删除注释,不应改动应用代码;超出范围的修复需留作未决项并报告;需要外部写入时须获得相应授权;无法完成已授权动作时应完成独立部分并说明能力边界;最多重跑一次,第二次失败即结束并报告。