• 正文
  • 相关推荐
申请入驻 产业图谱

以AI生成gtest单元测试为例来理解skill

11/16 08:24
87
加入交流群
扫码加入
获取工程师必备礼包
参与热点资讯讨论

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实现在其它任务上的技能复用。

相关推荐

控制科学与工程硕士,日常分享单片机、嵌入式、C/C++、Linux等学习经验干货~