SDF 仿真模型与世界

earthtojake/text-to-cad

编写并检查 SDFormat 模型和世界文件,明确坐标系、物理、传感器与仿真交接检查。

最近更新于:

所属合集text-to-cad ↗
查看 GitHub 项目
npx skills add earthtojake/text-to-cad#latest
26,122Stars2,482Forks仓库最近推送

关于这个 Skill

直接编写模型或世界的 SDF XML,用设计台账明确姿态、轴、资源与单位。检查保存文件,环境可用时调用 Gazebo 校验,并验证目标环境的传感器与插件。这里的 SDF 指 SDFormat。

为什么推荐

适合需要在指定仿真器中加载机器人或世界的任务,流程分别记录文件校验、查看器复核与仿真器启动。

适合用来做什么

  • 创建或修复坐标系和资源引用清晰的 Gazebo 模型或世界。

使用流程

  1. 明确目标仿真器

    记录仿真器版本、文档类型、资源路径与坐标约定。

  2. 明确坐标系并编写

    在 XML 中明确 relative_to、expressed_in,引入计算得到的惯性并使用 SI 单位。

  3. 检查并加载

    运行 cadgen sdf validate;环境可用时执行 gz sdf --check 和仿真启动,并记录每项跳过的检查。

官方 SDF 仿真模型与世界 流程

尝试第一个任务

  1. 发送明确需求

    提供真实输入文件,并将示例尺寸或设备条件替换为自己的要求。

    为 Gazebo 复核这个 SDF 模型,检查姿态坐标系、网格路径、惯性与传感器配置,运行校验,并报告实际执行了哪些仿真检查。

官方 SDF 仿真模型与世界 流程

安装共用 Skill 库

使用当前 Agent 的官方 text-to-cad 插件,或用下方 Skills CLI 安装完整目录。每个应用选择一种安装方式,然后重启。插件包含 CAD 服务;仅安装 Skills 时使用浏览器查看器。请保留入口配套的参考资料和脚本。

命令用途与使用时机
npx skills add earthtojake/text-to-cad#latest安装正式发布的 Skill 库;CLI 会询问目标 Agent 与安装范围。

官方安装与更新说明

范围与限制

查看器只渲染几何,不执行仿真插件,也不验证动力学;这些检查需在目标仿真器中完成。

官方 SDF 仿真模型与世界 流程

使用前需要了解

  • 需要 uv 与指定版本的 cadgen。目标 Gazebo/libsdformat、仿真器插件及网格资源用于相应运行检查。

支持的 Agent

Claude CodeCodex CLICursorGemini CLIGrok Build

常见问题

需要把它作为单独产品安装吗?

这是 text-to-cad 共用库中的一个任务入口。安装官方插件或完整 Skills 后,再按任务选择该流程。

这个 Skill 免费吗?

上游代码采用 MIT 许可证。Agent 服务、硬件、耗材和加工服务可能产生各自的费用。

资料与来源

原始资料见下方链接;文中的上手建议由 SkillHey 编辑整理。