（1559期）test-runner – 多语言测试框架速查手册

多语言测试框架速查手册 纯文档型测试框架指南，涵盖 Vitest、Jest、pytest、Playwright 等主流工具，帮助开发者快速搭建多语言测试体系，提升代码质量与交付信心。 使用说明 核心用法 test-runner 是一款纯文档型 Skill，专注于为开发者提供跨语言、跨框架的测试编写与运行指南。其核心内容覆盖 TypeScript/JavaScript（Vitest、Jest、Playwright）、Python（pytest）、Swift（XCTest）三大主流技术栈，从单元测试、集成测试到端到端（E2E）测试形成完整闭环。Skill 内置 TDD（测试驱动开发）工作流图解，以及 Arrange-Act-Assert、Mocking、异步测试等经典模式示例，开发者可直接复制配置代码和命令快速启动项目测试体系。 显著优点 多语言一站式覆盖：无需切换多个文档，单点获取 JS/TS、Python、Swift 的测试方案，降低团队技术栈迁移成本。 实战导向的配置模板：提供可直接运行的 vitest.config.ts、、pytest` 命令行参数、Playwright 项目配置等，减少从零摸索时间。 测试策略清晰：明确区分"Always test"与"Don't bother"清单，帮助团队聚焦高价值测试场景，避免过度测试或测试遗漏。 覆盖率工具链完整：集成 v8、istanbul、pytest-cov 等主流覆盖率方案，并附 HTML 报告查看命令，便于质量门禁建设。 潜在缺点与局限性 无自动化执行能力：Skill 仅提供文档参考，所有命令需用户手动输入，无法直接触发测试运行或结果解析。 框架版本锁定风险：示例代码基于特定版本（如 Vitest、pytest），若用户环境版本差异较大，可能出现配置不兼容。 缺乏 CI/CD 集成指导：未涉及 GitHub Actions、Jenkins 等流水线配置，团队需额外补充持续集成方案。 无项目结构建议：未说明测试目录组织规范（如 tests vs tests//），大型项目可能面临目录混乱。 适合的目标群体 全栈开发者：需要在同一项目中处理前后端多语言测试的工程师。 技术负责人：为团队制定测试规范、选型测试框架的架构师。 测试新手：希望系统学习 TDD 流程和测试模式、快速上手的初级开发者。 开源维护者：需要为项目补充测试覆盖率、提升代码可信度的仓库所有者。 使用风险 环境依赖风险：示例命令依赖 Node.js、Python、Swift 等运行时环境，若用户未安装或版本不匹配，命令将执行失败。 配置覆盖风险：直接复制配置文件可能覆盖现有项目配置，建议先备份或 diff 对比。 覆盖率阈值误导：--cov-fail-under=80 等参数若未结合项目实际，可能导致 CI 频繁失败或虚假安全感。 Mock 误用风险：示例中的 vi.stubGlobal 等全局替换操作，若未在 teardown 中恢复，可能污染后续测试用例。 原始说明 Write, run, and manage unit, integration, and E2E tests across TypeScript, Python, and Swift using recommended frameworks.