Agent Skills
› dartsim/dart
dartsim/dart
GitHub执行DART仓库证据分析工作流，严格只读模式。通过检查本地状态、构建证据集并区分事实与推论，提供带置信度的排名综合报告，绝不编辑文件或执行外部变更。
安装全部 Skills
npx skills add dartsim/dart --all -g -y
集合内 Skills (81)
按质量分展示前 50 个（共 81 个），完整列表请用安装命令预览或逐个打开详情。
执行DART仓库证据分析工作流，严格只读模式。通过检查本地状态、构建证据集并区分事实与推论，提供带置信度的排名综合报告，绝不编辑文件或执行外部变更。
需要分析代码库现状而不修改文件时
请求对特定子系统进行只读审查或问题排查时
npx skills add dartsim/dart --skill dart-analyze -g -y
提供DART 7多物理场、多求解器、多后端仿真架构概览。指导用户理解World、Solver、Coupler及Compute-Graph关系，引用关键文档以对齐设计与实现现状，规范新求解器引入流程。
需要理解DART 7整体架构时
开发或调试Solver/Physics Domain/Compute Backend时
查阅仿真引擎设计文档与实现差异时
npx skills add dartsim/dart --skill dart-architecture -g -y
用于审计和修复AI代理未能发现或遵守已记录规则的问题。通过定位缺失规则、诊断原因（如文档埋没或冲突），优化文档可见性并运行自动化验证，以降低违规复发风险。
AI代理未遵守已知规则
发现文档规则未被正确执行
npx skills add dartsim/dart --skill dart-audit-agent-compliance -g -y
用于将已合并到 main 分支的 PR 或提交向后移植到发布分支。验证源状态，检查重复变更，执行 cherry-pick，处理冲突，运行 lint 和测试，生成 changelog 并创建 PR。
需要将 main 分支的功能或修复同步到特定的发布版本分支
用户请求执行 dart-backport-pr 命令以自动化后向移植流程
npx skills add dartsim/dart --skill dart-backport-pr -g -y
用于生成或刷新DART基准测试证据包。识别所属计划，构建并运行基准测试以获取稳定测量数据，生成包含溯源信息的机器证据包，并使用指定检查器验证其有效性，确保符合计划约定的规范。
需要创建新的基准测试证据包时
需要更新或刷新现有基准测试证据包时
执行 /dart-benchmark-packet 命令时
npx skills add dartsim/dart --skill dart-benchmark-packet -g -y
用于分析或清理 DART 仓库中陈旧的 Git 分支。支持分析和行动两种模式，默认仅分析。流程包括获取远程分支、识别过期引用、比对合并状态及检查关联工作树，确保在用户明确授权前不执行删除操作，保障仓库安全。
需要清理过期的本地或远程 Git 分支
检查仓库中未被合并的陈旧分支
npx skills add dartsim/dart --skill dart-branch-cleanup -g -y
提供DART项目基于Pixi和CMake的构建、测试及排错指南。涵盖常用命令、CUDA配置、依赖管理及常见问题解决方案，并指导Filament GUI视觉检查与关键文件位置。
执行DART项目的编译或构建任务
排查CMake或Pixi相关的构建错误
配置或验证CUDA环境支持
npx skills add dartsim/dart --skill dart-build -g -y
用于管理DART项目的变更日志。支持决策、起草、定稿及审计模式，帮助判断是否需要记录变更、撰写条目或检查发布说明的完整性与准确性，确保符合规范。
需要决定变更日志条目
起草变更日志内容
定稿变更日志
审计变更日志
npx skills add dartsim/dart --skill dart-changelog -g -y
用于调试DART项目CI失败及GitHub Actions工作流。提供监控PR检查、查看运行详情、调试日志等CLI命令，涵盖格式化、代码覆盖率、跨平台（FreeBSD/macOS/Windows）常见故障解决方案，并说明CUDA Runner安全策略及各平台工作流架构。
CI构建或测试失败
需要排查GitHub Actions运行日志
处理特定平台（如macOS ARM64、FreeBSD）的编译错误
配置或理解CI工作流架构
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创建及LTS修复策略。包含lint/test命令使用、PR模板撰写规范（摘要优先、用户视角）、提交信息格式及已发布PR的更新维护方法。
用户请求向DART项目提交代码或创建PR
询问DART项目的分支命名规则或PR工作流
npx skills add dartsim/dart --skill dart-contribute -g -y
用于处理 DART 项目的依赖维护和机器人 PR。自动列出 Dependabot 和 GitHub Actions 的 PR，审查 Diff 并确认 CI 状态。默认只读，仅在明确批准后合并 PR，最后输出包含状态和建议的报表。
需要审查或合并 Dependabot 更新
需要检查锁文件变更 PR
自动化依赖管理任务
npx skills add dartsim/dart --skill dart-deps -g -y
用于更新 DART 项目的文档和 AI 指令可见性，不涉及代码变更。通过创建分支、编辑文档源文件、同步 AI 命令、验证分类与索引、运行 lint 检查及处理变更日志，最终在获得批准后提交 PR。
需要更新项目文档或 README
调整 AI 工作流指令的可见性或结构
维护文档信息架构与索引
npx skills add dartsim/dart --skill dart-docs-update -g -y
修复通过gz-physics或Gazebo报告的DART下游问题。针对崩溃、NaN传播等追溯至DART的行为缺陷，执行从复现分析到LTS分支及main分支最小化修复的完整工作流。
用户报告Gazebo或gz-physics中的崩溃或异常行为
需要修复由DART引起的仿真性能回归或数值错误
npx skills add dartsim/dart --skill dart-downstream-fix -g -y
在DART工作流中执行指定或自动选择的工作包。支持精确指定、按计划选取及自动扫描可用任务，并通过依赖检查、本地/远程标记及分支信号确保任务可用性，避免冲突与重复劳动。
用户请求执行特定的DART工作包（如WP-091.13）
用户请求从特定计划中选择首个可用任务
用户未指定参数，需要AI自动扫描并选择下一个待执行任务
npx skills add dartsim/dart --skill dart-execute-packet -g -y
用于调试和修复DART项目CI失败的自动化技能。通过定位失败检查、本地复现、最小化修复及分支管理，协助恢复CI绿色状态，支持release分支特殊处理。
CI构建或测试失败
需要修复PR中的CI检查错误
发布分支上的CI问题排查
npx skills add dartsim/dart --skill dart-fix-ci -g -y
用于在DART项目中修复GitHub Issue。通过验证问题、分类分支（LTS或main）、编写最小化修复代码及回归测试，执行lint和测试流程，并创建包含Changelog的双PR提交至目标分支。
用户请求修复特定的GitHub Issue
需要为DART项目创建包含回归测试的Bug修复PR
npx skills add dartsim/dart --skill dart-fix-issue -g -y
提供DART库中URDF、SDF和MJCF机器人模型文件的解析与加载功能。支持自动格式检测、包路径解析及指定格式读取，适用于ROS和Gazebo等场景下的机器人模型处理。
需要加载或解析机器人模型文件
使用URDF/SDF/MJCF格式构建仿真环境
npx skills add dartsim/dart --skill dart-io -g -y
管理 DART 拉取请求，包括 CI 监控、冲突解决、评论处理及元数据修正。支持 manage 和 merge 模式，在获得明确批准后自动推进 PR 至可合并状态或执行合并操作。
用户输入 manage <PR> 或 continue managing <PR>
需要处理 DART 项目的 CI 流程、代码审查反馈或合并前的验证工作
npx skills add dartsim/dart --skill dart-manage-pr -g -y
用于执行DART项目的机械重构工作流。该技能保持行为不变，通过定义范围、自动化编辑和严格验证（Lint/Build/Test）来优化代码结构，最终生成变更摘要并请求审批以提交PR。
用户需要重构DART代码库但不改变现有功能行为时
用户希望清理或重组代码结构以提升可维护性时
npx skills add dartsim/dart --skill dart-mechanical-refactor -g -y
用于审计和更新DART AI基础设施的模型或编码代理升级工作流。支持命名模型、推理模式迁移及兼容性审查，通过可视化模拟调试评估目标模型在3D物理仿真中的状态调查能力，确保最小化变更并维持安全与功能平衡。
需要升级DART系统的AI模型版本
评估新编码代理在3D物理仿真中的表现
进行AI基础设施的兼容性审查与迁移
npx skills add dartsim/dart --skill dart-model-upgrade -g -y
用于在DART项目中启动新功能、修复、重构等任务。涵盖解析目标、评估范围、分支管理、代码实现、验证测试及创建PR的全流程，支持根据任务类型自动选择基线分支并执行相应检查。
用户请求开始新的开发任务
需要创建功能或修复bug的工作流
调用 /dart-new-task 命令
npx skills add dartsim/dart --skill dart-new-task -g -y
用于在Codex中执行DART工作流，根据参数选择并运行下一个受限任务。支持select、execute、pr三种模式及size/focus等约束，通过检查本地状态和文档构建候选集，确保任务安全与优先级匹配。
用户请求选择或执行DART任务
调用/dart-next或$dart-next命令
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。支持通过参数配置PR内容，遵循项目规范撰写标题和正文，参考近期PR风格，并指导完成测试验证及Before/After对比说明。
用户需要为DART项目创建并提交Pull Request
用户希望自动化执行分支创建、代码提交和PR打开流程
npx skills add dartsim/dart --skill dart-pr -g -y
提供DART Python绑定(dartpy)的开发指南，涵盖模型加载、仿真步进及GUI渲染。包含快速启动代码、构建测试命令、轮子打包流程及关键编码规范（如snake_case命名和NumPy自动转换）。
使用dartpy进行Python开发
处理DART模型的加载与仿真
构建或调试DART Python绑定
npx skills add dartsim/dart --skill dart-python -g -y
管理DART实验仿真世界的研究参考目录（论文、教材、标准、引擎）。支持添加、更新和审计条目，规范引用格式与状态流转，确保参考文献与实际设计文档或代码关联。
添加新的研究参考文献
更新现有文献的状态或判决
审计参考文献目录的完整性
为算法或API设计查找理论依据
npx skills add dartsim/dart --skill dart-references -g -y
自动化将活跃发布分支合并回主分支。自动检测版本，执行合并并依据规范解决冲突，运行 lint 检查，在获得批准前不推送，最终创建 PR 并监控 CI 状态直至通过。
需要合并发布分支到 main
执行 DART 版本发布流程
npx skills add dartsim/dart --skill dart-release-merge-main -g -y
用于执行DART项目发布打包工作流。自动创建版本升级和变更日志PR，包括更新版本号、生成CHANGELOG、运行检查及提交PR，需人工审批后推送。
用户请求创建DART版本发布
调用/dart-release-packaging命令
npx skills add dartsim/dart --skill dart-release-packaging -g -y
用于恢复和完成未完成任务的技能。它作为面向完成的任务管理器，重建执行计划，拆分工作包，验证结果并持续执行直到任务彻底完成或遇到阻塞。
用户希望继续之前的中断工作
需要恢复并完整执行某个开发任务
npx skills add dartsim/dart --skill dart-resume -g -y
用于运行 DART 回顾工作流，捕获持久化经验教训。在满足跳过条件时停止，否则按步骤检索文档、盘点工作成果并决策是否更新共享 AI 基础设施文档。需遵守路由规则，优先修改现有文件，并在提交前运行 lint 及验证检查以确保质量。
需要总结本次开发会话中的关键经验教训
发现新的模式、陷阱或故障模式需要记录到文档中
工作流改进需求产生且具备持久化价值
npx skills add dartsim/dart --skill dart-retro -g -y
用于在Codex中执行DART项目的PR审查工作流。支持两种模式：默认review模式，检查代码风格、测试及3D结构证据；address feedback模式，本地修复反馈并遵循严格的安全与审批流程进行推送和CI监控。
用户需要审查Pull Request的代码质量
用户需要根据评论修复PR问题
npx skills add dartsim/dart --skill dart-review-pr -g -y
用于DART项目的测试编写、调试与CI验证。提供Pixi命令执行单元/集成测试，指导GoogleTest规范，涵盖CUDA环境配置及常见陷阱排查，并在涉及仿真时联动dart-verify-skill进行端到端检查。
编写或调试DART测试
运行单元测试或集成测试
解决CI验证失败
需要CUDA环境测试
npx skills add dartsim/dart --skill dart-test -g -y
用于对GitHub Issue进行初步分类和评估。通过检查Issue详情、验证在最新代码中的有效性，将其归类为有效、已修复等状态，并提供处理建议及回复草稿，辅助开发者高效管理问题。
需要分析GitHub Issue的处理优先级
判断Bug是否仍存在于最新版本中
生成Issue的分类结论和建议回复
npx skills add dartsim/dart --skill dart-triage-issue -g -y
启动团队规模或自主 DART 任务的工作流。支持项目文档集成、决策访谈及编排执行，通过参数控制模式（访谈/简报/恢复），自动加载上下文并处理会话状态。
需要启动大型或多步骤自主开发任务时
希望基于现有项目主页恢复中断的开发会话时
需要结合决策访谈来明确任务关键约束时
npx skills add dartsim/dart --skill dart-ultrawork -g -y
用于验证DART 3D场景及物理仿真的正确性。强调“文本优先，图像佐证”，通过指标、轨迹等文本证据判定状态，结合无头渲染图像进行视觉审查，避免仅依赖像素检查导致的静态缺陷漏检。
验证DART 3D场景或物理仿真正确性
调试动力学、碰撞或接触问题
审查GUI输出或渲染结果
npx skills add dartsim/dart --skill dart-verify-sim -g -y
提供DART 7多物理场、多求解器及多后端仿真架构的全局视图。指导开发者理解World、求解器域、耦合器与计算图的职责，明确设计目标与当前实现差异，指引查阅关键文档以遵循规范。
需要了解DART 7仿真系统整体架构时
处理World、求解器、物理域或计算后端相关任务时
查询多物理场或多后端仿真抽象层归属关系时
npx skills add dartsim/dart --skill dart-architecture -g -y
提供DART项目基于Pixi和CMake的构建、测试及故障排除指南，涵盖常用命令、CUDA配置注意事项、Lockfile管理规范及GUI可视化检查流程。
用户询问DART项目的构建或编译方法
遇到CMake配置失败或缺失依赖的问题
需要运行测试或代码格式化
涉及CUDA环境配置或GPU架构相关错误排查
处理pixi.lock文件变更
npx skills add dartsim/dart --skill dart-build -g -y
用于调试DART项目的CI/CD失败及GitHub Actions工作流。提供快速命令监控PR检查、查看运行详情和重试任务。涵盖格式化、Codecov、FreeBSD/macOS/CUDA等平台特定故障的解决方案，并说明GPU Runner的安全策略。
CI构建或测试失败
需要排查GitHub Actions日志
处理跨平台编译错误
CUDA环境配置问题
npx skills add dartsim/dart --skill dart-ci -g -y
指导DART项目代码贡献流程，涵盖分支命名、PR创建及双PR修复策略。强调从main或LTS分支发起，使用pixi进行 lint 和测试，遵循特定PR模板结构，并规范提交信息与历史维护方式。
需要向DART项目提交代码
询问DART贡献指南
处理DART项目的Pull Request
npx skills add dartsim/dart --skill dart-contribute -g -y
用于加载机器人模型文件（URDF、SDF、MJCF）及解析器。支持格式自动检测、包路径解析及强制指定格式，适用于ROS和Gazebo等场景的3D层级与碰撞几何处理。
需要解析或加载机器人模型文件
使用URDF、SDF或MJCF格式
涉及机器人3D层级、变换或碰撞几何的处理
npx skills add dartsim/dart --skill dart-io -g -y
提供DART Python绑定(dartpy)的开发指南，涵盖模型加载、动力学仿真及GUI渲染。包含快速启动代码、构建测试命令、轮子打包流程及命名规范，辅助Agent高效处理Python绑定相关任务。
需要加载或操作DART物理模型的Python脚本
进行dartpy绑定的开发与调试
构建或测试DART Python扩展包
npx skills add dartsim/dart --skill dart-python -g -y
用于管理DART实验仿真研究目录，涵盖论文、教材、标准和引擎。支持添加、更新和审计条目，依据特定模式记录状态、优先级和裁决，确保引用有据可查并关联设计文档或代码。
添加新的研究参考文献
更新现有条目的状态或裁决
审计研究目录一致性
为算法或API设计提供文献支撑
npx skills add dartsim/dart --skill dart-references -g -y
用于编写、调试DART测试及CI验证。涵盖单元测试、集成测试、CUDA环境支持及失败排查。指导遵循GoogleTest规范，并在涉及仿真或视觉检查时联动dart-verify-sim技能。
编写DART单元测试或集成测试
调试测试失败并查看CI日志
提交PR前的全量测试与Lint验证
处理依赖场景结构或仿真的视觉端到端检查
npx skills add dartsim/dart --skill dart-test -g -y
用于验证DART 3D场景及物理仿真的技能，强调以文本指标（轨迹、碰撞）为主判定正确性，图像为辅。适用于调试动力学、碰撞及GUI输出，确保通过无头渲染和语义检查发现几何穿透等缺陷，避免仅依赖像素判断。
验证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
