用途:no-comments 是一个代码审查类技能,用于清理代码中不应保留的注释。它通过启动 Comment Sicko 审查者角色,对已接受的审查发现采取行动,并针对被声明的约束提供编码方案。
主要能力:遵循可移植的运行时契约进行审查者角色选择与子任务简报;使用调用者的文件或 diff,否则使用当前工作树相对基线分支(默认 main)的 diff;优先使用宿主提供的专用 Comment Sicko 审查者,否则启动全新的规范审查者子进程;检查报告与 diff,拒绝应用代码编辑、范围逃逸、异常保护的删除、错误陈述的 MUST KILL 理由,以及将有意保留的代码视为有罪的标记;审计遗漏的范围化 lint 与 TypeScript 抑制;对薄弱的 IMPORTANT 或 do not remove 判定调用同级 how 或 why 技能;直接修复琐碎的已接受标记;必要时调用同级 architect 技能一次;实施范围内最小的根因修复;针对约束注释提供最便宜的范围内类型、运行时、测试或 CI lint 编码方案。
使用方式:按步骤执行——先确定范围,再启动审查者,检查报告,拒绝不合规项,修复已接受项,处理约束注释,最后报告删除数量、恢复的注释、重跑、架构草图、修复、编码提议、编码、未强制约束及其他未完成工作。交互式需等待批准;无人值守与评估需调用者预先批准。
适用场景:代码审查与清理流程,尤其是需要移除死代码路径、冗余参数、过时注释或处理约束性注释的场景。
限制:不授权扩大范围或修复范围外的实例;若根因超出范围,仅落地范围内最小修复并报告其余为未完成;第二次拒绝报告需报告为未解决并使技能失败;若删除有歧义则不恢复,若保留被反驳或仍有歧义则删除。官方文本暂未提供。