Agent Skills
› dartsim/dart
dartsim/dart
GitHub提供只读代码库分析能力，通过构建证据集、区分事实与推论，在不修改文件的前提下回答技术问题或评估风险。
Install All Skills
npx skills add dartsim/dart --all -g -y
Skills in Collection (81)
Showing top 50 of 81 by quality score. Use the install list command or open individual skills for the rest.
提供只读代码库分析能力，通过构建证据集、区分事实与推论，在不修改文件的前提下回答技术问题或评估风险。
需要只读分析代码库时
查询代码状态而不执行修改时
npx skills add dartsim/dart --skill dart-analyze -g -y
提供DART 7多物理场仿真架构的全局视图，涵盖World、Solver、Domain及Backend抽象。用于指导多求解器集成、计算后端配置及架构合规性检查，确保新算法通过标准流程接入。
需要理解DART 7仿真核心组件关系
开发新的物理求解器或计算后端
审查代码是否符合多物理场架构设计
npx skills add dartsim/dart --skill dart-architecture -g -y
审计并修复Agent遗漏或无法发现的文档规则。通过定位规则、诊断遗漏原因（如位置隐蔽、重复等），优化文档结构与可见性，并结合自动化检查降低违规复发风险。
Agent未遵循已记录的规则
发现文档规则未被有效执行或发现
npx skills add dartsim/dart --skill dart-audit-agent-compliance -g -y
自动化将已合并至main的PR或提交反向移植到发布分支。包含验证状态、冲突解决、运行检查及生成Changelog等完整流程，确保代码正确同步至目标版本。
需要将main分支的代码变更同步到发布分支
执行反向移植工作流以准备新版本
npx skills add dartsim/dart --skill dart-backport-pr -g -y
用于生成或更新DART基准测试证据包。通过识别计划、构建并运行基准测试、生成机器证据、验证数据包完整性，确保测量结果的稳定性和可追溯性，为开发流程提供性能评估依据。
需要创建新的基准测试证据包
需要刷新或更新现有的基准测试数据包
npx skills add dartsim/dart --skill dart-benchmark-packet -g -y
用于分析和清理 Git 仓库中陈旧分支的自动化技能。支持只读分析模式及需人工确认的删除操作，处理远程同步、工作树检查及合并状态验证，确保分支清理安全合规。
需要清理过期的 Git 分支
检查仓库中的冗余分支
维护代码库整洁度
npx skills add dartsim/dart --skill dart-branch-cleanup -g -y
提供DART项目的构建系统支持，涵盖CMake配置、Pixi依赖管理及构建排错。包含常用命令、常见问题解决方案、CUDA环境注意事项及关键文件指引，协助开发者高效完成编译与测试任务。
用户请求构建或编译项目
遇到CMake或依赖相关错误
需要运行测试或格式化代码
配置CUDA构建环境
npx skills add dartsim/dart --skill dart-build -g -y
用于管理DART项目的变更日志工作流，支持决定是否需要条目、起草、定稿及审计功能，确保发布说明的准确性和规范性。
需要确定当前变更是否需记录在CHANGELOG中
为即将发布的PR起草或修订变更日志条目
在PR合并后添加链接并定稿条目
审计发布章节或PR集合以查找遗漏或错误条目
npx skills add dartsim/dart --skill dart-changelog -g -y
用于调试DART项目的CI/CD失败，特别是GitHub Actions中的平台特定问题（如FreeBSD、macOS ARM64）和CUDA构建。提供监控PR检查、查看运行日志及重试失败的命令，并列出常见故障的解决方案。
调试CI流水线失败
排查GitHub Actions错误
处理跨平台构建兼容性问题
npx skills add dartsim/dart --skill dart-ci -g -y
用于在 GitHub 上处理 Issue 关闭流程，包括检查问题状态、验证修复情况并起草关闭消息。仅在获得明确授权后执行评论和关闭操作，确保流程规范且安全。
用户请求关闭特定的 GitHub Issue
需要为已修复或无效的问题撰写关闭说明
npx skills add dartsim/dart --skill dart-close-issue -g -y
提供DART项目的代码贡献工作流指南，涵盖分支命名规范、PR创建流程、代码检查及PR描述撰写标准，适用于新功能开发、Bug修复和重构等场景。
需要向DART项目提交代码或PR时
询问DART项目的分支命名或PR流程规范时
npx skills add dartsim/dart --skill dart-contribute -g -y
自动化处理依赖和机器人PR，包括审查Diff、验证CI状态及在获得明确批准后合并PR。
需要审查Dependabot或GitHub Actions的PR时
需要合并经过验证的自动化依赖更新PR时
npx skills add dartsim/dart --skill dart-deps -g -y
用于更新DART项目文档及AI指令可见性的工作流，仅修改文档和AI源文件，不涉及代码变更。包含分支创建、内容编辑、索引更新、lint检查及PR准备等标准化步骤。
需要更新项目文档
调整AI指令或技能说明
同步AI命令配置
npx skills add dartsim/dart --skill dart-docs-update -g -y
用于修复Gazebo等下游项目反馈的DART库缺陷，涵盖崩溃、NaN及性能回归等问题。通过复现分析、最小化修复、回归测试及双分支PR流程，确保代码质量与兼容性。
收到Gazebo或gz-physics报告的DART相关Bug
需要定位并修复由DART行为引发的仿真崩溃或数值异常
npx skills add dartsim/dart --skill dart-downstream-fix -g -y
用于在DART工作流中执行指定或自动选择的开发任务包。支持按ID执行、选择计划首个可用包或自动扫描，并严格校验依赖、本地及远程状态以确保任务并发安全与可用性。
用户请求执行特定工作包
需要自动发现并执行下一个可用任务
npx skills add dartsim/dart --skill dart-execute-packet -g -y
用于调试和修复CI检查失败的技能。通过定位分支、分析日志、本地复现及最小化修复，解决构建或测试问题，并支持release分支的cherry-pick与合规发布流程。
CI构建或测试失败
需要修复PR中的流水线错误
npx skills add dartsim/dart --skill dart-fix-ci -g -y
自动化修复 GitHub Issue，包含问题验证、分支分类、代码修复、回归测试添加、Lint检查及双PR创建流程，确保DART项目质量。
用户请求修复特定的GitHub Issue
需要为Bug生成补丁和回归测试
npx skills add dartsim/dart --skill dart-fix-issue -g -y
用于加载和解析机器人模型文件（URDF、SDF、MJCF）的C++技能，支持格式自动检测与包路径解析。
需要读取机器人模型文件
处理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项目的机械重构工作流，保持行为不变的前提下进行代码结构优化。支持自动化编辑、分支管理、依赖更新及多层级验证（Lint/Build/Test），确保重构安全可控。
需要重构代码结构但不改变功能时
执行大规模重命名或文件重组任务时
npx skills add dartsim/dart --skill dart-mechanical-refactor -g -y
用于审计和升级DART AI基础设施的模型或编码代理，涵盖命名模型、推理模式迁移、兼容性审查及可视化仿真调试评估。
需要升级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准备模式，可调整任务规模与焦点，确保任务安全与上下文一致性。
用户请求执行下一个开发任务
需要自动选择待办事项并运行
准备代码变更并提交PR
npx skills add dartsim/dart --skill dart-next -g -y
用于讨论或更新DART项目的动态计划。支持需求分类、基于证据的状态检查、计划修订及任务拆解，确保文档一致性与优先级管理。
用户要求讨论DART计划选项或优先级
用户要求编辑或更新DART计划文档
用户希望从计划项派生具体实现任务
npx skills add dartsim/dart --skill dart-plan-update -g -y
自动化执行 DART 项目的 Pull Request 工作流，包括创建分支、提交代码、推送及发起 PR。指导 Agent 遵循项目规范撰写标题和正文，参考近期合并的 PR 风格，确保符合模板要求并包含必要的测试证据与变更说明。
用户请求创建或提交 Pull Request
需要按照 DART 项目规范生成 PR 内容
npx skills add dartsim/dart --skill dart-pr -g -y
提供DART Python绑定(dartpy)的开发指南，涵盖构建、测试、轮子打包及API规范。指导处理模型加载、仿真步进等场景，并集成验证技能以确保正确性。
需要构建或调试dartpy Python绑定
生成Python类型存根或构建wheel包
使用pixi管理DART Python开发环境
npx skills add dartsim/dart --skill dart-python -g -y
管理DART实验仿真世界的研究参考目录，支持添加、更新和审计论文、教材及引擎引用。提供标准化条目结构与工作流，确保引用准确并关联设计文档或代码实现。
需要添加新的研究参考文献时
更新现有文献的状态或结论时
审计研究引用的一致性与准确性时
npx skills add dartsim/dart --skill dart-references -g -y
自动化将DART活跃发布分支合并回main分支的工作流，包括分支检测、冲突解决、代码检查及PR创建。
需要将发布分支合并到主分支
执行DART版本发布流程
npx skills add dartsim/dart --skill dart-release-merge-main -g -y
自动化 Dart 项目版本发布流程，包括版本升级、Changelog 生成及 PR 创建。
需要为 Dart 项目创建新版本
执行发布前的打包和文档更新
npx skills add dartsim/dart --skill dart-release-packaging -g -y
DART Resume技能用于恢复并持续完成未结工作。它作为面向完成的任务管理器，支持重建执行计划、拆分可验证任务包、基于证据决策及全量交付，默认不限制为单步操作，仅在用户明确请求时使用子代理。
用户希望继续之前的未完成开发任务
需要批量或完整交付某个开发任务而非仅查看状态
npx skills add dartsim/dart --skill dart-resume -g -y
用于运行DART回顾工作流，捕获持久化经验教训。通过审查现有文档、盘点工作内容并评估学习价值，将关键洞察路由至对应文档或AI组件，确保知识沉淀与可发现性。
项目迭代结束后的复盘总结
需要沉淀技术决策或流程改进经验时
npx skills add dartsim/dart --skill dart-retro -g -y
用于执行 Dart 项目的 PR 代码审查及回复反馈工作流。支持检查代码风格、测试和文档，自动处理本地修复、合并分支并监控 CI 状态，确保代码质量与合规性。
需要审查 Pull Request 的代码变更
需要针对 Review 意见进行代码修改或回复
npx skills add dartsim/dart --skill dart-review-pr -g -y
DART项目测试技能，涵盖单元测试、集成测试编写与调试。提供Pixi命令执行快速及全量验证，指导GoogleTest规范使用，支持CI流程校验、CUDA环境测试及失败日志排查，并集成仿真可视化端到端检查。
编写或调试DART项目测试用例
运行单元测试或集成测试
排查CI/CD构建失败原因
验证PR提交前的代码质量
npx skills add dartsim/dart --skill dart-test -g -y
用于GitHub Issue的自动化分类与初步诊断。通过检查Issue状态、复现问题或验证代码路径，判断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场景和物理仿真的技能，强调以文本指标为首要依据、图像为辅的审查流程。适用于调试碰撞、动力学及渲染问题，指导Agent结合无头渲染与语义检查确保仿真正确性。
验证DART物理仿真结果
调试3D场景碰撞或动力学缺陷
审查仿真GUI输出或渲染效果
npx skills add dartsim/dart --skill dart-verify-sim -g -y
提供DART 7仿真架构全景，涵盖World、求解器、物理域及后端执行机制。用于指导多物理场仿真开发，确保代码符合设计契约与所有权规范，避免偏离既定架构。
需要理解DART 7整体架构时
开发或修改求解器/物理域/计算后端时
查阅仿真组件所有权映射时
npx skills add dartsim/dart --skill dart-architecture -g -y
指导DART项目使用Pixi和CMake进行构建、配置及依赖管理，涵盖常见故障排查、CUDA支持说明及Lockfile规范。
构建失败
依赖缺失
CMake配置问题
CUDA编译错误
npx skills add dartsim/dart --skill dart-build -g -y
用于调试DART项目CI失败及GitHub Actions工作流。提供监控、查看日志、重跑任务等命令，涵盖格式化、覆盖率、多平台编译及CUDA验证等常见故障排查与解决方案。
CI构建或测试失败
需要查看或监控GitHub Actions运行状态
处理跨平台（如FreeBSD/macOS）编译错误
配置或修复CUDA相关CI流程
npx skills add dartsim/dart --skill dart-ci -g -y
指导向DART项目贡献代码的工作流，涵盖分支命名、PR创建流程、代码检查及PR描述规范。
需要为DART项目创建新功能或修复Bug
准备提交Pull Request进行代码审查
npx skills add dartsim/dart --skill dart-contribute -g -y
用于加载和解析机器人模型文件（URDF、SDF、MJCF）的C++ IO技能，支持格式自动检测与包路径解析。
需要解析URDF/SDF/MJCF格式的机器人模型
使用dart::io读取3D层级或碰撞几何数据
npx skills add dartsim/dart --skill dart-io -g -y
提供DART Python绑定的开发指南，涵盖构建、测试、类型存根生成及轮子打包流程。指导开发者处理模型加载、仿真步进等API交互模式，确保Python与C++底层的高效集成与正确调用。
需要构建或调试dartpy Python绑定
使用pixi管理DART Python依赖和运行测试
生成或修复Python类型存根
npx skills add dartsim/dart --skill dart-python -g -y
管理DART实验仿真世界的研究参考目录，包括论文、教材和引擎。支持添加、更新和审计条目，维护状态、优先级和裁决结果，确保引用准确并关联设计文档或代码。
需要添加新的研究参考文献
更新现有条目的状态或裁决
审计研究目录的完整性和准确性
npx skills add dartsim/dart --skill dart-references -g -y
用于编写、运行和调试DART项目的单元测试、集成测试及CI验证。涵盖GoogleTest规范、Pixi命令执行、CUDA环境测试及仿真可视化检查，辅助排查测试失败并指导PR提交前的完整校验流程。
需要编写或修改单元测试/集成测试
遇到测试失败需要调试
提交PR前进行CI验证
配置或运行带有CUDA支持的测试
npx skills add dartsim/dart --skill dart-test -g -y
用于验证DART 3D场景和物理模拟正确性的技能，通过文本指标优先、图像辅助的方式检测动力学、碰撞及几何缺陷。
验证DART物理模拟结果
调试3D场景动力学或碰撞问题
审查仿真输出与预期行为的一致性
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
