SuperAPI AI 工具集

multi-version-compliance

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 Nx 第一方插件落实或审查多版本支持合规。背景是 nx migrate --first-party-only 允许用户升级 Nx 而不带动 Angular、Cypress、Playwright、Jest、Vitest、ESLint 等第三方生态,因此每个第一方插件必须在其声明的支持窗口内持续可用,既不能在旧工作区静默回退到最新安装常量,也不能在新工作区静默失效。

主要能力:以 Linear 任务 ID(NXC-XXXX)为主入口,解析任务中的 Plugin、Needs human decision、Findings、A–F 验证清单等段落,将发现映射到规范实现模式并驱动代码修改;无任务时先做发现并产出可归档的 findings 文档。支持 review 模式,拉取 PR 并与任务发现比对,检查范围漂移,按 blocker / non-blocker 分类输出。

使用方式:multi-version-compliance <NXC-XXXX> 进入修复模式;无参数时提示输入任务 ID;传 @nx/<plugin> 时在里程碑 NXC-4072 中查找对应任务;review #<N> 进入审查模式。修复分阶段:Phase 1 读取、Phase 2 对齐并等待用户确认、Phase 3 实现、Phase 4 测试、Phase 5 本地验证、Phase 6 交接。Phase 1–2 不写文件、不建分支。

限制:依赖 Linear MCP 可用,否则回退到无任务发现路径;不创建或复制共享辅助函数,须使用 @nx/devkit/internal 中的实现;高于上限时静默通过,不警告不抛错,仅低于声明下限时抛错;keepExistingVersions 仅适用于生成器,迁移生成器豁免;PR 与提交规范不在本技能范围内。具体支持窗口、价格与平台信息暂未提供。