1 什么是GoogleTest
GoogleTest(常简称 GTest)是 Google 开源的 C++ 单元测试框架,属于 xUnit 家族,跨平台、BSD 3-Clause 许可。
它把一个 C++ 测试拆成三件事:注册用例、断言、运行器收集结果
1.1 三种集成方式
| 方式 | 命令 / 写法 | 适用 |
|---|---|---|
| 系统静态库 + pkg-config | pkg-config --cflags --libs gtest_main,链接 -lgtest_main -lgtest -pthread |
机器已装 libgtest.a,离线可用,最省事(本篇采用) |
| CMake 已配置包 | find_package(GTest CONFIG REQUIRED) → GTest::gtest_main |
发行版或 vcpkg 提供 CMake config |
| CMake 官方推荐 | FetchContent(≥3.14)+ FetchContent_MakeAvailable(googletest) + gtest_discover_tests() |
允许联网、要求编译选项与宿主工程完全一致 |
1.2 一个简单的示例
#include <gtest/gtest.h>
int add(int a, int b) { return a + b; }
TEST(ArithmeticTest, AddTwoNumbers) {
EXPECT_EQ(add(1, 2), 3);
EXPECT_NE(add(1, 2), 4);
}
g++ -std=c++14 -pthread add_test.cpp -lgtest_main -lgtest -pthread -o add_test
./add_test
链接 gtest_main 时不要写自己的 main:库里已经有一份,它调 InitGoogleTest 再 RUN_ALL_TESTS()。
如果想了解更多google test的细节,github仓库:
2 让AI来写测试用例
单元测试用例手写比较繁琐,可以让AI来完成,这里使用WorkBuddy,比如可以让它:先从Google Test 官网搜索Google Test 的这个单元测试的使用方法,然后给它代码目录地址,让它编写Google Test 测试用例,不符合自己需求的地方,让它继续改
2.1 与AI对话
让它先学习学习
改好后,运行的效果,产物的格式,可继续修改
2.2 最后的效果
2.2.1 项目结构
我用于测试的项目结构是这样的:
xxpcb@xxpcb-ubuntu20:~/myTest/cpp/linux-cpp-useful-demo$ tree -L 2
.
├── 01-udpbrocast
│ ├── client.cpp
│ └── server.cpp
├── 02-unixsocket
│ ├── printUtil.h
│ └── test.cpp
├── 03-epolltest
│ ├── printUtil.h
│ └── test.cpp
├── GTest
│ ├── 01-udpbrocast
│ ├── 02-unixsocket
│ ├── 03-epolltest
│ ├── build
│ ├── coverage
│ ├── run_all_tests.sh
│ └── scripts
├── img
│ ├── 1.png
│ ├── 2.png
│ ├── 3.png
│ └── wxgzh.png
├── LICENSE
└── README.md
11 directories, 13 files
xxpcb@xxpcb-ubuntu20:~/myTest/cpp/linux-cpp-useful-demo$
有3个子目录,里面有cpp代码,GTest目录是此次让AI单独增加的单元测试目录。
项目代码想看的话,在这里:https://gitee.com/xxpcb/linux-cpp-useful-demo
2.2.2 运行测试用例
运行测试脚本,产生测试结果
2.2.3 查看测试报告
生成的html格式的报告:
还有一份xml报告,可用于CI(Continuous Integration,持续集成)
3 生成的skill
3.1 什么是skill
skill,技能,是一套结构化的可复用指令集,包含提示词、工具调用逻辑、模板和校验规则,封装成独立模块供 AI 按需调用。
与普通提示词的区别是:
- 提示词是一次性输入的文本指令,用完即止skill 是结构化的能力包,可多次复用和组合
在本例中,skill可以使单元测试的代码结构以及产物的格式符合自定义的规则,后续有相同格式需求的任务可复用该skill来完成任务。
3.2 skill的位置
让WorkBuddy把刚才的工作总结为skill,就会保存在WorkBuddy的默认skill目录:
具体结构是:
cpp-gtest-coverage/ ├── SKILL.md (必需) 元数据 + 使用说明 ├── scripts/ (可选) 可执行代码 │ ├── coverage_report.py 35 KB 报告生成器 │ └── run_case.sh 2.4 KB 单 case 执行引擎 ├── references/ (可选) 按需加载的参考文档 │ └── field_notes.md 27 KB 演进复盘与踩坑清单 └── assets/ (可选) 输出时使用的模板/资源 ├── run_all_tests.sh.tpl 6.4 KB 全量脚本模板 ├── one_case.sh.tpl 296 B 独立脚本模板 └── gitignore.tpl 660 B 忽略规则模板
SKILL.md 是唯一必需文件,其余三个目录都是可选的
3.3 SKILL.md
它分两部分:YAML frontmatter + Markdown 正文。
---
name: cpp-gtest-coverage
description: "为既有 C++ 项目添加 GoogleTest 单元测试、每个源文件独立运行脚本与全量运行脚本,并用 gcov + Python 标准库生成行/函数/分支覆盖率……适用于给 .cpp 文件补 gtest 用例、统计函数覆盖率、生成 HTML 覆盖率报告、Docker 与宿主机共用 bind mount 时避免 PermissionError……"
agent_created: true
---
| 字段 | 作用 | 规范要求 |
|---|---|---|
name |
唯一标识 | 必填,只含小写字母、数字、连字符;不能以连字符开头/结尾,不能连续两个连字符 |
description |
决定什么时候自动触发 | 必填,要写清"做什么+什么场景该用" |
agent_created |
标记是智能体创建的 | 必填 true,否则后续无法被技能管理工具修改或删除 |
description 是整个 Skill 里最该花时间的一句话:它常驻在上下文里,模型靠它判断这次任务要不要加载这个 Skill。
正文只放核心流程指令:目标与边界、先探测再动手、决策表、目录铁律、编译与覆盖率链路、清理参数、验收清单。
比如自定义的代码与产物结构,会在正文中规定:
详细的领域知识和复盘不放这里,交给 references/。
官方建议 SKILL.md 正文控制在 5k 词以内。
3.4 可选目录
| 目录 | 谁读 | 何时加载 | 会不会被执行 | 本 Skill 里的角色 |
|---|---|---|---|---|
scripts/ |
机器 | 需要确定性结果时直接调用,可以完全不进上下文 | 会,Python/Bash 等可执行代码 | 报告生成器、单 case 引擎;把每次都要重写一遍的代码固化下来 |
references/ |
模型 | 判断需要时才读进上下文 | 不会,纯文档 | field_notes.md:v1→v8 演进、gcov 原理、踩坑与验证清单 |
assets/ |
最终产物 | 不进上下文,被复制/修改后写进用户项目 | 不会,是素材 | 三个 *.tpl 模板、.gitignore 模板 |
3.4.1 scripts/ — 可执行代码
判定标准是:
这段代码是不是每次都要重写
结果是否需要确定性
好处有三:
- 省 token行为确定可以不读进上下文直接跑。
3.4.2 references/ — 按需加载的知识
数据库 schema、API 文档、详细工作流、复盘笔记都放这里。
上面这个文件就是与WorkBuddy的对话中,它自己的复盘笔记。
好处是让 SKILL.md 保持精简,只在需要时占用上下文。
3.4.3 assets/ — 用在输出里的文件
模板、图标、字体、样板工程、示例文档,会被复制或改写进用户项目,而不是给模型读。
Logo、PPT 模板、前端 boilerplate 都属这类。
这里用到的 gitignore.tpl 就是典型:Skill 自己不执行它,生成项目时把它落到 GTest/.gitignore 。
一句话概括:scripts/ 是能力,references/ 是知识,assets/ 是素材。
4 使用skill在其它任务上复用
比如另一个代码工程中,让AI使用刚才的skill,再次生成测试用例,可以看到用例的代码结构与报告的形式是一样的:
5 总结
本篇以AI实现GoogleTest单元测试为例,介绍了什么是skill,skill的结构,使用skill实现在其它任务上的技能复用。
87