SuperAPI AI 工具集

write-rewrite

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

用途:write-rewrite 是面向代码重写任务的执行规范,叠加在基础 implement-task 规则之上。重写比重构风险更高,因为允许行为改变,意外改动容易藏在有意改动允许的位置。它把变更约束到两个可证明面:delta(所有有意改变的行为)与 preserved non-delta(其余必须原样保留的行为)。

主要能力与要求:行为增量必须在写代码前记录,来源为 spec 与 change plan,涵盖输入处理、输出形态、错误、副作用、顺序、默认值等;若未记录应先停下补齐。验收标准需同时覆盖新行为与保留行为。delta 用命名检查逐项验证,新测试需先失败后通过并粘贴两次转变;non-delta 用等价性检查(属性测试、差分测试或变更前固定的黄金输出)证明未漂移。需在整个代码库中检索被重写符号及其字符串形式(动态派发、注册表、反射、生成代码、配置),逐一处理调用方并粘贴搜索结果。发现未记录的涌现行为变化必须停止,或上游修订 delta,或改回保留原行为。不得借重写之名重新设计周边模块,delta 之外的内容只能作为发现候选。每批后运行检查并粘贴,命令从 AGENTS.md 解析,未定义时询问;不得对自己的工作出具评审结果。

适用场景:行为被有意改变的代码重写任务,以及需要区分重写、重构、迁移、功能新增的场合。

限制:这些是评审包检查的约定,编辑时无强制机制;资料未提供具体安装命令、平台、收费或价格信息。