SuperAPI AI 工具集

integrate

编程与开发

查看项目

更新于 10-24 16:19

技能介绍

integrate 是一套面向代码库演进的严格集成协议,用于引入新的库、工具或架构模式,确保新标准真正落地,而不停留在安装层面。

用途与目标:当新库或工具引入后没有完成全面集成时,旧有模式仍可运行,工程师和 AI 智能体会沿用熟悉的旧习惯,或照抄附近的过时代码。仅靠人工警惕或评审意见来推动采纳并不可靠。该协议的目标是:整个代码库只使用新标准,并通过机械性防护(linter、类型边界或直接移除)让旧方式即使误用也无法通过。

不变规则:

  1. 同批迁移全部现有调用方:按 migrate-callers-then-delete-legacy-apis 将所有现有用法迁移到新标准,不把部分迁移留给未来假设阶段。
  2. 机械性强制边界:通过结构性关卡(如 no-restricted-imports 等 lint 规则、编译器类型约束或 CI 检查)阻止新代码使用废弃方式,而不是只靠文档警告(encode-lessons-in-structure)。
  3. 统一为唯一标准模式:只保留一种调用新工具的方式,避免读者在语法差异中寻找不存在的含义。
  4. 删除废弃实现与依赖:按 subtract-before-you-add 从清单和锁文件中彻底移除过时函数、无用的兼容层和未使用依赖。

使用方式:执行工作流 integrate-new-tool 提供逐步流程:采纳依赖、迁移调用点、锁定防线。领域参考 mechanical-enforcement 说明用于封禁废弃模式的 linter、编译器屏障与 CI 断言。另有委派技能 poteto-principles(遵循上述三条原则)与 dont-it-yourself(确认引入的工具确实替代了自行编写的代码)。

适用场景:在代码库中引入或替换第三方库、开发工具、架构模式,需要一次性完成迁移并防止旧写法回潮时使用。

限制:资料未提供具体安装命令、配置示例、支持的语言或工具平台、许可证及收费信息,这些暂未提供。