这个 Skill 能做什么，适合哪些场景？
这是 earthtojake/text-to-cad 仓库（共 13 个技能）中的 URDF 技能，专注于机器人描述文件的编写与验证。它把 URDF 工作当作受约束的运动学建模而非简单写 XML：要求先建立坐标系、关节、单位与假设台账，惯性张量等派生数值必须计算而非手写。所有文件用 cadgen urdf validate 校验，并通过本地 CAD Viewer 或快照逐关节目检。适合使用 RViz、Gazebo、MoveIt 或真实机器人驱动的开发者。
- 直接编写和编辑 .urdf XML 文件（不通过代码生成管道），文件顶部嵌入设计台账注释块
- 准备网格资产：每个 link 一个网格，按该 link 坐标系导出
- 用闭式公式或临时脚本计算惯性张量、质心、单位换算等派生数值
- 运行 cadgen urdf validate 一次性收集结构、树拓扑、关节语义、几何、网格引用、材料与惯性等所有问题
- 用 cadgen urdf snapshot 渲染 PNG，可用 --joint-values 摆姿
- 启动 CAD Viewer（cadgen viewer --detach）目检网格缩放、放置并逐个活动关节扫查
- 为 Gazebo/Ignition 仿真搭建机器人模型的机器人工程师
- 使用 robot_state_publisher/RViz 需要正确 link/joint 帧的 ROS 开发者
- 准备 MoveIt 集成前的 URDF 基础描述（语义组交给 SRDF 技能）
- 从 CAD/网格导出机器人 link，需要检查网格缩放与放置的机械工程师
- 接手已有 .urdf 文件需要调试帧约定或惯性数据的团队
- 只想从文字一键生成 3D 模型（STEP/STL）的用户——那是本仓库 CAD 技能的职责，不是本技能的
- 需要 MoveIt 规划组、IK 语义的用户——SKILL.md 明确让这类需求去找 SRDF 技能
- 没有 uv、也无法联网下载 cadgen 运行时的离线受限环境
如何安装这个 Skill？
- 遥测默认开启（收集使用统计与崩溃报告，含随机安装 ID），虽不发送文件内容且可关闭，但若在意请在安装后立即运行 uvx cadgen telemetry off 或设置 CADGEN_TELEMETRY=0。
- CAD Viewer 默认绑定 127.0.0.1 但完全无鉴权，本机任意进程可读取其打开目录下的文件并触发构建；请勿将 --host 改为非回环地址。
- 首次运行需通过 uvx 从 PyPI 下载 cadgen==0.7.20 及 headless 浏览器快照，中国大陆网络环境下可能不可达或缓慢；且 Windows 11 Smart App Control 开启时会阻止未签名的 OCP 原生模块导致所有 cadgen 命令失败。
- 该技能明确声明结构验证无法证明空间正确性（关节原点、轴符号、mesh scale、惯量），输出仍需按台账逐关节视觉复核；惯量数据若来源为假设密度则仅是占位值。
- 发布者未经验证，技能无独立版本号/变更日志，静态审查未执行任何命令，实际可用性存在不确定性。
- Shell / 命令行
- 网络访问
- 本地文件系统
uv (uvx)Python 3.13 via uvcadgen==0.7.20headless browser for snapshotsGit LFS for mesh repos
本技能是 text-to-cad 集合（13 个技能）的一员，随整个集合安装。推荐让代理自己装，或按宿主选择：
Claude Code
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojakeCodex
codex plugin marketplace add earthtojake/text-to-cad --ref latest
codex plugin add text-to-cad@earthtojakeCursor
git clone --depth 1 --branch latest https://github.com/earthtojake/text-to-cad ~/.cursor/plugins/local/text-to-cadGrok Build
grok plugin install earthtojake/text-to-cad@latest --trust
grok plugin enable text-to-cadGemini
gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update其他代理（Skills CLI）
npx skills add earthtojake/text-to-cad#latest前置条件：需要安装 uv；Windows 11 若开启 Smart App Control 会阻止 OCP 原生模块加载（README 建议关闭该功能或改用 WSL）。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 帮我为这个四轮机器人编写一个 URDF 文件，包含 link、joint、限位和惯性参数，并确保能通过校验
- 检查 my_robot.urdf 里的关节轴和坐标系是否有问题，修复后重新验证并给我看渲染快照
- 把这几个 link 的网格引用加到 URDF 里，检查缩放和放置是否正确，然后在 CAD Viewer 里逐个关节摆一下
- 计算这个 URDF 中各 link 的惯性张量和质心，别用手写的数，然后跑一次 strict 校验
技能由代理根据请求自动触发（当涉及 .urdf 文件的创建、编辑、检查或调试时）。工作流为：确认目标文件与消费方（RViz、Gazebo、MoveIt 等）→ 建立/阅读设计台账 → 准备网格 → 直接编写 URDF XML → 计算惯性等派生值 → cadgen urdf validate 校验 → 外部工具（如 check_urdf）与 Viewer 逐关节复核 → 报告剩余假设。关键命令：
cadgen urdf validate path/to/robot.urdf --strict
cadgen urdf validate path/to/robot.urdf --
cadgen urdf validate path/to/robot.urdf --packages robot_description=/path/to/pkg
cadgen urdf snapshot path/to/robot.urdf review.png--strict 把警告视为失败；-- 输出结构化问题列表（severity、code、XML 路径、hint）；--packages 可重复解析 package:// 网格 URI。快照用 --joint-values（JSON，单位为度）摆姿；网格通过 Git LFS 管理的仓库需先 git lfs checkout，否则快照会失败。
这个 Skill 有哪些优点和局限？
- 方法论严谨：设计台账、帧语义参考和'派生数值必须计算'的规则直接针对 URDF 最常见的出错点
- 校验器一次收集所有问题，覆盖 XML 结构、树拓扑、关节语义、几何、网格、材料与惯性，并支持 -- 供程序消费
- 快照与 Viewer 使用同一渲染运行时，看到即所得；未加载的 link 网格会使快照失败而不是静默省略
- MIT 许可，维护活跃（仓库有 CI 测试与文档站）
- 依赖链较重：uv、固定的 cadgen==0.7.20、Python 3.13、快照还需无头浏览器
- 校验只是护栏，不能证明空间正确性——放置错误的关节仍可能通过全部结构检查，需要人工 Viewer 扫查
- Windows 11 的 Smart App Control 会阻止 OCP 原生模块，需关闭该功能或用 WSL
- 默认开启遥测（不包含文件路径或提示词），介意者需手动用 uvx cadgen telemetry off 关闭
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| URDF 机器人描述技能 本页 | 57 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| SRDF 技能：MoveIt 规划语义描述 | 62 · 推荐 | ★ 19k | 1 天前 | MIT |
| text-to-cad SDF 技能 | 55 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| I4H 工作流环境创建 ✓ NVIDIA · 官方 | 50 · 谨慎使用 | ★ 3.5k | 3 天前 | Apache-2.0 |
| Isaac for Healthcare 数据集回放 ✓ NVIDIA · 官方 | 48 · 谨慎使用 | ★ 3.5k | 3 天前 | Apache-2.0 |
源材料明确区分了同仓库的姊妹技能：SRDF 技能负责 MoveIt 规划组与 IK/路径规划语义，CAD 技能负责 STEP/STL/3MF/DXF/GLB 输出，SDF 技能负责仿真模型与世界文件。本技能只做 URDF 描述文件本身。
FollowSkills 如何评估这个 Skill？
证据显示整体数据流透明：遥测默认开启但有详细披露与多种关闭方式（cadgen telemetry off、DO_NOT_TRACK、CADGEN_TELEMETRY=0），并声明不发送文件名/路径/内容；查看器仅绑定 127.0.0.1 且 SECURITY.md 明确其为信任边界。扣分项：遥测默认开启而非默认关闭；查看器无鉴权（本地任意进程可读文件）；运行时通过 uvx 从 PyPI 拉取固定版本 cadgen==0.7.20 并下载 headless 浏览器快照，供应链依赖外部来源且无锁文件哈希；未验证发布者身份；无显式用户确认或回滚机制。
文档自洽度高：工作流、命令、失败模式（Git LFS 未 hydrate、Smart App Control 阻止 OCP、viewer 启动失败、快照无法加载 mesh 即失败）均有明确说明，验证器行为（--strict、--、退出码非零）描述完整。扣分项：静态审查无法执行关键路径；首次运行依赖网络下载 PyPI 包与浏览器快照，离线首跑不可行；references 虽完整但无针对 URDF 技能自身的可复现测试证据；也未运行 cadgen doctor 验证安装一致性。
触发条件明确（frontmatter description 精确列出 .urdf 创建/编辑/校验/调试场景），目标消费者（RViz、Gazebo、MoveIt、真实驱动）与非适用范围（SRDF/CAD 技能边界、floating/planar 接头）声明清楚，验证边界（验证器无法证明空间正确性）坦率披露。扣分项：无中文支持声明；核心运行依赖 uvx/PyPI 首次下载，在中国大陆网络环境下可能不可达或缓慢；对宿主工具（cad_show）的可用性依赖有条件说明但环境适配证据有限。
信息架构分层优秀：SKILL.md + 7 个 references 渐进披露，包含 golden skeleton 示例、设计台账模板、假设记录规范；MIT 许可证与来源链接明确；cadgen==0.7.20 版本固定并配套 cadgen doctor 防漂移；README 提供更新/重装路径。扣分项：技能本身无独立版本号或变更日志；发布者未验证，维护责任仅凭仓库链接推断；遥测与 Smart App Control 等关键限制分散在共享 README 而非技能文档内。
声称产出为可直接使用的 .urdf 文件（作为唯一事实来源），配合验证器、check_urdf、viewer 扫掠形成质量闭环，相对手写 URDF 有明确的边际价值（惯性公式、mesh scale、frame 语义清单）。扣分项：静态审查未验证代表性输出是否直接可用；验证器与 viewer sweep 需安装并首次联网下载；'验证通过不等于空间正确' 本身即承认输出仍需人工/视觉复核，完整交付依赖多步人工参与。
仓库内存在测试工作流徽章与测试模型目录（models/tests/），声明 CI 覆盖。扣分项：提供的测试夹具针对 viewer/渲染而非 URDF 技能关键路径；本次静态审查无法复现执行；外部工具（check_urdf）仅为'可用时'的条件路径；来源仅为单一仓库，无第三方独立佐证，因此未达到可验证性上限。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →