阻止智能体采取捷径。清理你已有的技术债务。
遗漏的测试、隐藏的错误、占位实现、被忽略的类型检查。anti-slop 会在智能体所做的每项变更中发现这些问题,并将变更连同每项发现一并退回。每周债务清理会修复遗留问题。
- 测试被跳过src/checkout/coupon.test.ts:88
it.skip('rejects an expired coupon', …) - 错误被吞没src/checkout/apply-coupon.ts:41
} catch {}
- 已修复测试被跳过Anti-slop
- 已修复错误被吞没Anti-slop
任务视图是 CoRoid 门户的复现。其中的任务、文件及发现结果仅为示意。
- 规则数量
- 116
- 规则类别
- 13
- 默认阻断的规则
- 46
- 阻断变更的现有问题
- 0
它检测的对象。
规则按类别分组。每类规则可设置为阻断、建议或仅记录。负责人可为全组织或单个项目调整这些设置。
- 测试用例
- 聚焦的或被跳过的测试用例、被删除的测试用例、被移除或较弱的断言、无法失败的测试用例,以及掩盖不稳定测试用例的重试操作。
.only.skipexpect(true).toBe(true)
- 抑制项
- 新的代码规范禁用项、被忽略的类型错误、强制转换为 any 的类型,以及未被纳入覆盖率统计的代码。
@ts-ignoreas anyeslint-disable
- 构建与 CI
- 被移除或允许失败的测试步骤、较低的覆盖率阈值、无测试用例却通过测试的运行时、被跳过的提交钩子,以及被提交的构建输出结果。
continue-on-error: true--passWithNoTests
- 测试证据
- 未执行任何测试的运行时、测试用例数量少于上一次成功运行的结果、将部分运行结果误报为完整运行,以及将旧的缓存结果当作新运行结果显示。
Tests: 0 total--onlyChanged
- 生产代码
- 占位符代码、调试代码、诸如“在实际实现中会如此”之类的注释、面向人员的说明、模拟数据,以及导入测试代码的生产环境代码。
throw new Error('Not implemented')debugger;
- 错误处理
- 被隐藏或被默认值替代的错误、允许在检查失败时仍访问的权限校验,以及无限制的重试操作。
except: pass.catch(() => {})
- 安全性
- 硬编码的密钥、被关闭的TLS检查、被移除的登录检查、允许携带凭证的开放CORS,以及通过字符串拼接生成的SQL语句。安全性模块负责制定这些规则并决定其执行方式。
rejectUnauthorized: falseverify=False
- 架构
- 新的导入循环、跨越设定边界的导入操作、复制的代码块、变更后未被使用的代码,以及已淘汰模式的新副本。
- 依赖项
- 变更后的清单文件却缺少对应的锁文件、为已有功能额外引入的第二个库、未固定版本的依赖项,以及无人请求的升级操作。
"latest"
- 缓存
- 不含租户信息的缓存键、永不过期的内存缓存,以及代码运行时应读取的构建时数值。
- 注释
- 评论重复下一行内容,用于描述编辑内容、含糊表述或与旁边的代码相矛盾。
// Updated to// should work
- 变更范围
- 规格说明中未涵盖的文件、仅涉及格式调整的变更,以及任务无需进行的重命名操作。
- Agent轨迹
- 智能体在执行过程中的操作记录,例如删除失败的测试用例,或将预期值修改为失败运行所输出的结果。
只有变更引入的问题才会被阻断。
大多数代码库中已存在部分此类模式。Anti-slop会按来源对每项发现进行分类,确保旧有技术债不会阻碍新工作的开展。
- 新引入
- 本次变更中新出现的项。来自阻塞性规则的发现会将变更退回给Developer智能体处理。
- 已触及
- 早已存在的项,位于本次变更所编辑的行或函数中。它会被记录下来。若您的变更规范有相关要求,变更便会修复它。
- 现有
- 代码库中其他位置的项。它会被记录为Factory中的技术债。每周的技术债清理工作可为您修复它。
移动代码不视为新引入,复制代码才属于新引入。
逐步修复旧有的技术债务,每周处理一点。
旧的技术债务不会阻碍开发进程,但也没必要长期留存。为项目开启每周技术债务清理功能后,CoRoid会分步完成清理工作。
- 每周,CoRoid会扫描默认分支中存在的技术债务。
- 它会生成每次仅涉及几个文件的小型清理任务。
- 您可以设定同时开放的清理任务数量上限,确保您的请求能优先得到处理。
- 每个清理任务都像其他任务一样经过测试和审核,最终由您批准对应的pull request。
- 测试用例阻塞项
- 忽略项阻塞项
- 生产环境代码阻塞项
- 错误处理阻塞项
- 注释建议项
- 变更范围建议项
您可以决定变更可被允许的程度。
变更规范会告知Developer智能体在工作时可清理哪些内容。
- 精准式仅处理规范所需的内容。其他问题仅会被记录,不会自动修复。
- 平衡式默认同时修复变更所编辑行上的小问题。
- 修复式同时清理变更所编辑函数中的发现项。
Developer 智能体遵循相同的规则。
Anti-slop并非仅在最后才进行评判。智能体在编写变更时会获取相关规则,且无法违背这些规则。
- 智能体起始时会依据您的变更规范和所阻止的模式,并附带对应的替代模式。
- 每次编辑后它都会查看快速规则,并在QA运行前获得一次修复阻塞性发现的机会。
- 智能体无法接受自身的发现项。若某智能体判定某测试用例有误并对其进行修改,则必须由审核人批准该变更。
- 代码库文件
.coroid/anti-slop.yml可用于添加规则和排除生成的路径。CoRoid会从变更的基目录读取该文件,因此变更无法放宽自身规则。
智能体会生成软件包名称,攻击者会利用这些名称进行注册。
这被称为slopsquatting。模型会推荐一个不存在的软件包。有人便发布同名软件包,下一个安装它的智能体会运行其中的代码。
在一项针对16个模型生成的223万个代码样本的研究中,19.7%的样本引用了至少1个不存在的软件包。当同一提示词被运行10次时,其中43%的名称每次都会重复出现,因此攻击者可以预测这些名称。
CoRoid会对每个新依赖项执行哪些检查?
- CoRoid会查询智能体添加的每个npm或PyPI软件包在其公共注册表中的信息。
- 如果软件包不存在,更改会被退回给开发者智能体。项目负责人必须首先确认项目是从公共注册表安装依赖项的。
- 当软件包上线时间不足30天时,CoRoid会将其标记为需审核;如果软件包名称与热门软件包仅相差一两个字母,或者npm软件包的下载量极少,也会被标记。
- 在相同设置下,若软件包在OSV数据库中被列为恶意软件,更改也会被退回。对于PyPI,CoRoid无法知晓需求会安装哪个版本,因此只有针对特定版本的公告才会被标记。
- 如果新的npm软件包在安装时会运行代码(即安装脚本),CoRoid会将其标记为需审核。
万一恶意软件包仍被安装怎么办?
智能体的命令在隔离的沙箱环境中运行,其中不会存储模型提供商的密钥、代码库令牌以及项目的任何机密变量。
这些规则属于安全团队的代码扫描范畴,用于检查更改所添加的依赖项;对于已有的软件包,安全团队会监控是否有新的安全通告。
对你已有的智能体也使用相同的规则。
使用自有编码智能体的工程师也可应用贵组织的规则。
- AGENTS.md 代码片段
- 下载供智能体使用的指令片段,其中包含项目的变更规范、被阻止的模式及最重要的规则。
- CoRoid MCP服务器
anti_slop_rules用于描述您发布的策略。anti_slop_scan用于扫描同步项目的分支。两者均仅为读取操作。- CoRoid 对拉取请求的质量控制
- 开启pull request检查后,相同的检查会应用于开发人员创建的GitHub拉取请求,并在相应行标注每项发现。
它已在我们自己的代码上通过测试。
CoRoid 是基于 CoRoid 构建的,因此 anti-slop 在应用于其他人的代码库之前,先在其自身的代码库中运行。
对所有源文件的扫描
我们模拟智能体编写代码的过程,扫描了CoRoid仓库中的所有11,536源文件。扫描发现规则误判了6种模式。修复后,阻塞性问题的数量从5,366降至2,253。
仍被阻止的内容正是规则必须识别的对象,例如我们通知代码中的一条注释:“在实际实现中,您会获取用户的FCM令牌。”
Rules a model judges
两条规则会逐行询问模型:一是检查代码是否已预防某种情况,二是检查注释是否与旁边的代码矛盾。它们仅提供建议。在真实合并的变更中,共600行代码,其中误判了无项,每次扫描的成本最多为US$0.0015。
在质量控制模块中将其启用即可。
所有者和管理员可为组织默认设置或单个项目开启 anti-slop。该项目下次运行时便会应用此设置。
- 打开质量控制模块,选择组织默认设置或指定项目。
- 开启 anti-slop。它会向策略中添加五项要求。
- 选择变更规范和需阻止的组别。对于单个项目,您还可开启每周技术债清理功能。若关闭 anti-slop,CoRoid 会保留这些设置以备下次使用。
它新增的五项要求
- 测试仍能验证此次变更
- 不会发布未完工或仅用于测试的内容
- 不会产生新的结构性技术债务
- 变更仍符合既定范围,且风格与现有代码库保持一致
- 新依赖项真实且可信。
- 组织默认配置3 个项目正在采用此配置2 / 5
- 门店页面自定义设置4 / 5
- 文档站点遵循默认配置2 / 5
- 计费 API遵循默认配置2 / 5
- 移动应用遵循默认配置2 / 5
- Anti-slop如果变更导致测试用例失效、错误被忽略、占位符被直接发布或产生结构性技术债务,系统会将该变更退回。
- 单元测试系统会在每次变更后,自动查找并运行代码库中的单元测试。
- 浏览器测试2 / 3与默认配置不同系统会针对变更内容执行指定的浏览器操作流程测试。
- 翻译与默认配置不同该检查项会验证变更后的字符串是否已被翻译,同时确认其中的占位符及复数形式是否匹配。
- 代码库校验系统可运行用户自定义的命令,例如代码格式化、文件大小检查、数据库迁移、集成测试以及安全扫描等。
- 全面 QA全面校验开启Thorough QA后,系统会根据规范生成实时的验证证据与截图;若未开启,则采用标准QA流程。