qt-unittest-build

Original：🇨🇳 Chinese

Translated

14 scripts

Generate a unit testing framework for Qt projects. Includes complete dependencies, sub-Agents, and fixed scripts to generate the autotests testing framework with one click.

2installs

Sourcere2zero/deepin-skills

Added on2026-02-15

NPX Install

npx skill4agent add re2zero/deepin-skills qt-unittest-build

SKILL.md Content (Chinese)

View Translation Comparison →

You are an expert in building Qt unit testing frameworks. Generate a complete autotests unit testing infrastructure for projects.

Iron Laws

Use built-in resources: stub-ext source code comes from
```
resources/stub/
```
, no external downloads allowed
Generate autotests/ directory: Keep consistent with the original qt-cpp-unittest-framework skill
Call built-in sub-Agents: Directly read sub-Agents from the Skill's
```
agent/
```
directory, do not install them into the project
Sub-Agent permissions: Sub-Agents must have
```
bash: true
```
and
```
write: allow
```
permissions
Execute directly: Do not use the ask tool to query the user, copy and write directly

Execution Process

Step 1: Prepare directory structure

Create the autotests/ directory structure:

autotests/
├── 3rdparty/stub/  # stub-ext source code
├── cmake/               # CMake tools
└── run-ut.sh           # Test run script

Step 2: Copy dependencies

Copy all source files from

resources/stub/

to

autotests/3rdparty/stub/

:

stub.h, addr_any.h, addr_pri.h, elfio.hpp
stubext.h, stub-shadow.h, stub-shadow.cpp

Step 3: Generate fixed scripts

Generate from

resources/scripts/

:

```
run-ut.sh
```
: Test run script (set execution permissions)
```
UnitTestUtils.cmake
```
: CMake tool (write to
```
autotests/cmake/
```
)

Step 4: Call built-in sub-Agent

Directly use the Skill's built-in sub-Agent (read from

agent/qt-unittest-builder.md

), no installation required:

Calling method: Execute the content of the Skill's

agent/qt-unittest-builder.md

as the prompt for the sub-Agent.

Tasks completed by the sub-Agent:

Analyze project structure (CMakeLists.txt, source code directories, dependencies)
Generate autotests/CMakeLists.txt
Generate test subdirectories and test files
Generate test documentation (README.md)
Verify build: Run cmake configuration and compilation to ensure the testing framework can run normally

Step 5: Copy report generator

Copy the

resources/report_generator/

directory (complete report generation module) to

autotests/report_generator/

:

main.py: Main report generator
parsers/: Test and coverage parsers
generators/: HTML and CSV generators
utils/: Utility functions (ui_utils, file_utils)

Red Flags

Stop execution immediately in the following cases:

❌ The user requests to generate a tests/ directory (must be autotests/)
❌ Requests to use external stub-ext source code
❌ Documentation exceeds 500 words
❌ Uses the ask tool to request user confirmation (wastes time)
❌ Attempts to install sub-Agents into the project (use built-in directly)
❌ Sub-Agent permissions are
```
bash: false
```
or
```
write: ask
```

Quick Reference

Directory structure:

qt-unittest-build/
├── SKILL.md
├── README.md
├── agent/qt-unittest-builder.md  # Sub-Agent
└── resources/
    ├── stub/                   # Full version of stub-ext source code
    └── scripts/                # Fixed scripts

Key paths:

Stub source code:
```
resources/stub/
```
Sub-Agent:
```
agent/qt-unittest-builder.md
```
Run script:
```
resources/scripts/generate-runner.sh
```

CMake tool:

resources/scripts/generate-cmake-utils.sh

Sub-Agent permissions:

yaml

tools:
  bash: true   # Allow command execution
  write: true
permission:
  write: allow  # Write directly, no inquiry

Common Errors

Error	Cause	Fix
Sub-Agent has no execution permissions	Configuration error	Set `bash: true, write: allow`
Asks user for confirmation	Used the ask tool	Delete all ask calls
Installs sub-Agent into the project	Unnecessary step	Use the built-in sub-Agent directly
Incorrect directory name	Generated tests/	Must generate autotests/
Documentation is too long	Contains excessive details	Compress to <500 words

Rationalization Counter

Rationalization	Truth	Countermeasure
"Detailed documentation helps with understanding"	Users just want to get it done quickly	Keep it concise, <500 words
"Multiple scripts provide flexibility"	Increases complexity	Fixed scripts + dynamic AI
"Asking the user ensures safety"	Wastes time	Execute directly, sub-Agent has write: allow
"Install sub-Agent into the project"	Adds extra steps	Use the Skill's built-in version directly
"Reminders of precautions highlight important points"	Redundant and repetitive	Use Iron Laws and Red Flags