About unit-testing
A unit-testing skill for BK-CI projects. It guides tests for services, DAOs, and utilities, emphasizing behavior, isolated dependencies, and regression risks.
Key features
- 01Test services, DAOs, and utilities
- 02Mock external dependencies and boundary conditions
- 03Cover normal, error, and regression cases
- 04Use AAA and explicit assertions
Use cases
- 01Add unit tests for a service or DAO
- 02Verify error paths and business rules
- 03Prevent regressions with tests
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ tencentblueking/ bk-ci --skill unit-testingAfter installing, type/unit-testingin Claude Code to confirm it loaded.
Details
From the project README单元测试
适用场景
- 编写 Service / DAO / 工具类单元测试
- Mock 外部依赖和边界条件
- 验证正常路径、异常路径和回归场景
- 采用 TDD 或补测试防回归
不适用场景
- 集成测试、端到端测试
- 只是实现业务逻辑,不准备补测试
- 只是排查运行环境问题
快速指导
- 这个 skill 关注的是 BK-CI 项目里的单元测试写法,不是测试理论总览。
- 测试先保证意图清晰,再考虑覆盖率;重点是关键分支和回归风险。
- 常见模式仍然是 AAA、Mock 外部依赖、显式断言结果和交互。
- 写测试前先确认你测的是业务规则,不是把实现细节机械复述一遍。
- 如果测试涉及后端接口或服务结构,再联动看
backend-microservice-development。
高信号规则
- 正常路径和失败路径都要有代表性覆盖
- Mock 应该服务于隔离边界,而不是掩盖设计问题
- 测试命名要能直接表达行为和预期
关键陷阱
- 只测 happy path
- Mock 过度,导致测试几乎失去行为价值
- 断言太弱,只证明代码跑过,没有证明结果正确
延伸阅读
- 如果你在改后端服务:再看
backend-microservice-development
Comments
Markdown supported