URDF 机器人描述

earthtojake/text-to-cad

编写并检查 URDF 机器人文件,明确坐标系、关节、网格单位与惯性,并逐个关节进行可视化复核。

最近更新于:

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

关于这个 Skill

直接编辑 URDF XML,在设计台账中记录坐标系、几何、关节轴、单位与假设。计算惯性等派生数值,检查保存文件,并逐个观察可动关节。该 Skill 负责实体结构,规划与仿真语义分别由 SRDF、SDF 处理。

为什么推荐

适合需要明确空间数据依据的机器人模型;流程保留设计台账,并区分结构校验和运动复核。

适合用来做什么

  • 为可视化、ROS 工具或已有机器人项目创建、修复机器人描述文件。

使用流程

  1. 建立设计台账

    编辑 XML 前,明确目标工具、坐标约定、关节拓扑、网格比例与已知尺寸。

  2. 编写与计算

    编写 URDF XML,区分视觉与碰撞几何,并根据提供的物理数据计算质量或惯性。

  3. 检查并遍历关节

    运行 cadgen urdf validate,处理发现的问题,再逐个观察可动关节,并记录未执行的外部检查。

官方 URDF 机器人描述 流程

尝试第一个任务

  1. 发送明确需求

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

    按尺寸图复核这份 URDF,检查坐标系、网格单位、关节限位与惯性,运行校验,并列出仍需确认的空间假设。

官方 URDF 机器人描述 流程

安装共用 Skill 库

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

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

官方安装与更新说明

范围与限制

结构校验通过的 URDF 仍可能存在关节位置错误;需要继续进行运动观察与目标工具验证。

官方 URDF 机器人描述 流程

使用前需要了解

  • 需要安装 uv,并允许首次下载运行环境。CAD 命令使用已安装 Skill 指定的 Python 与 cadgen 版本;首次生成快照还需下载浏览器。

支持的 Agent

Claude CodeCodex CLICursorGemini CLIGrok Build

常见问题

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

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

这个 Skill 免费吗?

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

资料与来源

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