AI Skills
cad

cad

热门

创建、修改、检查和验证以STEP为首要格式的参数化CAD零件和装配体。用于自然语言CAD规格、参考图像、2D技术图纸、STEP/STP生成或直接检查、Python CAD源代码、源代码级关节、选择器引用、几何事实、测量、配合偏差、快照，以及从CAD几何体生成的次要STL/3MF/原生GLB输出。

8204Star
939Fork
更新于 2026/7/11
获取 Skill源代码

相关 Skills

algorithmic-art15万frontend-ui-engineering7.7万brainstorming23万
SKILL.md
readonly只读
name
cad
description

创建、修改、检查和验证以STEP为首要格式的参数化CAD零件和装配体。用于自然语言CAD规格、参考图像、2D技术图纸、STEP/STP生成或直接检查、Python CAD源代码、源代码级关节、选择器引用、几何事实、测量、配合偏差、快照，以及从CAD几何体生成的次要STL/3MF/原生GLB输出。

CAD生成、检查与验证

来源：维护于 earthtojake/text-to-cad。
使用已安装的本地技能文件作为运行时真实来源；
仓库链接仅用于来源追溯和发布审查。

目的

根据自然语言需求创建或修改参数化CAD模型，生成经过验证的STEP/STP工件，检查几何引用，并返回经过检查的输出。将STEP作为主要CAD工件。将STL、3MF和原生GLB视为从STEP优先流程分支出来的次要导出工作流。对于装配体，优先使用 cadpy.assembly.AssemblyHelper，配合源代码级build123d关节、命名配合基准和原生标签（当零件具有功能装配关系时）。

进入STEP工作流有两种方式：从build123d Python源代码生成（默认方式，适用于从头设计或修改生成的模型），或直接导入现有的STEP/STP文件（当没有生成器或用户明确指定STEP文件时）。两者都会生成相同的可检查工件。

何时使用此技能

当用户要求CAD文件、STEP/STP文件、build123d源代码、选择器引用（如 #o1.2.f1）、机械零件、装配体、外壳、支架、夹具、孔、沉头孔、沉孔、槽、口袋、凸台、支座、肋条、圆角、倒角、壳、源代码级关节、配合或测量时，使用此技能。当用户提供要复制的参考图像或2D技术图纸时，也使用此技能。

当用户要求从CAD几何体输出STL、3MF或原生GLB时，也使用此技能。将这些工作流保持为次要，并加载 supported-exports.md 了解详情。对于2D DXF图纸，使用 $dxf 技能；当DXF从3D零件投影时，此技能拥有STEP几何体，而 $dxf 拥有图纸。

不要将此技能用于仅渲染的概念艺术、CAM刀具路径、工程认证、FEA结论、建筑BIM或手绘插图，除非用户同时需要CAD几何体。

默认假设

除非用户另有指定，否则使用以下默认值。这些是首次建模的默认值，并非可制造性、公差或认证声明：

  • 单位：毫米。
  • 原点：根据 references/positioning.md 中的零件类型默认值；当没有更好的选择时，位于主要零件或装配体的中心。
  • 基准平面：XY。
  • 向上/挤出轴：正Z。
  • 输出几何体：封闭的正实体，除非用户要求曲面或构造几何体。
  • STEP结构：一个有效实体、实体组合或带标签的装配体组合。
  • 装配体结构：固定根零件、零件局部坐标系、命名配合基准、由build123d关节支持的 AssemblyHelper 关系（适用时）、显式生成的放置和详细的本地标签。
  • 小型塑料外壳壁厚：未指定时为2.0-3.0毫米。
  • 装饰性圆角：在局部几何体安全的情况下为1.0-3.0毫米。
  • M3/M4/M5标准间隙孔：除非要求其他标准，否则为3.4/4.5/5.5毫米。

仅在缺少的信息导致模型无法创建、对配合至关重要、对安全至关重要或涉及合规性时，提出一个有针对性的澄清问题。否则，使用明确的假设继续。

工具和路径

从CAD技能目录中，启动器形式为：

python scripts/step ...      # STEP生成、GLB/拓扑工件、网格辅助文件
python scripts/inspect ...   # 引用、测量、对齐、坐标系、差异
python scripts/snapshot ...  # PNG/GIF视觉审查包

使用活动项目的Python解释器；将示例中的 python 视为解释器占位符。使用 python scripts/<tool> --help 获取完整的当前命令接口；参考文档显示推荐的工作流，而非所有标志。

目标路径从命令的当前工作目录解析，而非技能目录。从拥有工件的workspace运行命令，并传递相对于cwd的目标路径，以便项目CAD文件不会意外解析到技能目录下。除非用户明确要求，否则将STEP输出及其Python生成器放在同一目录中，并使用相同的基名。

CAD引用是目标本地的 #... 选择器令牌，例如 #o1.2 或 #o1.2.f1。使用CAD CLI时，将STEP/CAD文件作为单独的目标参数传递。

必需工作流

根据任务调整深度：简单零件需要简短说明和少量规格驱动的检查；装配体和配合关键工作需要完整的定位和对齐验证。

  1. 分类任务。 新零件、新装配体、源代码修改、直接STEP/STP检查、引用选择、测量/对齐检查、快照审查或次要输出请求。
  2. 仅加载所需的参考。 使用以下触发器，而非读取整个参考集。
  3. 编写自然语言CAD说明。 从所有提供的输入（散文、参考图像、技术图纸）中提取尺寸、单位、坐标约定、特征意图、输出路径、假设和验证目标。使用 references/cad-brief.md。
  4. 检查命名的可采购组件。 当装配体包含命名的现成执行器、伺服电机、电机、电子板、连接器或其他可采购组件时，在创建简化占位几何体之前搜索 $step-parts。如果未找到精确匹配，记录缺失，然后使用文档化的包络。
  5. 编码前规划。 在编辑前定义参数、意图标签、源路径、预期边界框以及任何配合/定位基准。
  6. 编辑源代码，而非生成的工件。 使用 gen_step() 编写build123d Python。当Python生成器存在时，对生成器运行 scripts/step，切勿对其导出的STEP运行。仅当没有生成器或用户明确将STEP/STP文件标识为目标时，才使用直接STEP/STP目标（--kind part|assembly）。
  7. 生成显式目标。 仅对显式目标运行 scripts/step；不要运行目录范围的生成。
  8. 几何验证。 运行 scripts/inspect refs <step-or-cad-target> --facts --planes --positioning 作为基线，然后通过有针对性的 measure、align、frame 或 diff 检查验证用户规格中要求的尺寸和关系。
  9. 对主要STEP进行快照——快照验证是强制性的。 在创建或明显更新主要STEP/STP零件或装配体后，始终对其运行CAD scripts/snapshot 并检查输出；确定性检查通过不是跳过的理由。唯一的跳过情况记录在 references/snapshot-review.md 中（没有可见几何体更改，或没有有效工件存在）；跳过时报告原因。
  10. 修复并重新运行。 如果检查失败，更改最小的责任源代码部分，重新生成，并重新运行失败的验证。

交接

在完成创建或修改 .step、.stp、.stl、.3mf 或原生 .glb 工件的CAD工作后，当 $cad-viewer 技能已安装时，必须始终将显式文件路径交给 $cad-viewer。$cad-viewer 必须启动CAD Viewer（如果尚未运行）并返回相关创建或更新文件的链接；在最终响应中包含这些实时查看器链接。如果 $cad-viewer 不可用或启动失败，报告该情况，并依赖CLI检查和快照，而不是静默省略交接。此规则适用于此技能中的每个工作流，包括次要STL/3MF/GLB输出。

当生成验证快照时，在最终响应中包含保存的PNG/GIF快照。如果没有适用的快照，或快照生成失败，说明原因并报告仍然运行的确定性验证。

不可协商项

  • 保持STEP作为主要验证的CAD工件。生成的STEP/STP、STL、3MF、GLB/拓扑输出和渲染辅助文件是派生工件；除非用户明确说明，否则STL/3MF是次要的。
  • 使用命名参数、封闭实体、详细的本地build123d标签和源代码控制的几何意图。
  • 在源代码中编写装配体定位。references/positioning.md 对 AssemblyHelper、build123d关节、显式 Location 变换和对齐验证具有权威性。
  • 不要使用 git status、git diff 或文件大小变化作为大型导出STEP/STP、GLB/拓扑、STL或3MF工件的CAD比较。而是比较源代码更改、scripts/inspect 摘要、快照或生成的拓扑输出；仅将路径限制的git状态用于记账。
  • 仅报告实际运行或直接由工具输出支持的检查。

渐进式参考

仅当其触发器适用时加载这些文件：

  • references/cad-brief.md — 将散文、参考图像和技术图纸转换为CAD说明。
  • references/build123d-modeling.md — build123d建模模式、拓扑、选择器、特征、标签。
  • references/step-generation.md — 从Python源代码生成STEP、直接STEP/STP导入以及生成后步骤。
  • references/inspection-and-validation.md — 验证序列、选择器引用、事实、平面、测量、对齐、差异、坐标系和验证报告。
  • references/snapshot-review.md — 强制性快照策略、数据包大小、目标视图以及将视觉发现转换为几何检查。
  • references/positioning.md — 零件局部基准和原点、装配体变换、build123d关节、CLI对齐验证和定位报告。
  • references/parameters.md — 参数化或动画化STEP模型：源参数、.step.js 辅助模块、查看器控件和动画设计。
  • references/supported-exports.md — 次要STL/3MF/原生GLB辅助工作流。
  • references/repair-loop.md — 诊断和修复程序。

最终响应应包括生成的文件、返回的 $cad-viewer 查看器链接、验证快照、实际运行的验证、假设和注意事项。使用 references/inspection-and-validation.md 作为报告结构。