Agent-Skills.md

Agent Skills: 单元测试

单元测试编写指南，涵盖 JUnit5/MockK 使用、测试命名规范、Mock 技巧、测试覆盖率要求、TDD 实践。当用户编写单元测试、Mock 依赖、提高测试覆盖率或进行测试驱动开发时使用。

UncategorizedID: tencentblueking/bk-ci/unit-testing

Repository

tencentblueking/bk-ci
TencentBlueKingLicense: NOASSERTION
2,498520

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TencentBlueKing/bk-ci/tree/HEAD/ai/skills/unit-testing

Skill Files

Browse the full folder contents for unit-testing.

Download Skill

Loading file tree…

ai/skills/unit-testing/SKILL.md

Skill Metadata

Name
unit-testing
Description
为 BK-CI 代码编写单元测试时使用，例如 JUnit5、MockK、测试组织、依赖 Mock、异常校验和 TDD 场景。当用户要补测试或用测试驱动实现时优先使用。

单元测试

适用场景

  • 编写 Service / DAO / 工具类单元测试
  • Mock 外部依赖和边界条件
  • 验证正常路径、异常路径和回归场景
  • 采用 TDD 或补测试防回归

不适用场景

  • 集成测试、端到端测试
  • 只是实现业务逻辑，不准备补测试
  • 只是排查运行环境问题

快速指导

  1. 这个 skill 关注的是 BK-CI 项目里的单元测试写法，不是测试理论总览。
  2. 测试先保证意图清晰，再考虑覆盖率；重点是关键分支和回归风险。
  3. 常见模式仍然是 AAA、Mock 外部依赖、显式断言结果和交互。
  4. 写测试前先确认你测的是业务规则，不是把实现细节机械复述一遍。
  5. 如果测试涉及后端接口或服务结构，再联动看 backend-microservice-development。

高信号规则

  • 正常路径和失败路径都要有代表性覆盖
  • Mock 应该服务于隔离边界，而不是掩盖设计问题
  • 测试命名要能直接表达行为和预期

关键陷阱

  • 只测 happy path
  • Mock 过度，导致测试几乎失去行为价值
  • 断言太弱，只证明代码跑过，没有证明结果正确

延伸阅读

  • 如果你在改后端服务：再看 backend-microservice-development