用途:no-comments 用于清理代码中的注释。它调用 comment-sicko 子代理,依据其报告和 diff 处理被接受的发现,并针对声称的约束提供编码方案。在 Codex 和 GitHub Copilot 上使用前,需先阅读平台映射及其各技能说明。
主要能力:确定作用范围(调用者的文件或 diff,否则使用当前相对基线分支 main 的 diff,含工作树);启动 subagent_type 为 "pstack:comment-sicko" 的代理并传入范围;审查报告与 diff,拒绝应用代码修改、范围越界、异常保护的删除、错误陈述的 MUST KILL 理由,以及把有意保留代码视为有罪的标记;审计遗漏的作用域内 lint 和 TypeScript 抑制;对薄弱的 IMPORTANT 或 do not remove 的 kill/keep 运行 /how 或 /why;对模糊的 kill 不恢复,对已被反驳或仍模糊的 keep 删除;被拒绝的报告可回退并重跑一次,第二次拒绝则报告为 open 并使 /no-comments 失败。
使用方式:直接删除死路径、去掉参数或改用真实 API 来修复简单的被接受标记;若修复需要结构,运行一次 /architect 得到草图后停止,由后续步骤实现。实施范围内最小的根因修复,移除所有具名 workaround;根因超出范围时落地最小范围内修复并报告其余为 open。约束注释(do not remove、do not change wording、talk to X before changing)保留给无法更改的事项,并提供最便宜的范围内类型、运行时、测试或 CI lint 编码方案,等待交互批准;无人值守和 eval 需调用者预先批准。批准后先编码再删除,否则删除并报告约束为 open 并草拟范围外工作。
限制:不恢复被拒绝的注释;不扩大范围;不添加症状防护;principle-fix-root-causes 和 principle-redesign-from-first-principles 仅指导意图,不授权扩大范围。最终报告删除数量、恢复的注释、重跑、架构草图、修复、编码提议、编码、未强制约束及其他 open 工作。