cpp-testing

cpp-testing 技能概览

cpp-testing 技能帮助你用一套实用工作流来编写、运行和调试 C++ 测试，核心围绕 GoogleTest/GoogleMock、CMake 和 CTest。它最适合需要补充覆盖率、稳定脆弱测试，或为现代 C++ 代码搭建可重复测试框架的人，而不是用于泛泛的 C++ 功能开发。

cpp-testing 适合做什么

当任务的目标是让测试更可靠、更有用时，就该用 cpp-testing 技能：新增单元测试、集成测试、回归覆盖、失败测试排查，或者借助 sanitizer 做调试。它的主要价值在于为测试设计和执行提供决策支持，尤其是在 mock、fake、测试 fixture 或基于 CTest 的运行方式之间需要做选择时。

谁应该使用它

这个 cpp-testing skill 适合 C++ 开发者、构建系统负责人，以及在已经使用或可以接入 GoogleTest/CTest 的仓库中工作的 agent。它在任务描述比较模糊、但明显与测试相关时尤其有用，比如“修复这个不稳定的测试套件”“给这个模块补覆盖率”或“让 CI 更早捕获这个 bug”。

它有什么不同

和通用提示词相比，cpp-testing 提供的是更聚焦的测试优先工作流：什么时候用、什么时候不用、测试该怎么组织、以及如何以更适合 CI 的方式运行。这让 cpp-testing guide 相比笼统的“写测试”提示更具可执行性，因为它会倾向于隔离性、可发现性，以及最小化、可复现的验证。

如何使用 cpp-testing 技能

安装 cpp-testing

使用以下命令安装 cpp-testing 技能：

npx skills add affaan-m/everything-claude-code --skill cpp-testing

然后把 agent 指向包含你的 C++ 项目的仓库。这个技能在 agent 能先查看你的真实构建文件、测试布局和现有约定，再提出修改方案时，效果最好。

先读对文件

先看 SKILL.md，然后再检查 README.md、AGENTS.md、metadata.json，以及如果存在的话，rules/、references/、resources/ 或 scripts/ 目录。就这个仓库而言，SKILL.md 是唯一的源文件，所以首轮流程很简单：先读技能说明，再把其中的建议映射到你项目自己的 CMakeLists.txt、测试目录和 CI 配置上。

给它一个可执行的任务描述

一个高质量的 cpp-testing usage 提示词，应该写清楚被测代码、失败模式、期望的测试层级，以及任何约束。例如：“为 Parser::parseConfig() 补充 GoogleTest 覆盖；保持测试确定性，避免依赖文件系统，并使用 CMake/CTest 让套件能在 CI 中运行。” 这样技能就有足够上下文去判断该用单元测试、集成测试、mock 还是 fixture。

按测试工作流推进

把这个技能当成 red-green-refactor 的辅助工具：先定义行为，再编写或调整失败测试，做最小代码改动让测试通过，最后整理测试结构。对于不稳定测试，先让它帮你定位最可能的非确定性来源，再通过 CTest 把运行范围缩小到失败的那个测试，之后再扩展回完整套件。若用于诊断，请明确你需要的是断言建议、日志建议、sanitizer 指导，还是 CI 门禁建议。

cpp-testing 技能 FAQ

cpp-testing 只适用于 GoogleTest 项目吗？

不是。GoogleTest/GoogleMock 是默认适配方案，但底层的 cpp-testing 技能同样适用于需要结构化测试执行的 CMake/CTest C++ 项目，即使仓库外围还用了别的工具也没关系。如果你的项目不是 C++，或者没有明确的测试边界，那它大概率不是合适的技能。

什么时候不该用 cpp-testing？

当你要做的是不涉及任何测试改动的功能实现、与测试无关的大范围重构，或者非 C++ 仓库时，都不要用它。cpp-testing guide 也不适合以性能调优为主、且没有测试失败、回归或正确性检查作为工作锚点的任务。

它比普通提示词更好吗？

通常是的，前提是目标是提升测试执行质量，而不只是生成代码。cpp-testing skill 会围绕隔离性、测试布局和 CTest 用法给出更明确的约束，这能减少 agent 在决定如何组织测试或如何复现失败时的猜测成本。

对新手友好吗？

可以，只要你能描述被测代码以及希望验证的行为。这个技能最有帮助的场景，是用户能提供一个具体示例、一个失败的测试名称，或者一个小的 CMake target；如果请求只有“把测试弄得更好”，它的帮助就会有限。

如何改进 cpp-testing 技能

提供更精确的输入

想让 cpp-testing 的输出更好，最有效的方法就是一开始就给出准确的目标、期望行为和约束条件。好的输入会明确写出类或函数名、需要哪种测试，以及诸如“不能联网”“不能 sleep”“必须通过 CTest 运行”或“测试必须保持 hermetic”之类的硬限制。

要求最小可验证改动

当你要求范围足够窄的第一轮结果时，cpp-testing skill 效果最好：一个失败测试、一个 bug 修复、一次 sanitizer 运行，或者一串可直接用于 CI 的命令。这样能产出更清晰的 diff，也能降低测试框架被过度设计的风险。

注意常见失败模式

最常见的失败模式是过度 mock、隐藏的共享状态，以及本地能过、但在 CTest 或 CI 中失败的测试。如果第一次结果不理想，就通过补充真实的测试入口、当前 fixture 设置，以及实际观察到的失败输出来迭代，这样技能就能基于证据而不是假设来推理。

首轮结果出来后继续迭代

用第一次结果来收窄或调整范围：如果测试太脆，就要求更隔离的 fixture；如果覆盖太浅，就要求补边界条件或回归覆盖；如果太慢，就要求先跑子集的执行方案。对于 cpp-testing for Test Automation 来说，这种迭代循环往往正是质量提升最大的地方。