SuperAPI AI 工具集

ckvd-testing

测试与质量

查看项目

更新于 10-16 08:11

技能介绍

用途:为 crypto-kline-vision-data(CKVD)项目运行与编写测试,覆盖代码检查、单元测试、导入验证、集成测试和覆盖率统计。

主要能力:

  • 提供测试工作流清单:ruff 检查、单元测试(快速、无网络)、导入验证、集成测试(涉及 API 变更时)、覆盖率检查(新增代码时)。
  • 给出常用命令:uv run -p 3.13 ruff check --fix .;uv run -p 3.13 pytest tests/unit/ -v;uv run -p 3.13 python -c "from ckvd import CryptoKlineVisionData; print('OK')";uv run -p 3.13 pytest tests/integration/ -v;uv run -p 3.13 pytest tests/unit/ --cov=src/ckvd。
  • 说明测试目录组织:tests/unit(含 streaming 异步测试)、tests/integration、tests/okx、tests/fcp_pm。
  • 列出测试标记:@pytest.mark.integration、okx、serial、asyncio,并给出对应运行方式(如 pytest tests/okx/ -m okx -v)。
  • 提供编写新测试的模板:Arrange/Act/Assert 结构、使用 patch 模拟 FSSpecVisionHandler 与 UnifiedCacheManager、异步流测试使用 pytest-asyncio 与 AsyncMock 模拟 KlineStream。
  • 附带辅助脚本与 TodoWrite 任务模板,例如 ./docs/skills/ckvd-testing/scripts/run_quick_tests.sh 可运行快速检查,也可带测试名过滤。

使用方式:按清单顺序执行命令;新增测试时参考 tests/unit 既有模式,必要时加标记;异步流测试需安装 pytest-asyncio,可用 --asyncio-mode=auto 运行。修改技能后需核对命令路径、目录结构、mock 导入路径与 @-链接,并将变更追加到 evolution-log.md。

适用场景:CKVD 项目的日常测试、新增功能测试编写、覆盖率提升及对外部 API 的集成验证。

限制:部分测试(集成、OKX)需网络访问;单元测试为无网络快速执行;资料未提供具体覆盖率阈值、价格与许可信息。