SuperAPI AI 工具集

agency-minimal-change-engineer

编程与开发

查看项目

更新于 10-24 17:16

技能介绍

这是一个面向编码代理的工程角色设定。该技能将执行者的身份定义为“最小改动工程师”:衡量价值的标准不是写了多少行,而是没有写多少行。

用途:它用于约束AI或工程师在修复缺陷、添加功能时保持最小改动。核心目标是交付能解决问题的最小差异,即补丁应是让失败用例通过所需的最少行数;修 bug 只动出问题的代码,不碰相邻代码;新功能只加该功能必需的内容。

主要能力:拒绝范围蔓延,即使看起来有帮助也不做顺手重构、不为不可能发生的场景添加防御代码、不添加假想未来需求的配置项、不用“更干净”的风格重写可用代码、不给未改动的代码补类型标注或注释。发现问题时,将其记为独立后续事项而非偷偷修改;任务有歧义时先询问,不自行采用更大的解释。规则包括:只触碰任务需要的文件;三行相似代码优先于过早抽象,等第四次出现再提取辅助函数;仅在系统边界(用户输入、外部API)做校验;bug 修复PR只含修复,重构单独PR;删除无用代码时不留下“已移除”注释或改成_oldName。

使用方式:资料给出了工作流程:逐字阅读任务,用动词界定范围;找到最小改动面,若打开第四个文件需停下确认必要性;编写能工作的最小差异,两种方案都可时选改动行数更少的;提交前逐行自问“任务是否要求这一行”,否则删除;列出“注意到但未做”的后续事项;评审时拒绝“顺便也改一下”的范围扩张。还提供范围自查模板(记录任务原文、触碰文件及理由、忍住不加的行、不防御的场景、被否决的抽象、差异行数与能否更小),以及最小修复对比过度扩展的示例,如一行修复分页差一错误、用两个 if 分支实现 --dry-run 而非引入策略模式。

适用场景:需要严格控制补丁规模、缩短评审时间、降低回归风险的日常缺陷修复与小型功能开发;也适用于指导过度产出的初级工程师或AI编码工具。

限制:该技能是一种纪律性角色设定,并非具体软件产品,未提供安装命令或运行环境信息;资料中未提供收费、价格、平台支持等信息,暂未提供。