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、求解器、物理域及后端执行机制。用于指导多物理场模拟系统的开发、扩展与维护，确保遵循设计规范与所有权约束。
需要理解DART 7整体架构时
开发或修改求解器、物理域、计算后端时
查阅架构设计文档与实现差异时
npx skills add dartsim/dart --skill dart-architecture -g -y
用于审计和修复AI代理未遵循或发现文档化规则的问题。通过诊断遗漏原因、优化文档结构及可见性，并运行自动化验证流程，确保代理合规性并降低重复风险。
代理未遵守已记录的规则
代理无法发现相关文档指引
npx skills add dartsim/dart --skill dart-audit-agent-compliance -g -y
自动化将已合并到main的PR或提交回移植到发布分支，包括验证、cherry-pick、冲突解决、运行检查及生成PR。
需要将功能从主分支同步至发布版本
执行代码库的版本回移植操作
npx skills add dartsim/dart --skill dart-backport-pr -g -y
用于生成或刷新 DART 基准测试证据包。自动识别所属计划，执行基准测试并收集性能数据，随后生成包含来源和配置的证据文件，最后使用专用检查器验证数据包完整性以确保质量合规。
需要为某个开发计划提供基准测试性能证明时
现有基准测试数据包过期或需要重新采集数据时
运行 pixi run check-avbd-packets 发现数据包校验失败需修复时
npx skills add dartsim/dart --skill dart-benchmark-packet -g -y
用于分析和清理 Git 仓库中过时的分支。支持只读检查和需审批后的删除操作，自动处理工作树状态、合并关系及 SSH/HTTPS 兼容性问题，确保分支清理的安全性与准确性。
需要清理过时 Git 分支
检查仓库中的 stale branches
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项目变更日志的自动化工作流，支持决定是否需要记录、起草条目、最终化PR链接及审计发布内容，确保格式规范与证据充分。
需要判断变更是否需写入CHANGELOG.md时
需要起草或修订变更日志条目时
需要在PR合并后添加链接或审计发布章节时
npx skills add dartsim/dart --skill dart-changelog -g -y
提供DART项目CI/CD故障排查技能，涵盖GitHub Actions监控、日志查看、失败重试及常见构建问题解决方案。
调试CI流水线失败
查看GitHub Actions运行状态
解决跨平台编译错误
npx skills add dartsim/dart --skill dart-ci -g -y
用于在GitHub上查看Issue详情，验证修复状态并起草关闭消息。经用户确认后，自动发布评论并关闭Issue，提升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
用于自动化处理DART项目的依赖更新和Bot PR。通过列出、审查Diff及CI状态，对Dependabot或Action版本升级进行分级，并在用户明确批准后合并PR，最后输出报告。
需要审查依赖更新PR
需要处理自动化维护PR
npx skills add dartsim/dart --skill dart-deps -g -y
用于更新项目文档及AI指令可见性的工作流，支持代码外修改、分类归档、同步验证及PR创建。
需要更新项目文档内容
需要调整AI指令或技能的可见性
npx skills add dartsim/dart --skill dart-docs-update -g -y
修复通过gz-physics或Gazebo报告的DART下游问题，包括崩溃、NaN传播等。流程涵盖复现分析、最小化修复、回归测试及LTS与main分支的PR创建。
报告了由DART引起的下游软件（如Gazebo）崩溃或数值异常
需要定位并修复追溯至DART的行为缺陷
npx skills add dartsim/dart --skill dart-downstream-fix -g -y
用于执行DART工作包，支持指定ID、计划或自动选择。通过检查依赖、本地/远程标记及分支状态确保任务可用性，协调AI按序完成开发任务。
用户请求执行特定工作包
需要自动发现并执行下一个可用任务
npx skills add dartsim/dart --skill dart-execute-packet -g -y
用于调试和修复 CI 检查失败的自动化工作流。通过定位失败原因、本地复现、最小化修复并推动 CI 重新运行，解决代码提交引发的构建或测试问题，支持主分支与发布分支的不同处理策略。
CI 构建或测试失败
需要修复 Pull Request 中的检查错误
npx skills add dartsim/dart --skill dart-fix-ci -g -y
自动化修复GitHub Issue的工作流，包括验证问题、分类分支、编写最小化修复代码及回归测试、运行Lint和全量测试、生成Changelog，并针对Bug创建双PR以同步至LTS和主分支。
用户请求修复特定的GitHub Issue
需要为DART项目提交包含回归测试的代码修复
npx skills add dartsim/dart --skill dart-fix-issue -g -y
用于加载和解析机器人模型文件（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的CI状态
解决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模型或工具版本时
进行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计划文档时
npx skills add dartsim/dart --skill dart-plan-update -g -y
自动化执行DART项目的Pull Request工作流，包括创建分支、提交代码、推送及发起PR。遵循项目规范生成PR标题和描述，确保内容结构清晰且符合审查要求。
需要为DART项目创建并提交流程的PR
用户希望自动化完成代码提交到PR发起的全过程
npx skills add dartsim/dart --skill dart-pr -g -y
提供DART Python绑定(dartpy)的开发指南，涵盖构建、测试、类型存根生成及Wheel打包流程。指导处理C++与Python间的接口模式、数据转换及GUI渲染配置，辅助开发者高效集成和使用DART仿真库的Python接口。
需要构建或测试dartpy Python绑定
处理C++到Python的类型转换或API调用
生成或修复Python类型存根
打包DART Python Wheel分发包
npx skills add dartsim/dart --skill dart-python -g -y
管理DART实验仿真世界的研究参考目录，包括论文、教材和引擎。支持添加、更新条目及审计引用，确保引用真实有效并维护状态与优先级。
添加或更新研究文献引用
审计现有参考资料
为设计文档提供理论依据
npx skills add dartsim/dart --skill dart-references -g -y
自动化将活跃发布分支合并回main分支的发布流程，包括冲突解决、CI验证及PR创建。
需要将发布分支合并到主分支
执行DART版本发布流程
npx skills add dartsim/dart --skill dart-release-merge-main -g -y
自动化 Dart 项目发布流程，包括版本升级、变更日志生成及打包检查。通过创建 PR 并等待人工审批后合并，确保发布过程的规范性和可追溯性。
需要为 Dart 项目准备新版本发布
执行版本递增和更新 CHANGELOG
npx skills add dartsim/dart --skill dart-release-packaging -g -y
用于恢复并继续未完成开发任务的技能，支持构建执行计划、拆分工作包及验证结果，直至任务完整交付。
用户希望恢复上次中断的开发会话
需要继续处理未完成的特定任务或功能
npx skills add dartsim/dart --skill dart-resume -g -y
用于执行DART回顾流程，从已完成工作中提取持久性经验教训并更新相关文档。通过检查现有内容、分类发现的模式与失败模式，将通用知识归档至AI基础设施文档，避免冗余，确保未来Agent可复用这些洞察。
项目迭代或任务完成后进行复盘
需要沉淀AI工作流中的持久性经验教训
npx skills add dartsim/dart --skill dart-retro -g -y
用于执行DART项目的PR代码审查及反馈处理工作流。支持查看PR差异、检查代码风格与测试，并根据反馈进行本地修复和推送，确保符合项目规范。
需要审查Pull Request的代码变更
需要根据Review反馈修改并重新提交PR
npx skills add dartsim/dart --skill dart-review-pr -g -y
指导编写、运行和调试DART项目的单元测试与集成测试，涵盖Pixi命令执行、CI验证流程及失败排查，并包含CUDA环境下的特殊处理与仿真检查指引。
编写或调试测试代码
执行本地或CI测试
排查测试失败原因
npx skills add dartsim/dart --skill dart-test -g -y
用于GitHub Issue的自动化分类与分流。通过检查Issue有效性、复现问题，将其标记为有效、已修复、需更多信息等状态，并生成处理建议及回复文本，辅助开发者高效进行Issue Triage工作。
需要分析GitHub Issue状态
请求对Bug报告进行分类和下一步行动建议
npx skills add dartsim/dart --skill dart-triage-issue -g -y
用于启动团队级或自主DART任务的编排工作流。支持任务简报解析、决策访谈及多模式执行，遵循AI编排与验证原则，管理项目上下文并协调会话状态。
启动大型或自主开发任务
需要AI协助的任务分解与编排
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、求解器、后端及耦合机制设计。指导开发者理解系统抽象所有权，查阅架构地图与设计评估，确保新代码符合规范并遵循正确的集成流程。
需要了解DART 7整体架构时
开发或修改求解器/物理域/计算后端时
查阅架构设计与实现差异文档时
npx skills add dartsim/dart --skill dart-architecture -g -y
指导使用 Pixi 和 CMake 进行 DART 项目的构建、配置、测试及依赖管理，涵盖常见问题排查、CUDA 环境适配及锁文件规范。
DART 项目构建失败
CMake 配置问题
Pixi 依赖安装或锁定
CUDA 编译错误
npx skills add dartsim/dart --skill dart-build -g -y
用于调试 DART 项目的 CI/CD 失败问题，特别是 GitHub Actions。提供快速命令监控 PR 检查、查看运行详情及失败日志，并列出常见平台特定失败（如 FreeBSD RTTI、macOS SEGFAULT）的解决方案及工作流架构说明。
CI 构建或测试失败
需要排查 GitHub Actions 运行日志
处理跨平台兼容性问题
npx skills add dartsim/dart --skill dart-ci -g -y
指导向 DART 项目贡献代码的工作流，涵盖分支命名、PR 创建、代码检查及描述规范。
需要向 DART 仓库提交新功能或修复 Bug
需要发起或处理 Pull Request
npx skills add dartsim/dart --skill dart-contribute -g -y
用于加载和解析机器人模型文件（URDF、SDF、MJCF）的技能，提供自动格式检测、包路径解析及特定格式强制指定功能，支持ROS和Gazebo等场景。
需要解析URDF、SDF或MJCF格式的机器人模型文件
在C++代码中调用dart::io接口加载3D层级或碰撞几何数据
npx skills add dartsim/dart --skill dart-io -g -y
提供 dartpy Python 绑定开发指南，涵盖构建、测试、类型存根生成及轮子打包流程。指导处理模型加载、仿真步进及 GUI 渲染等 API 模式与最佳实践。
需要构建或调试 DART Python 绑定
处理 dartpy 的类型存根或 Wheel 打包
npx skills add dartsim/dart --skill dart-python -g -y
用于管理DART实验仿真世界的研究参考目录，包括论文、教材和引擎。支持添加、更新、审计条目，规范引用格式与状态追踪，确保学术依据与设计决策的关联。
添加新的研究参考文献
更新现有文献的状态或结论
审计研究目录的一致性
为设计文档提供学术引用
npx skills add dartsim/dart --skill dart-references -g -y
用于编写、运行和调试DART项目的单元测试及集成测试。提供快速执行命令、GoogleTest规范、CI验证流程及故障排查指南，并指导结合仿真可视化进行端到端检查。
编写单元测试或集成测试
调试测试失败
执行CI/CD验证
运行仿真可视化检查
npx skills add dartsim/dart --skill dart-test -g -y
用于验证DART 3D场景和物理仿真的正确性。通过文本指标（如轨迹、碰撞数据）优先判定，结合无头渲染图像进行视觉佐证，适用于调试动力学缺陷、审查几何穿透及性能基准测试。
验证DART物理仿真结果
调试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
