Agent Skills
› dartsim/dart
› dart-build
dart-build
GitHub提供DART项目的构建系统支持，涵盖CMake配置、pixi依赖管理及常见故障排查。包含快速命令、CUDA注意事项及锁文件管理规范，并新增Filament GUI可视化检查指引。
触发场景
需要编译或构建DART项目
解决CMake或pixi依赖问题
处理CUDA编译错误
检查Filament GUI渲染效果
安装
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
版本历史
- b9fbefc 当前 2026-07-19 11:29
