SuperAPI AI 工具集

cohesive-clean-breaks

通用与其它

查看项目

更新于 10-16 05:07

技能介绍

用途:当编码决策改变公共形态、包边界、运行时契约、命名、配置结构、生命周期归属或迁移策略时使用本技能。目标不是缩小 diff,而是让最终系统易于解释、难以误用,且不残留半新半旧行为。

主要能力与做法:先写一句新系统必须成立的话,若需例外、别名或兼容条款才成立,说明设计尚不干净。做归属测试,为每个重要值与不变量指定唯一所有者,两层共管通常导致漂移。做深层违规排查,先问代码在补偿什么,再决定是否删除。做非对称收益检查,能否拒绝 10%–20% 功能以消除 80%–90% 实现复杂度。做草稿重设计,先写理想调用点再反推实现。做心智内联,把辅助层内联进调用方,只有值得保留才保留。跨包或运行时边界优先注入依赖而非隐藏导入,用控制反转让下层知道事件、上层拥有策略。避免把依赖注入当垃圾桶,避免单方法 Pick<Thing, 'method'> 这类边界泄漏。若气味出现在多个调用点,先问哪一层应拥有该不变量,移动边界而非提取辅助函数。关注 Go-to-Definition 可导航性,调用方跳转应落到真实定义而非别名或再导出。做消费者人体工学测试与 API 形态压力检查,拒绝混合 API。破坏性变更规则:删除旧公共名而非别名,一次扫清调用点,文档与示例只展示新形态,在新边界校验,失败信息命名新契约,不保留旧形态回退解析器,把不变量移到构造期或类型签名,优先生命周期命名。波次排序:先构建新路径,再停止导入旧路径,然后验证(类型检查、测试、预发冒烟),最后删除旧路径。命名规则区分 define*、connect*、open*、start*、load*。配置默认导出应与文件名及校验边界一致。文件组织检查:编辑前画出当前与提议目录树,扁平化仅保留旧概念的目录。最终检查:grep 旧词汇、旧形态、旧文件名、已删导出、回退解析器、过时注释与示例,若旧名仍出现在历史规格或迁移说明之外,则切换未完成。

限制:资料未提供具体安装命令、平台支持、收费或价格信息;部分引用文档路径与示例需按原文查阅。