claude-howto 的 /unit-test-expand 斜杠命令基于覆盖率缺口系统化扩充单元测试【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本篇介绍 Claude How To 仓库提供的/unit-test-expand斜杠命令skill 模板它以“分析覆盖率 → 定位缺口 → 按项目框架补写测试 → 验证提升”为固定工作流帮你在任意项目中系统化地提高单元测试覆盖率。读完本文你既能直接把该命令安装到自己的项目中使用也能以本仓库自带的 pytest 测试套件为实例理解每一步工作流落地的具体做法与判断依据。命令定位一个可复制粘贴的测试扩充 Skill/unit-test-expand是 01-slash-commands 目录收录的 8 个示例命令之一目标明确通过针对未覆盖的分支和边界情形来增加测试覆盖率Increase test coverage by targeting untested branches and edge cases。它的完整源文件为 01-slash-commands/unit-test-expand.md文件头是一个标准的 skill frontmatter--- name: unit-test-expand description: Increase test coverage by targeting untested branches and edge cases ---description字段同时承担两个作用一是让使用者在/菜单中快速识别命令用途二是帮助 Claude 判断何时可以自动调用该 skill。按照 01-slash-commands/README.md 中的安装说明它可以以两种方式装入项目作为 Skill推荐mkdir -p .claude/skills/unit-test-expand再将该 md 文件复制为.claude/skills/unit-test-expand/SKILL.md作为 Legacy Command复制到.claude/commands/unit-test-expand.md团队共享或~/.claude/commands/个人使用。两种方式都会注册出/unit-test-expand这个快捷命令若 skill 与同名单元命令共存skill 优先。该文档标注的制作环境为 Claude Code v2.1.220使用前请确保 Claude Code 版本不低于该水平自定义命令已并入 skill 体系.claude/commands/旧路径仍可用。核心工作流五步法完整解析命令正文是一份可直接执行的操作规程共五个步骤以下逐条继承并展开Analyze coverage分析覆盖率先运行覆盖率报告识别未测试的分支、边界情形和低覆盖区域。这一步是整个流程的前提——没有基线数据后续的“提升”就无从度量。对于 Python 项目典型做法是用pytest配合pytest-cov生成覆盖率报告如pytest --cov输出终端摘要或--cov-reportxml输出机器可读报告再针对覆盖率数值低的文件优先排查。Identify gaps识别缺口审查源码中尚未被测试触及的逻辑分支、错误路径、边界条件、null/空输入。这一步要求读代码而不是只看报告覆盖率报告只能告诉你“哪些行没跑到”而“为什么没跑到、漏掉了哪条分支”要靠人工或 AI审读条件语句、异常处理和参数校验逻辑。Write tests using projects framework用项目自己的框架写测试绝不引入第二套测试框架。命令给出了各语言生态的对应关系JavaScript/TypeScriptJest / Vitest / MochaPythonpytest / unittestGotesting / testifyRustRust test framework。Target specific scenarios针对特定场景这是缺口识别的优先级清单按四类展开下一节详解。Verify improvement验证提升再次运行覆盖率确认可度量的提升confirm measurable increase。只有“报告数字确实涨了”才算完成任务避免写了测试却没打到目标分支。四类优先补测的场景以及本仓库中的真实示例命令第 4 步列出的四类目标场景恰好能在本仓库自己的测试套件中找到印证。claude-howto 的 Python 工具链scripts/build_epub.py等配有一套 pytest 测试位于 scripts/tests可以逐一对照理解“值得优先覆盖的分支”长什么样错误处理与异常Error handling and exceptions错误路径是覆盖率缺口最集中的地方。scripts/tests/test_build_epub.py 直接导入了ValidationError与MermaidRenderError两个异常类并组织了对应的TestValidation测试组验证非法输入会触发预期的校验失败——这正是“错误路径已被测试钉住”的正面范例。边界值Boundary values: min/max, empty, nullscripts/tests/test_build_epub.py 中TestBuildState::test_initial_state断言了一个全新状态对象的所有字段都处于“空”基线计数器为 0、各缓存为空集合TestEPUBConfig则同时覆盖了“默认值”与“自定义值覆盖默认值”两条路径——默认值/自定义值正是配置类典型的 min 与 max 语义边界。边界情形与角落情形Edge cases and corner casesscripts/tests/test_check_cross_references.py 的文件头自述“focus on repo-root boundary”四个测试用例分别覆盖链接指向仓库根之外的相对路径应被跳过而非报错、仓库内指向不存在文件的链接应报告为 broken cross-reference 并返回退出码 1、合法的仓库内链接应通过并输出 All cross-references valid、以及编号章节目录缺少 README.md 的角落情形。用tmp_pathmonkeypatch.chdir构造临时仓库的做法让边界测试与真实文件系统隔离是可复用的模式。状态迁移与副作用State transitions and side effectsTestBuildState::test_reset先修改状态计数器、缓存、集合、映射各写入一项再调用reset()并断言一切归零——典型的“迁移前后快照对比”写法验证状态机转换确实清除了副作用。共享 fixturetmp_project、config、state、logger定义在 scripts/tests/conftest.py 中其中tmp_project用PIL动态生成一张真实 PNG 作为 logo避免测试依赖二进制文件这也是“测试自建环境、不依赖外部状态”的良好实践。实战把工作流应用到 claude-howto 仓库自身把五步法落到本仓库的 Python 工具链上可以完整走一遍第 1 步的数据已在仓库中。根目录的 coverage.xml 是一份由 coverage.py 7.13.1 生成的 Cobertura 格式报告整体line-rate0.7564628 行中覆盖 475 行。按文件拆开看build_epub.py的line-rate为 0.6498而tests/conftest.py、tests/__init__.py均为 1.0tests/test_build_epub.py高达 0.9939。低覆盖区域一目了然——scripts/build_epub.py 是/unit-test-expand应该优先攻击的文件约 35% 的可执行行尚未被触及。还有一个关键细节该报告的branches-valid0、branch-rate0即生成时未启用分支覆盖。对照命令第 1 步“identify untested branches”可以推断出第一条操作建议——重跑覆盖率时必须显式开启分支统计如pytest --cov --cov-branch否则“未测试分支”这一维度根本无法进入报告第 2 步的缺口识别会系统性遗漏if/else、循环边界这类只覆盖了“部分分支”的行。第 3 步的框架与命名约定在 scripts/pyproject.toml 中已固定testpaths [scripts/tests]——pytest 默认只收集该目录python_files [test_*.py]、python_functions [test_*]——新测试文件与方法必须沿用这套命名asyncio_mode auto配合 scripts/requirements-dev.txt 中的pytest-asyncio0.21——异步测试无需手动加装饰器pytest-cov4.0.0已在 dev 依赖中覆盖率工具链就绪同文件还配置了 ruff 的per-file-ignorestests/*.py [S101, PLR2004]说明测试代码允许使用assert与魔数比较新测试可直接遵循这一宽松口径。运行方式按 scripts/README.md 的说明uv run --with pytest --with pytest-asyncio \ --with ebooklib --with markdown --with beautifulsoup4 \ --with pillow \ pytest scripts/tests/ -v补写测试后在第 5 步重跑并对比 coverage.xml 中build_epub.py的line-rate是否从 0.6498 上升即完成“measurable increase”的验证闭环。输出约束只给新测试代码块命令末尾有一条容易被忽视但很关键的输出约束Present new test code blocks only. Follow existing test patterns and naming conventions.即命令只要求 Claude 输出新增的测试代码块不解释设计、不改动被测源码并且风格上必须跟随项目既有模式。对本仓库而言这条约束具体化为新文件放scripts/tests/且命名为test_*.py类按被测对象分组如TestBuildState方法名用test_前缀并表达场景用 scripts/tests/conftest.py 提供的共享 fixture而不是各自重建环境。这样的输出天然是可审阅、可直接粘贴进 diff 的——测试扩类任务的价值在于“增量最小、验证最快”约束输出格式正是为了控制审阅成本。小结与相关资源/unit-test-expand把“提高覆盖率”这件容易做成盲目堆用例的活压缩成五个可执行的步骤先拿基线报告、再按四类场景异常、边界、角落、状态迁移定向补测、用项目既有框架与命名约定落地、最后用第二次覆盖率报告量化提升。本仓库的 pytest 套件、scripts/pyproject.toml 的收集规则与 coverage.xml 的既有数据恰好为每一步提供了可对照的真实样本——尤其build_epub.py约 65% 的行覆盖率与未启用的分支统计正是一个现成的扩充靶点。延伸阅读01-slash-commands/README.md — 斜杠命令总览内置命令、skill frontmatter 参考allowed-tools、disable-model-invocation、context: fork等字段、安装与排错03-skills/README.md — Skills 完整参考自动调用、目录结构、渐进式加载scripts/README.md — EPUB/网站构建脚本的运行方式与开发环境搭建scripts/tests/conftest.py、scripts/tests/test_build_epub.py、scripts/tests/test_check_cross_references.py — 本仓库测试风格的一手样本【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考