Qt Unit Test Generator

Overview

Core principle: 使用 LSP 精确分析类结构，生成 100% 函数覆盖率的测试用例，并强制验证构建成功。

架构模式: Skill 路由 + 子 Agent 全栈执行。子 Agent 负责所有具体工作，Skill 仅负责调用和结果反馈。

关键特性: 智能 CMake 合并、增量更新支持、严格的构建验证、详细的错误处理。

Iron Laws

1. 仅使用 Google Test: 测试框架固定为 GTest，不支持 Qt Test
2. 100% 函数覆盖率: 每个 public/protected 函数必须至少一个测试用例
3. 智能 CMake 合并: 根据项目实际情况优化合并，确保通用性
4. 支持增量更新: 对比现有测试，补全未覆盖函数
5. 必须验证构建: 生成后必须编译成功才能报告完成
6. 编译失败必须修正: 每个错误最多重试 3 次，最大循环 10 次

When to Use

触发条件:

• 用户请求为模块生成单元测试：为 src/lib/ui 模块创建单元测试
• 用户请求为类生成测试：为 MyClass 生成测试
• 用户请求补全测试：为 MyClass 补全测试

不使用此技能时:

• 用户请求生成测试框架（使用 qt-unittest-build）
• 用户请求修复测试失败（使用 systematic-debugging）
• 用户请求分析测试覆盖率（使用其他工具）

执行流程

步骤 1: 检查测试框架

验证 autotests/CMakeLists.txt 和 autotests/3rdparty/stub/ 存在。如不存在，提示用户先运行 qt-unittest-build。

步骤 2: 分析类结构

模块批量生成: glob 扫描目录所有 .h/.hpp，提取类名。

单个类: 直接分析指定类。

使用 LSP 工具：

• lsp_document_symbols – 提取类结构
• lsp_goto_definition – 读取函数实现
• lsp_find_references – 查找依赖

步骤 3: 调用子 Agent（MUST DO）

重要: 必须调用子 Agent，不能跳过！

子 Agent 位置: agent/unittest-generator.md

调用方式:

使用 task 工具调用子 Agent：

task(
    description="生成单元测试代码",
    prompt="完整的任务说明，包括：
- 目标模块或类
- 测试框架要求（Google Test）
- 函数覆盖率要求（100%）
- 验证构建要求",
    subagent_type="general"
)

为什么需要子 Agent:

• 独立上下文: 为单个类或小模块生成测试时，独立上下文避免污染
• 并行执行: 为多个类批量生成测试时，可以 fork 多个子 Agent 并行执行，提高效率
• 任务隔离: 子 Agent 失败不影响主 Agent，便于错误处理

调用时机:

• 模块批量生成: 为每个类调用一个子 Agent（并行）
• 单个类生成: 调用一个子 Agent
• 增量更新: 调用子 Agent 分析差异

步骤 4: 等待子 Agent 完成

监听子 Agent 的执行结果：

• 收集生成的测试文件
• 检查验证构建结果
• 记录遇到的错误（如果有）

步骤 5: 反馈用户

根据子 Agent 的结果反馈用户：

• 如果成功：报告生成的测试文件和覆盖率
• 如果失败：报告详细的错误信息和修正建议

Red Flags

• ❌ 使用 Qt Test 框架
• ❌ 覆盖率不足 100%
• ❌ 硬编码 CMake 模板
• ❌ 不验证构建
• ❌ 不支持增量更新
• ❌ 编译失败仍报告完成
• ❌ 跳过子 Agent 调用（直接手动工作）

Quick Reference

测试文件命名: test_myclass.cpp

测试类命名: MyClassTest

测试用例命名: {Feature}_{Scenario}_{ExpectedResult}

LSP 工具: lsp_document_symbols, lsp_goto_definition, lsp_find_references

Stub 模式: &Class::method, VADDR(Class, method), static_cast<...>

编译重试逻辑: 每个错误最多重试 3 次，最大循环 10 次

子 Agent 调用

必须使用 task 工具调用子 Agent:

task(
    description="生成单元测试代码",
    prompt="完整任务描述，包括目标、要求、验证流程",
    subagent_type="general"
)

子 Agent 执行内容:

• 分析项目结构（LSP）
• 生成测试文件（100% 覆盖率）
• 智能合并 CMake
• 验证构建（每个错误重试 3 次，最大循环 10 次）

为什么需要子 Agent:

• 独立上下文，防止污染
• 并行执行，提高效率
• 任务隔离，便于错误处理

常见错误

Rationalization Table