| name | build |
| description | Orchestrate build workflows. Environment setup, compilation, and testing. |
/build
Build orchestration for Python, C++/CUDA, and hybrid (scikit-build-core) projects.
Execution
.ai/bin/agent-build <setup|compile|test|full|doctor|clean>
Subcommands
| Subcommand | What it does |
|---|
setup | Create venv / install deps / configure toolchain |
compile | Compile C++/CUDA extensions (no-op for pure Python) |
test | Run test suite |
full | setup + compile + test |
doctor | Diagnose environment issues (missing tools, wrong versions) |
clean | Remove build artefacts (build/, dist/, __pycache__) |
Behaviour (guaranteed)
- Detects project type via
.ai/project.yml / heuristics.
- Python:
poetry install --with dev, then poetry run pytest.
- C++:
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo, cmake --build build -j, ctest --test-dir build --output-on-failure.
- Hybrid (scikit-build-core): direct CMake configure/build/test first, then
poetry run pip install -e . --no-build-isolation, then poetry run pytest tests/python.
Behaviour (best-effort)
- Mixed Python+C++ projects beyond scikit-build-core.
- Cross-compilation and parallel build flags.
- Tool installation guidance when compilers/tools are missing.
Common workflow
/build setup
/build compile
/build test
/build full
/build doctor