SuperAPI AI 工具集

cursor-no-comments

编程与开发

查看项目

更新于 10-16 06:07

技能介绍

cursor-no-comments 是一个面向代码审查与注释清理的智能体技能,来源于 theangrypit/theangryskills。其核心用途是移除代码中无意义的注释,并通过专用审查代理 Comment Sicko 提供的新视角来审查代码变更。

主要能力与工作流程:

  1. 调用专用审查代理:在 Step 1 中,当环境暴露了精确的 agent_type 时,调用原生 collaboration.spawn_agent,并指定 agent_type 为 "comment-sicko"。该命名配置由 model-capability-router 分发,不得用通用审查者或仅提示扮演 Comment Sicko 的提示词替代。如果该类型不可用,需报告缺口并保持本次运行未完成。

  2. 范围确定:使用调用者的文件或 diff;否则使用当前相对于基础分支(默认 main)的 diff,包括工作树。

  3. 审查与处理:协调者检查审查者的报告和 diff,并在调用者授权下执行可接受范围内的实现修复,然后运行验证。需要拒绝应用代码编辑、范围逃逸、异常保护的删除、错误陈述的 MUST KILL 理由,以及将保留的有意代码视为有罪的标记。对于薄弱的 IMPORTANT 或 do not remove 的 kill/keep,需先对其符号运行 cursor-how 或 cursor-why。如果 kill 模糊,不恢复;如果 keep 被反驳或仍模糊,则删除。

  4. 修复:直接修复可接受的琐碎标记,例如删除死路径、丢弃参数或使用真实 API。如果任何修复需要形态调整,运行一次 cursor-architect 获取可接受集合及周围代码的草图,停在草图阶段。

  5. 实现最小根因修复:在范围内实现最小的根因修复,移除所有指定的变通方法。如果根因超出范围,落地最小的范围内修复并报告其余为开放状态。

  6. 约束注释处理:对于表示 do not remove、do not change wording 或 talk to X before changing 的约束注释,保留关于我们无法改变的事物的 keep。提供最便宜的范围内类型、运行时、测试或 CI lint 编码方案,等待交互式批准。无人值守和评估需要调用者预先批准。如果批准,则编码后删除;否则删除,报告约束为开放,并草拟超出范围的工作。

  7. 报告:报告删除计数、恢复的注释、重跑、架构草图、修复、编码提议、编码、未强制约束和其他开放工作。

适用场景:适用于需要清理代码注释、移除无意义注释、处理约束性注释的代码审查流程。

限制:自动选择和复杂的拒绝/重跑分支仍未经验证。不得安装 Cursor 钩子。配置文件资产必须在新 Codex 会话能够选择它之前显式安装。审查者不是权威,需遵循 model-capability-router。