antislop-code 是 anti-slop 系统中的代码注释技能,需与核心文件 antislop.md 配合使用,仅在任务涉及编写或编辑代码注释时加载。核心文件提供机制(目的测试、三个层级、交付门),本技能提供注释相关的具体细则。
用途:过滤读起来像通用 AI 生成的注释(装饰性、复述显而易见内容、生硬、大声),同时保留承载真实信息的注释;以编号引用核心规则,不重复或重新编号。
主要能力:识别并处理装饰性分隔符、复述显而易见的内容、工作流叙述、空标签、模糊占位符、签名回声、装饰性 emoji、结束标记;同时纠正过度解释的长注释、逐行叙述、生硬或大声的措辞。每条规则采用相同结构:Tell(模式)、Why(为何像 slop)、Fix(替代做法),并引用核心规则 R-XX。
判断标准:注释应解释代码未体现的内容,如原因、约束、非显而易见的行为。不得删除解释业务逻辑与意图、架构决策、安全考虑、性能权衡、并发行为、协议细节、API 契约、变通方案、边界情况与假设、许可与法律声明的注释。价值不等于长度,一条变通说明只写一行,不写成段落。
使用方式:任务触及代码注释时与 antislop.md 一同加载。所有条目格式为 Tell、Why、Fix,并标注 R-XX。文末附“代码注释清单”,与核心交付门一起运行,逐项确认:每条注释是否增加代码未展示的信息(R-31)、是否避免装饰性分隔符与全大写横幅、是否避免复述显而易见内容、是否避免工作流叙述、是否避免空标签与无任务 TODO、是否避免装饰性 emoji 与结束标记、注释密度是否为每逻辑块一条、每条是否一到两行、是否简短自然且使用句子式大小写、范围是否守住。
限制:范围护栏规定只修改注释,绝不修改可执行代码、标识符、导入、格式、缩进、空白、控制流或逻辑;拿不准时保持代码不动。资料未提供安装命令、价格、平台支持或效果数据。