pstack-no-comments 是 christofferbergj/agent-skills 中的一项技能,用途集中在 Pstack 代码评审中的注释审查。根据资料,它适用于三类场景:审查不必要的叙述性注释、处理掩盖代码问题的抑制注释,以及约束类注释的处置。
主要能力方面,该技能通过 /pstack-swarm 启动名为 Comment Sicko 的子代理,并把调用方提供的文件或代码差异作为审查范围;若没有指定,则使用当前工作树相对基础分支(默认 main)的代码差异。它还会把仓库中记录的注释规范随范围一起传入。技能本身不重复子代理规则,而是在子代理报告返回后进行判断:拒绝应用代码修改、范围逃逸、受异常保护的删除、错误陈述的 MUST KILL 理由,以及把有意保留代码视为有问题的标记;对薄弱的 IMPORTANT 或“不要移除”类结论,要求先用 /pstack-how 或 /pstack-why 核查符号。对于被反驳或仍然模糊的保留项,要求删除;模糊的删除项不恢复。
使用方式上,技能按步骤推进:先启动子代理并等待报告,再审查报告和差异,逐项接受、拒绝或带理由恢复;简单问题直接删除死路径、去掉参数或改用真实 API 修复,需要结构调整时调用 /pstack-architect 一次并停在草图阶段;随后按最小根因实施范围内修复,移除工作区,范围外根因只做最小修复并报告其余开放项。约束类注释若涉及不能移除、不能改措辞或需先联系某人,则只能保留、编码或报告开放,编码需要交互批准。
限制方面,资料没有提供该技能的独立安装方式、平台兼容性、收费信息或效果数据,暂未提供。其执行依赖 Pstack 相关命令与流程的可用性,且强调不扩大修复范围、不添加症状性防护。