Agent Skills › dartsim/dart › dart-build

dart-build

GitHub

DART构建系统技能，提供CMake与Pixi环境配置、依赖管理及构建故障排查指南。涵盖快速命令、常见问题解决方案、CUDA支持及锁文件规范，辅助开发者高效完成编译与验证流程。

.claude/skills/dart-build/SKILL.md dartsim/dart

Trigger Scenarios

执行CMake配置或构建任务解决依赖缺失或编译链接错误处理Pixi环境或锁文件问题

Install

npx skills add dartsim/dart --skill dart-build -g -y

More Options

Non-standard path

npx skills add https://github.com/dartsim/dart/tree/main/.claude/skills/dart-build -g -y

Use without installing

npx skills use dartsim/dart@dart-build

指定 Agent (Claude Code)

npx skills add dartsim/dart --skill dart-build -a claude-code -g -y

安装 repo 全部 skill

npx skills add dartsim/dart --all -g -y

预览 repo 内 skill

npx skills add dartsim/dart --list

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; set DART_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.lock by hand. Change dependency constraints in pixi.toml, then run a Pixi command such as pixi install to let Pixi regenerate the lockfile.
If pixi.lock changes 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 with agent-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 the dartsim app, run pixi run dartsim and verify the requested interaction or behavior before ending the check. Then close any application you started solely for verification, unless the user asked to leave it running.

Key Files

pixi.toml - Package management
CMakeLists.txt - Build configuration
cmake/ - CMake modules

Version History

deb9869 Current 2026-09-08 21:46
bcd584e 2026-09-02 23:41
b9fbefc 2026-07-19 11:30
将构建配置命令从configure重命名为config；新增Filament GUI视觉检查及与dart-verify-sim技能协作的指引。
e0d13fd 2026-07-05 10:36