test-runner

核心用法

test-runner 是一款纯文档型 Skill，专注于为开发者提供跨语言、跨框架的测试编写与运行指南。其核心内容覆盖 TypeScript/JavaScript（Vitest、Jest、Playwright）、Python（pytest）、Swift（XCTest）三大主流技术栈，从单元测试、集成测试到端到端（E2E）测试形成完整闭环。Skill 内置 TDD（测试驱动开发）工作流图解，以及 Arrange-Act-Assert、Mocking、异步测试等经典模式示例，开发者可直接复制配置代码和命令快速启动项目测试体系。

显著优点

1. 多语言一站式覆盖：无需切换多个文档，单点获取 JS/TS、Python、Swift 的测试方案，降低团队技术栈迁移成本。
2. 实战导向的配置模板：提供可直接运行的 vitest.config.ts、、pytest` 命令行参数、Playwright 项目配置等，减少从零摸索时间。
3. 测试策略清晰：明确区分"Always test"与"Don't bother"清单，帮助团队聚焦高价值测试场景，避免过度测试或测试遗漏。
4. 覆盖率工具链完整：集成 v8、istanbul、pytest-cov 等主流覆盖率方案，并附 HTML 报告查看命令，便于质量门禁建设。

潜在缺点与局限性

1. 无自动化执行能力：Skill 仅提供文档参考，所有命令需用户手动输入，无法直接触发测试运行或结果解析。
2. 框架版本锁定风险：示例代码基于特定版本（如 Vitest、pytest），若用户环境版本差异较大，可能出现配置不兼容。
3. 缺乏 CI/CD 集成指导：未涉及 GitHub Actions、Jenkins 等流水线配置，团队需额外补充持续集成方案。
4. 无项目结构建议：未说明测试目录组织规范（如 __tests__ vs tests//），大型项目可能面临目录混乱。

适合的目标群体

• 全栈开发者：需要在同一项目中处理前后端多语言测试的工程师。
• 技术负责人：为团队制定测试规范、选型测试框架的架构师。
• 测试新手：希望系统学习 TDD 流程和测试模式、快速上手的初级开发者。
• 开源维护者：需要为项目补充测试覆盖率、提升代码可信度的仓库所有者。

使用风险

• 环境依赖风险：示例命令依赖 Node.js、Python、Swift 等运行时环境，若用户未安装或版本不匹配，命令将执行失败。
• 配置覆盖风险：直接复制配置文件可能覆盖现有项目配置，建议先备份或 diff 对比。
• 覆盖率阈值误导：--cov-fail-under=80 等参数若未结合项目实际，可能导致 CI 频繁失败或虚假安全感。
• Mock 误用风险：示例中的 vi.stubGlobal 等全局替换操作，若未在 teardown 中恢复，可能污染后续测试用例。