SuperAPI AI 工具集

build-tools-add-test-federation-annotations-to-integration-tests

编程与开发

查看项目

更新于 11-15 02:42

技能介绍

用途:本技能服务于 Kotlin 仓库的 kotlin-gradle-plugin-integration-tests 模块,目标是为该模块中每一个测试类评估并添加 Test Federation 注解,确保没有测试类处于未注解状态。该技能源自 JetBrains/kotlin 仓库的工程实践(相关工单 KT-87614),固化了逐类分析流程与团队约定。

主要能力:技能规定在评估任何类之前,先阅读 TEST-FEDERATION.md、注解源码、generated 注解文件、domains.yaml 以及 testTags.kt 等参考材料,以理解领域划分和注解机制。然后对每个测试类逐个测试方法阅读逻辑,而不是只看名称,判断其真正依赖哪些领域——例如断言 native linker 输出对应 Native,断言 npm/package.json 或 klib web 资源对应 Js/Wasm,调用 compiler plugin 扩展对应 CompilerPlugins。它强调领域注解必须基于对该领域核心逻辑的真实依赖,仅配置或断言目标平台不等于依赖该领域内部实现。

使用方式:输入可以是单个测试类或测试类列表,所有类均位于 libraries/tools/kotlin-gradle-plugin-integration-tests 下。每个类都应在类级别显式添加 @MustRunOnChangesInGradle(即使模块路径已默认映射到 Gradle 域,仍为明确性和文档目的保留)。若类中所有测试共享同一领域依赖,则在类级别添加对应领域注解;若各方法依赖不同,则改为按方法添加,且此时不应在类级别重复领域注解。@MustRunAlways 仅保留给基础冒烟测试,不能作为兜底。需检查 testTags.kt 中已有标签是否已包含 Test Federation 注解,避免重复添加。导入需按文件既有风格排序。若输入为列表,应顺序处理每个类,每完成一个类后请用户验证并手动提交,等待批准后再处理下一个,不得自动提交。整个会话中维护一张三列表格(测试类、状态、变更摘要),最后以 Markdown 格式输出,便于写入 PR 描述。

适用场景:适用于为 kotlin-gradle-plugin-integration-tests 模块批量补全 Test Federation 注解、按领域重构注解粒度、以及需要保证注解一致性的维护任务。

限制:该技能只做注解修改,无行为影响,因此不要求构建或测试运行;验证方式为视觉复查导入顺序与注解位置是否符合模块约定。它不处理 Kotlin 仓库之外的项目,也不能替代对测试逻辑的人工判断。关于 domain 的完整列表和具体注解语义,需以仓库内参考文件为准,本资料未展开全部领域细节。