SuperAPI AI 工具集

principle-change-conventions-completely

编程与开发

查看项目

更新于 10-29 02:29

技能介绍

用途:该技能用于处理一类决策问题——在已经形成约定的类别里,有人提出一个不同的命名、风格、组织方式或行为契约。核心立场是:局部更优的模式本身不足以构成例外,要么保留既有约定,要么在明确边界与授权下完成整体替换。

主要能力:

  1. 识别并命名既有约定、拟议替代方案、所属类别及被该约定管辖的边界。激活前提是当前任务证据能够同时指出这三项。
  2. 在约定层级上进行比较。命名、风格、组织层面从指导文件与代表性用法中提炼共同策略,例如时间戳字段可遵循统一的命名策略,而各字段行为的含义可以不同;行为契约层面在合并前需比较目的、输入输出、不变量、失败方式、生命周期、顺序、调用方、归属与兼容性,仅拼写或语法相似不构成职责等价的证明。
  3. 保留有意的角色与语义区分,例如读写模型即使命名相同也不必合并为同一类型。
  4. 决策规则:在真实的约定类别内,保留既有约定,或完成一次获授权的有界替换;在比较层级上保留表达含义的差异。
  5. 执行前盘点边界内该类别的全部出现位置,包括受影响的调用方、测试、示例与契约;当表示形式跨越接口时,还需包含生产者、消费者与兼容代码。
  6. 按规模执行:简单内部约定变更只需盘点、协调修改与相关检查;保留行为的执行使用重构流程,涉及依赖、API、数据形状、平台、归属或兼容性过渡时使用迁移流程,涉及重要目标契约决策时使用架构流程。
  7. 完成后验证盘点范围内均使用目标约定、受影响契约仍然正确,且仅对已命名的类别与边界声明完成。

兼容与完成标准:完成意味着在声明边界内,该类别管辖的每一处出现都遵循目标策略,不存在未解释的活跃遗留约定;某个包内完成不等于仓库内完成。排除项需要真实的策略、语义或归属区分,而非任意局部盘点。若兼容性要求新旧暂时共存,需明确权威表示、允许的旧/新生产方与消费方、过渡顺序、回滚方式以及最终退役的证据;仅有接受旧键不足以保留读取旧键的客户端。生成或外部归属的表示可在经批准的适配器后保持不同,需区分长期边界适配器与必须退役的临时兼容代码。

停止条件:当类别或相关契约未确定、盘点无法支撑完成、缺少必要的兼容或退役决策、或完成需要未经授权的路径、归属方、行为或 PR 分组时,应在局部采纳前停止并回到规划,同时保留既有约定等待授权。仅为更优模式偏好,不能据此确立一个不同类别。

适用场景:命名风格统一(如字段名从 archived_at 改为 archivedAt)、小范围原子化风格替换、读写模型是否合并的判断、公共 API 键名迁移与兼容期安排、任务范围小于类别范围时的取舍。

限制:资料未说明具体平台、工具集成或代码实现方式;文中提到的重构、迁移、架构等执行流程由其他所有者提供,本技能仅给出决策与边界判断。