Agent Skills › dartsim/dart › dart-python

dart-python

GitHub

提供 dartpy Python 绑定开发指南，涵盖构建、测试、轮子打包及代码规范。指导使用 pixi 进行环境管理与 CI/CD 流程，集成类型存根生成与自动化测试，确保 C++ 到 Python 绑定的正确性与兼容性。

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

Trigger Scenarios

需要构建或调试 dartpy Python 绑定处理 C++ 到 Python 的接口转换执行 Python 扩展模块的测试与打包

Install

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

More Options

Non-standard path

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

Use without installing

npx skills use dartsim/dart@dart-python

指定 Agent (Claude Code)

npx skills add dartsim/dart --skill dart-python -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-python",
    "description": "DART Python: dartpy bindings, nanobind, wheels, and API patterns"
}

DART Python Bindings (dartpy)

Load this skill when working with Python bindings or dartpy.

When a binding exposes or changes 3D structure or behavior, also load dart-verify-sim: a focused Python text oracle plus an assessed claim-tied capture, or a recorded exception when rendering is unavailable.

Full Documentation

For complete Python bindings guide: docs/onboarding/python-bindings.md

For module-specific details: python/AGENTS.md

Quick Commands

pixi run build-py-dev    # Build for development
pixi run test-py         # Run Python tests
pixi run generate-stubs  # Generate type stubs

Wheel Building

pixi run -e py314-wheel wheel-build
pixi run -e py314-wheel wheel-repair  # Linux only
pixi run -e py314-wheel wheel-test

Key Patterns

snake_case preferred (camelCase emits DeprecationWarning)
NumPy arrays auto-convert to Eigen types
GUI requires DART_BUILD_GUI=ON

Key Files

Package config: pyproject.toml
Build system: python/dartpy/CMakeLists.txt
Type stubs: python/stubs/dartpy/

Version History

deb9869 Current 2026-09-08 21:46
整合 AI 使用指南并改进模型升级审计流程。
bcd584e 2026-09-02 23:41
简化了触发 dart-verify-sim 的场景描述，从具体的模型/场景加载等细节概括为更通用的“3D 结构或行为”。
b9fbefc 2026-07-19 11:30
升级AI基础设施并引入视觉验证(#3386)。新增建议：在涉及模型加载、物理仿真或可视化输出时，协同加载dart-verify-skill以进行断言关联的无头捕获和异常文档记录。
e0d13fd 2026-07-05 10:36