AgentSkillsCN

add-ktnip-ksp-tests

【库贡献者】为 ktnip KSP 处理器添加测试。适用于为新收集器编写测试，或使用新注解测试处理器行为，亦或是验证针对 Telegram Bot 库的 KSP 代码生成时使用。

SKILL.md
--- frontmatter
name: add-ktnip-ksp-tests
description: [Library contributor] Adds tests for the ktnip KSP processor. Use when adding tests for a new collector, testing processor behavior with new annotations, or verifying KSP code generation for the telegram-bot library.

Add Ktnip KSP Tests

Workflow

1. Test Data

  • •Create Kotlin source in ktnip/src/jvmTest/resources/test-data/
  • •Name: FeatureName.kt (e.g. NewHandler.kt)
  • •Must import from telegram-bot (project dependency)
  • •Include valid handlers with annotations being tested

2. Add to ProcessorK1Test

  • •In ProcessorK1Test.kt
  • •Add @Test fun featureName() = runTest("test-data/FeatureName.kt")

3. Add to ProcessorK2Test

  • •In ProcessorK2Test.kt
  • •Add @Test fun featureName() = runTest("test-data/FeatureName.kt", useK2 = true)

4. Custom Assertions (optional)

  • •Use compile(vararg SourceFile, ...) instead of runTest for custom checks
  • •Returns JvmCompilationResult; inspect exitCode, kspSourcesDir, generated files
  • •Pass custom symbolProcessors or processorProviders

runTest Behavior

  • •Loads source from resources
  • •Compiles with ActivityProcessorProvider (default)
  • •Asserts exitCode == OK
  • •Verifies generated files exist (ActivitiesData.kt, BotCtx.kt for K1)
  • •K2 tests skip file checks (marked "improve")

Reference