Agent Skills
› dartsim/dart
› dart-build
dart-build
GitHub指导DART项目的构建流程，涵盖CMake配置、Pixi依赖管理及常见错误排查。新增Filament GUI视觉检查指引及agent-capture协作建议，并更新构建命令为config。
Trigger Scenarios
DART项目构建失败
需要配置CMake或运行测试
处理Pixi依赖或锁文件问题
CUDA编译异常
验证Filament GUI渲染效果
Install
npx skills add dartsim/dart --skill dart-build -g -y
SKILL.md
Frontmatter
{
"name": "dart-build",
"description": "DART Build: CMake, pixi, dependencies, and build troubleshooting"
}
DART Build System
Load this skill when working with DART's build system.
Quick Commands
pixi run config # Configure CMake
pixi run build # Build
pixi run test # Run tests
pixi run test-all # Full validation (lint + build + tests)
pixi run -e cuda test-all # CUDA-enabled full validation on Linux CUDA hosts
pixi run lint # Format code
Full Documentation
For complete build instructions, read: docs/onboarding/building.md
For build system internals (CMake, dependencies): docs/onboarding/build-system.md
Common Issues
| Issue | Solution |
|---|---|
| CMake not found | pixi install |
| Missing dependency | Check pixi.toml |
| Build failure | pixi run config then pixi run build |
| Linking error | Check CMakeLists.txt in relevant module |
CUDA Notes
- On Linux hosts with visible NVIDIA GPUs, the CUDA Pixi config auto-detects
compute capabilities for
DART_CUDA_ARCHITECTURES; setDART_CUDA_ARCHITECTURES=<arch>only when overriding that detected list. - If CUDA runtime tests fail with unsupported PTX/toolchain errors, verify the generated CUDA flags include the local GPU architecture before assuming a kernel bug.
Pixi Lockfiles
- Do not edit
pixi.lockby hand. Change dependency constraints inpixi.toml, then run a Pixi command such aspixi installto let Pixi regenerate the lockfile. - If
pixi.lockchanges format or has broad solver churn, keep the generated output and call it out in the PR rather than attempting to splice lockfile entries manually.
Filament GUI Visual Checks
- For Filament GUI, scene, or simulation rendering changes, load
dart-verify-sim. Pair a text correctness oracle withagent-capture, view assessment, and claim-relevant engine debug layers; inspect the artifact and sidecar instead of relying only on command success. - If the user explicitly asks for
pixi run ex dartsim, also run that exact entry point and terminate it after confirming the GUI binary launches.
Key Files
pixi.toml- Package managementCMakeLists.txt- Build configurationcmake/- CMake modules
Version History
-
b9fbefc
Current 2026-07-19 11:30
将构建配置命令从configure重命名为config；新增Filament GUI视觉检查及与dart-verify-sim技能协作的指引。
- e0d13fd 2026-07-05 10:36
