SuperAPI AI 工具集

minimal-change

编程与开发

查看项目

更新于 11-04 16:17

技能介绍

Minimal change 是一个编码实践技能,用于实现功能、修复或重构时,采用完全满足请求的最低复杂度方案,尤其适合简化拟定解决方案。

选择方案:先确立请求的行为与约束,从设计中移除推测性范围,而不是删减任务需求。选定修复方案前检查受影响路径和相关调用方,搜索已有辅助函数、组件和既定模式。优先考虑项目现有行为、配置、代码、平台能力和合适且已安装的依赖,适用时复用;若复用会保留具体架构问题,则改进设计。仅当新增依赖能消除有意义的实现或维护负担时才引入,并权衡其集成成本。抽象应在表达领域概念、让共享规则有唯一归属,或分离独立变化的关注点时引入;选项和扩展点需有具体需求,避免仅为消除重复而耦合无关行为。

完整实施变更:在合适层次修复共享根因,避免逐症状打补丁或改动无关代码。遵循本地架构指引,除非请求要求,否则保持公共契约;当收益足以支撑迁移时,可在受影响范围内改进职责与边界。同步更新受影响的调用方、类型、配置和测试夹具。应最小化结果系统的复杂度,而不仅是 diff 大小;优先可读、直接的代码而非更少行数;检查使用情况后删除因变更而过时的代码。保留输入校验、有意义的错误处理、安全、可访问性和必要性能,说明任何重大限制,不静默收窄请求。

验证:运行项目要求的检查,以及与受影响行为相关的验证。对于缺陷修复或有意义的新逻辑,在可行时添加或更新聚焦的行为测试,覆盖重要的失败或边界,避免只镜像实现的测试。审查 diff 是否存在不必要范围和未完成集成;请求满足且相关检查通过后停止,并报告任何验证缺口。

该技能受 Ponytail 启发;其他收费、平台支持等信息暂未提供。