Agent Skills
› dartsim/dart
dartsim/dart
GitHub提供只读代码仓库分析能力，通过检查本地状态、构建证据集并区分事实与推断，在不修改文件的前提下回答技术问题。
安装全部 Skills
npx skills add dartsim/dart --all -g -y
集合内 Skills (81)
按质量分展示前 50 个（共 81 个），完整列表请用安装命令预览或逐个打开详情。
提供只读代码仓库分析能力，通过检查本地状态、构建证据集并区分事实与推断，在不修改文件的前提下回答技术问题。
需要分析代码库现状但不允许修改
要求基于证据进行技术推理或风险评估
npx skills add dartsim/dart --skill dart-analyze -g -y
提供DART 7多物理场、多求解器、多后端仿真架构的全局视图，指导Agent理解World、Solver、Coupler及Compute-Graph的设计与所有权归属。
需要理解DART 7整体架构设计时
处理求解器、物理域或计算后端相关任务时
查看架构文档映射关系时
npx skills add dartsim/dart --skill dart-architecture -g -y
用于审计和修复AI Agent未遵循或遗漏已记录规则的问题。通过定位规则、诊断遗漏原因并优化文档可见性，确保Agent行为符合既定规范，降低违规风险。
发现Agent行为与文档规则不符
需要检查Agent对规则的遵守情况
npx skills add dartsim/dart --skill dart-audit-agent-compliance -g -y
自动化将已合并到 main 的 PR 或提交回移植（Backport）到指定发布分支。包含冲突检查、变更日志生成及 CI 验证，确保版本一致性。
需要将 main 分支的修复或功能同步到旧版本发布分支
执行 Dart 项目的版本维护与发布流程
npx skills add dartsim/dart --skill dart-backport-pr -g -y
用于生成或刷新 DART 基准测试证据包。自动识别所属计划，执行构建与基准测试，生成包含溯源信息的证据文件，并使用专用检查器验证结果完整性，确保测量设置稳定且数据有效。
需要为特定计划创建新的基准测试证据包
需要更新或刷新现有的基准测试证据包
npx skills add dartsim/dart --skill dart-benchmark-packet -g -y
用于分析和清理 DART 仓库中过时的 Git 分支，支持只读检查和需审批的删除操作。
分析过时分支
清理仓库分支
npx skills add dartsim/dart --skill dart-branch-cleanup -g -y
提供DART项目的构建系统支持，涵盖CMake配置、Pixi依赖管理及常见构建故障排查。指导用户执行编译、测试、Lint及CUDA环境验证，确保构建流程顺利。
构建失败
依赖缺失
CMake配置问题
链接错误
CUDA编译异常
npx skills add dartsim/dart --skill dart-build -g -y
DART项目变更日志管理技能，支持决定是否需要条目、撰写草稿、最终确认及审计发布内容。
需要判断变更是否需记录到CHANGELOG.md时
撰写或修订变更日志条目时
为已发布的PR添加链接并确认条目时
审计发布章节中遗漏或冗余的条目时
npx skills add dartsim/dart --skill dart-changelog -g -y
用于调试 DART 项目的 CI/CD 失败问题，提供 GitHub Actions 监控、日志查看及特定平台（如 FreeBSD、macOS）的常见故障解决方案。
CI 构建或测试失败
需要排查 GitHub Actions 运行日志
处理跨平台编译异常
npx skills add dartsim/dart --skill dart-ci -g -y
用于处理 GitHub Issue 的关闭工作流。通过检查问题详情和验证修复状态，起草包含致谢和解决说明的关闭消息，并在获得明确授权后执行评论和关闭操作。
需要关闭 GitHub Issue
需要生成 Issue 关闭回复
npx skills add dartsim/dart --skill dart-close-issue -g -y
提供DART项目的代码贡献工作流指南，涵盖分支命名规范、PR创建流程、测试检查及PR描述撰写标准。
用户需要向DART项目提交代码或发起PR时
询问DART项目的开发规范和分支策略时
npx skills add dartsim/dart --skill dart-contribute -g -y
自动化处理依赖和Bot PR，包括审查Diff、验证CI状态及在批准后合并。
审查Dependabot或GitHub Actions的PR
批量处理锁文件更新
npx skills add dartsim/dart --skill dart-deps -g -y
用于更新项目文档和AI指令可见性的工作流，不涉及代码变更。支持编辑常规文档、AI源文件及索引，并处理同步、验证和Changelog决策。
需要更新项目文档时
需要修改或新增AI指令/技能说明时
npx skills add dartsim/dart --skill dart-docs-update -g -y
修复DART下游（如Gazebo）报告的Bug，包括崩溃、NaN/Inf传播等问题。通过定位根因、实施最小化修复并添加回归测试，确保在LTS和main分支的兼容性。
收到Gazebo或gz-physics等下游项目反馈的DART相关Bug
需要修复导致仿真崩溃、断言失败或性能回退的DART底层问题
npx skills add dartsim/dart --skill dart-downstream-fix -g -y
DART工作流技能，用于从编号计划中选择并执行工作任务包。支持指定ID、选择首个可用包或自动扫描，通过依赖、标记及Git信号检查可用性，确保任务安全分配与执行。
用户请求执行特定工作任务包
需要自动选择并运行下一个可用的开发任务
npx skills add dartsim/dart --skill dart-execute-packet -g -y
用于调试和修复 CI 检查失败的自动化流程。支持识别分支、分析日志、本地复现问题、执行最小化修复及推送代码，确保 CI 状态恢复绿色。
CI 检查失败需要修复
需要排查并解决持续集成中的构建或测试错误
npx skills add dartsim/dart --skill dart-fix-ci -g -y
用于修复 GitHub Issue 并添加回归测试的自动化工作流。支持验证问题、分类分支、执行最小化修复、运行 lint 和测试套件，处理双 PR 策略（LTS 与 main），生成变更日志及创建 Pull Request。
用户请求修复特定的 GitHub Issue
需要为 DART 项目提交包含回归测试的代码修复
npx skills add dartsim/dart --skill dart-fix-issue -g -y
提供DART库中URDF、SDF和MJCF机器人模型文件的解析与加载功能，支持ROS和Gazebo等格式的自动检测及包路径解析。
需要加载或解析机器人3D模型文件
处理URDF、SDF或MJCF格式数据
npx skills add dartsim/dart --skill dart-io -g -y
自动化管理DART项目的Pull Request，涵盖CI监控、冲突解决、审查评论处理及元数据修正，直至PR可合并或遇到阻塞。
用户请求管理指定的PR
需要推进PR状态至可合并阶段
npx skills add dartsim/dart --skill dart-manage-pr -g -y
执行DART项目的机械式重构工作流，保持行为不变进行代码结构优化。
需要重构代码结构
自动化代码格式化
npx skills add dartsim/dart --skill dart-mechanical-refactor -g -y
用于审计和升级DART AI基础设施的模型或编码代理工作流，涵盖模型迁移、兼容性审查及可视化仿真调试评估。
需要评估新AI模型对DART物理模拟器的适配性
执行AI基础设施的版本升级与兼容性检查
进行AI工具链的安全性与能力对等性审计
npx skills add dartsim/dart --skill dart-model-upgrade -g -y
用于启动DART项目的开发任务工作流，涵盖特性、修复、重构等类型。指导从理解需求、评估范围、分支管理到实现验证及提交PR的完整流程，确保代码规范与正确性。
需要创建新功能或模块
需要修复现有Bug
需要进行代码重构
需要编写或更新文档
npx skills add dartsim/dart --skill dart-new-task -g -y
用于自动选择并执行DART工作流中的下一个任务。支持按大小、焦点和模式约束筛选，检查本地状态后生成候选集，并根据指令执行开发或准备PR。
需要确定并执行下一个开发任务
根据特定约束（如大小、焦点）选择任务
自动化代码提交前的任务选择与验证
npx skills add dartsim/dart --skill dart-next -g -y
用于讨论或更新DART项目的活文档计划，包括需求分类、证据检查、计划修订及任务拆解，确保优先级与状态同步。
需要讨论DART项目计划选项、优先级或范围时
需要修订docs/plans目录下的计划文件或生成具体实现任务时
npx skills add dartsim/dart --skill dart-plan-update -g -y
用于在 DART 项目中自动化创建分支、提交代码并发起 Pull Request 的工作流。它指导 AI 遵循特定的 PR 模板和命名规范，参考近期合并的 PR 风格，确保代码提交的标准化和高质量。
用户请求创建或打开 DART 项目的 Pull Request
用户希望按照 DART 规范提交代码变更
npx skills add dartsim/dart --skill dart-pr -g -y
提供DART Python绑定(dartpy)的开发指南，涵盖CMake构建、nanobind封装、Wheel打包及API规范。指导开发者进行Python与C++库的交互开发，包括类型存根生成和测试流程。
需要构建或维护DART项目的Python绑定
处理dartpy相关的CMake配置或Wheel打包
编写涉及DART物理引擎的Python代码
npx skills add dartsim/dart --skill dart-python -g -y
管理DART实验仿真世界的研究参考文献目录，支持添加、更新和审计论文、教材及引擎引用，规范元数据与状态流转。
需要添加或更新仿真相关的研究文献记录
审计现有参考文献的完整性和准确性
查询特定算法或API的设计依据
npx skills add dartsim/dart --skill dart-references -g -y
自动化将活跃发布分支合并回 main 分支的 Skill。自动检测版本、创建合并分支、依据规范解决冲突、执行 lint 检查，并在获得批准后提交 PR 并监控 CI 状态，确保发布流程合规。
需要合并发布分支到主干
执行 DART 项目发布流程
npx skills add dartsim/dart --skill dart-release-merge-main -g -y
用于执行DART项目版本发布打包流程，包括创建版本分支、更新版本号、生成变更日志、运行检查并创建PR。
需要创建新版本发布
执行版本升级和变更日志整理
npx skills add dartsim/dart --skill dart-release-packaging -g -y
DART Resume 是一个面向完成的 AI 任务管理技能，用于恢复未完成的开发工作。它能构建执行计划、拆分任务包、基于证据验证结果并持续推进直至完成，支持子代理协作和多种参数控制。
用户要求继续或恢复之前的未完成开发任务
需要基于现有进度生成新的执行计划并自动化推进任务
npx skills add dartsim/dart --skill dart-resume -g -y
用于运行 DART 回顾工作流，捕获并沉淀持久化经验教训。通过审查现有文档、梳理工作成果及失败模式，将通用学习更新到 AI 基础设施文档中，避免重复记录，确保知识可发现且紧凑。
任务完成后需总结持久化经验
需要更新 AI 组件或流程文档
npx skills add dartsim/dart --skill dart-retro -g -y
用于审查代码提交请求或处理反馈。支持查看PR差异、检查代码规范与测试，并应用修复；强调安全流程，需人工审批方可推送更改或触发CI。
需要审查代码提交请求时
需要响应或修复PR中的评审意见时
npx skills add dartsim/dart --skill dart-review-pr -g -y
提供DART项目的测试编写、执行与调试指南，涵盖单元测试、集成测试及CI验证流程，支持Pixi命令与GoogleTest规范，并包含CUDA环境配置及仿真检查注意事项。
需要运行或编写DART项目测试时
排查测试失败或CI验证问题时
涉及CUDA环境下的测试执行
npx skills add dartsim/dart --skill dart-test -g -y
用于 GitHub Issue 的分类与初步排查。通过检查 Issue 内容、验证当前版本状态及复现行为，将其归类为有效、已修复等，并给出后续行动建议，辅助维护者高效处理问题。
用户要求对 GitHub Issue 进行分类或审查
需要判断 Bug 报告在当前代码库中是否依然有效
npx skills add dartsim/dart --skill dart-triage-issue -g -y
启动团队级或自主 DART 任务工作流，支持项目文档加载、决策访谈及编排执行。
需要启动大型或多阶段开发任务
配置自主代理执行复杂工作流
npx skills add dartsim/dart --skill dart-ultrawork -g -y
用于验证DART 3D场景和物理模拟正确性的技能，通过文本指标优先、图像辅助的方式检测动力学、碰撞及渲染问题。
验证3D场景或物理模拟的正确性
调试动力学、碰撞或接触逻辑
审查仿真输出与GUI渲染结果
npx skills add dartsim/dart --skill dart-verify-sim -g -y
提供DART 7多物理场仿真架构全景，解释World、Solver、Domain及Backend职责与交互。用于指导新求解器引入、理解系统分层及对齐设计与实现差异，确保遵循架构契约。
需要了解DART 7整体架构设计
工作涉及Simulation World或Solver开发
查询物理域或计算后端抽象
检查代码是否符合架构规范
npx skills add dartsim/dart --skill dart-architecture -g -y
DART项目构建技能，涵盖CMake配置、Pixi依赖管理及构建排错。提供常用命令、CUDA注意事项及锁文件管理规范，辅助解决编译链接问题。
执行DART项目的构建或配置操作
排查CMake或Pixi相关的构建失败错误
处理CUDA环境下的编译或测试问题
npx skills add dartsim/dart --skill dart-build -g -y
用于调试DART项目的CI/CD失败，特别是GitHub Actions工作流。提供快速命令监控PR检查、查看运行详情及调试日志，并列出格式化、Codecov、跨平台（FreeBSD/macOS）等常见故障的解决方案。
CI流水线失败
GitHub Actions调试
跨平台构建问题
npx skills add dartsim/dart --skill dart-ci -g -y
提供DART项目的代码贡献工作流指南，涵盖分支命名、PR创建、代码审查及双PR修复等规范。
需要向DART项目提交代码或发起PR
查询DART项目的分支和PR规范
npx skills add dartsim/dart --skill dart-contribute -g -y
用于加载和解析机器人模型文件（URDF、SDF、MJCF），支持格式自动检测与包路径解析，适用于ROS、Gazebo及MuJoCo模型的读取场景。
需要解析或加载机器人模型文件
处理URDF/SDF/MJCF格式的模型数据
npx skills add dartsim/dart --skill dart-io -g -y
提供 dartpy Python 绑定的开发指南，涵盖构建、测试、轮子打包及 API 使用模式。指导处理模型加载、仿真步进及 GUI 渲染等场景，并关联 dart-verify-sim 技能进行验证。
需要构建或测试 DART Python 绑定
使用 dartpy 进行机器人仿真开发
生成 Python 类型存根或打包 wheel
npx skills add dartsim/dart --skill dart-python -g -y
管理DART实验仿真世界的研究参考目录，支持添加、更新和审计论文、教材及引擎引用。提供标准化Schema与工作流，确保引用有据可查并维护状态优先级。
需要添加或更新DART相关研究文献时
审计现有参考资料准确性时
npx skills add dartsim/dart --skill dart-references -g -y
用于编写、运行和调试DART项目的单元测试、集成测试及CI验证。涵盖Pixi命令执行、GoogleTest规范、CUDA环境支持、故障排查及仿真可视化检查，确保代码质量与发布流程合规。
编写或调试测试用例
运行单元或集成测试
排查CI/CD构建失败
进行PR提交前的全量验证
npx skills add dartsim/dart --skill dart-test -g -y
用于验证DART 3D场景和物理仿真的正确性。通过文本指标（轨迹、碰撞）为主，图像检查为辅的方式，检测动力学、几何穿透及渲染问题，支持无头渲染与视觉审查。
验证3D场景加载正确性
调试物理仿真动力学或碰撞接触问题
审查GUI输出或渲染结果
基准测试仿真性能
npx skills add dartsim/dart --skill dart-verify-sim -g -y
用于在不修改代码的情况下分析仓库证据。遵循只读原则，通过检查本地状态、构建证据集并区分事实与推断，提供带置信度的排名综述，确保不执行文件编辑或外部变更。
用户请求分析仓库状态或代码逻辑
需要只读审查而不进行代码修改
npx skills add dartsim/dart --skill dart-analyze -g -y
提供DART 7多物理场、多求解器及多后端仿真架构概览。涵盖World、求解器域、耦合器与计算图核心概念，指导用户配置方法族而非底层实现，并引用权威文档说明设计现状与合规要求。
需要了解DART 7整体架构设计时
开发或调试多物理场/多求解器仿真逻辑时
查询求解器家族引入规范或架构状态评估时
npx skills add dartsim/dart --skill dart-architecture -g -y
用于审计并修复AI代理未能发现或遵守已记录规则的问题。通过定位规则、诊断遗漏原因（如文档隐蔽或冲突），优化文档结构与可见性，并运行自动化验证以确保合规性降低复发风险。
AI代理违反或遗漏了既定规则
需要审查Agent对文档规则的遵循情况
npx skills add dartsim/dart --skill dart-audit-agent-compliance -g -y
用于将已合并至 main 的 PR 或提交反向移植到发布分支。验证源状态，检查重复变更，处理 AI 工作流兼容性，执行 cherry-pick、冲突解决及 CI 检查，并生成 Changelog 决策后创建 PR。
需要将功能从 main 分支反向移植到特定发布版本分支
用户请求执行 dart-backport-pr 命令以自动化反向移植流程
npx skills add dartsim/dart --skill dart-backport-pr -g -y
用于在 Codex 中运行 DART 基准测试证据包工作流。通过定位所属计划、构建并运行基准测试、生成机器生成的证据包，并使用检查器验证数据包的有效性，以准备或刷新基准测试证据。
需要生成或更新 DART 基准测试证据包时
执行 /dart-benchmark-packet 命令时
npx skills add dartsim/dart --skill dart-benchmark-packet -g -y
