用途
no-comments 是一个用于清理代码注释的技能,属于 saltbo/bstack 技能集。它通过生成名为 Comment Sicko 的子代理来审查代码,识别并处理可接受的注释问题,目标是移除无意义、过时或误导性的注释,同时保留真正必要的约束说明。
主要能力
- 生成 Comment Sicko 子代理,对调用者指定的文件或当前 diff(默认与 main 分支对比,包含工作区)进行审查。
- 检查子代理的报告和 diff,拒绝应用代码编辑、范围逃逸、异常保护的删除、错误陈述的 MUST KILL 理由,以及将有意保留的代码视为有罪的标记。
- 审计被遗漏的范围化 lint 和 TypeScript 抑制注释;正确性或安全性抑制保持为可操作的 MUST KILL。
- 对单薄的 IMPORTANT 或 do not remove 类删除或保留,运行 /how 或 /why 查询其符号;若删除含义模糊则不恢复,若保留被反驳或仍模糊则删除。
- 直接修复简单的可接受标记,如删除死路径、去掉参数或使用真实 API;若修复需要结构设计,运行 /architect 一次。
- 实现范围内最小的根因修复,移除所有指定的变通方法;若根因超出范围,则落地最小范围内修复并报告其余未完成。
- 对约束注释(如 do not remove、do not change wording、talk to X before changing)提供最廉价的范围内类型、运行时、测试或 CI lint 编码方案,等待交互批准;无人值守和评估场景需要调用者预先批准。
- 报告删除数量、恢复的注释、重跑情况、架构草图、修复内容、编码提议、已编码内容、未强制约束及其他未完成工作。
使用方式
该技能通过调用者触发,使用调用者的文件或 diff 作为范围。技能会生成 Task 子代理,指定 subagent_type 为 "comment-sicko",并传递范围。子代理的推理级别和速度根据 saltmode 技能的 Subagents 部分选择。技能会检查子代理的报告和 diff,执行上述审查和修复流程。对于约束注释,技能会提供编码方案并等待交互批准;在无人值守或评估场景中,需要调用者预先批准。
适用场景
- 代码审查后清理无意义注释。
- 移除死代码路径、多余参数或过时 API 使用。
- 审计 lint 和 TypeScript 抑制注释。
- 处理约束注释,将其编码为类型、运行时、测试或 CI lint 检查。
- 在需要根因修复而非症状性防护的场景中。
限制
- 技能会拒绝应用代码编辑、范围逃逸、异常保护的删除等。
- 不授权扩大范围或修复范围外的实例。
- 不添加症状性防护。
- 约束注释的编码需要交互批准;无人值守和评估场景需要预先批准。
- 若第二次报告被拒绝,则报告为未解决并使 /no-comments 失败。
- 技能的具体实现细节、依赖项、安装方式、平台支持、收费情况等暂未提供。