mcpField
C
create-cad-files

create-cad-files

github.com/caid-technologies设计与 UI6655 次安装3 周前更新
代码仓库

关于 create-cad-files

create-cad-files 是用于生成和导出参数化 CAD 模型的技能，面向需要 STEP 或 STL 文件的设计与制造任务。它将 OpenCAD Python 源码、原生 OCCT 导出和文件验证纳入同一流程，并保留可复现的项目文件。

主要功能

  1. 01从需求提取尺寸与几何信息
  2. 02生成参数化 OpenCAD Python 模型
  3. 03通过 OCCT 导出 STEP 或 STL
  4. 04验证交换文件并检查特征树
  5. 05保留源文件与项目文档

适用场景

  1. 01制作可编辑的 STEP 几何模型
  2. 02生成用于 3D 打印的 STL 文件
  3. 03在项目中组织可复现的 CAD 组件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/caid-technologies/opencad --skill create-cad-files

安装后在 Claude Code 中输入/create-cad-files确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
opencad-api.md
scripts/
build_cad_file.py
create_project.py
validate_cad_file.py

详细介绍

创建 CAD 文件

使用易读的 OpenCAD Python 创建模型，通过原生 OCCT 后端导出，并在返回前验证交换文件。保持以提示词为先的用户体验：处理源文件生成、构建命令和验证，无需用户操作 Python。

工作流

  1. 提取尺寸、单位、几何形状、孔、间隙和输出格式。除非另有说明，否则使用毫米。只有当缺失的尺寸会对零件造成重大影响时才提问；否则说明假设。

  2. 可编辑／制造用途的几何优先使用 STEP，三角网格 3D 打印交付件使用 STL。用户要求时同时创建两种格式。

  3. 编写模型前，阅读 references/opencad-api.md。每次运行开始时，使用 scripts/create_project.py 创建一个全新的项目目录，并将返回的路径用作 PROJECT_DIR。该辅助脚本会在 ~/forma-workspace/ 下创建一个以 UUID 命名的目录；切勿根据请求推导项目 ID。将所有源文件、README、组件和生成的制品保存在 PROJECT_DIR 中。创建 README.md 记录项目背景，创建 assembly.py 作为总装入口文件；尺寸需要共用时创建 parameters.py；创建 components/ Python 包存放组件模块，并创建 outputs/ 目录存放生成的制品。用户明确指定的文件名应在 PROJECT_DIR 内遵循，但不要替换共享根目录或生成的项目 ID。

  4. 保持模型参数化：将重要尺寸赋给有名称的常量，让组件模块公开具名构建器或零件，并在 assembly.py 中创建一个最终的 Part。将该最终零件留作 assembly.py（或明确指定的总装文件）中最后生成的形状。不要在模型中调用 Part.export()；构建辅助脚本负责导出和验证。

  5. 确保已安装 opencad[occt]。如果导入 OpenCAD 失败，说明依赖项，并在将其安装到当前 Python 环境前征求同意。

  6. 确定此技能的目录，使用绝对路径创建项目目录，并在返回的项目目录内操作；使用绝对路径运行构建辅助脚本：

    PROJECT_DIR=$(python /path/to/create-cad-files/scripts/create_project.py)
python /path/to/create-cad-files/scripts/build_cad_file.py "$PROJECT_DIR/assembly.py" "$PROJECT_DIR/outputs/assembly.step" --tree-output "$PROJECT_DIR/outputs/assembly.tree.json"

    STL 输出名称使用 .stl 后缀。除非明确提供 --force，否则辅助脚本会拒绝替换文件。

  7. 如果导出两种格式，请对同一项目的 assembly.py 源文件运行两次。使用 scripts/validate_cad_file.py 的绝对路径单独验证已有制品。

  8. 检查失败原因并修改源文件，而不是绕过验证。返回源文件、CAD 制品和特征树的可点击路径，以及单位和假设。

质量规则

  • 保持用户要求的尺寸精确，并为面向用户的参数使用指定名称。
  • 使用闭合、有序的草图轮廓。避免自相交、零厚度接触和共面布尔运算歧义。
  • 在主体和布尔运算完成后再添加圆角和倒角。
  • 明确表示孔和间隙。不要臆造制造公差；如果配合很重要，应予以标注。
  • 不要声称基本文件验证能够证明模型适合打印、具备承载能力、符合规范或可制造。
  • 保留项目源文件、README.md 和树形结构 JSON，以便后续修改可复现。
  • 保持项目自包含，使 assembly.py、嵌套组件包和生成的制品可作为整体进行管理。
  • 组件包和子包应使用 __init__.py 文件。从项目根目录导入嵌套组件，例如 from components.motor.mount.screw_pattern import make_screw_pattern。
  • 在 README.md 中记录项目用途、单位、假设、关键尺寸、组件／包结构、构建命令、制品和已知限制。

故障处理

  • 如果 CadQuery/OCP 不可用，请使用 opencad[occt]；绝不要用解析后端替代交付物。
  • 如果布尔运算或圆角失败，请简化特征、减小半径，或消除重合面。
  • 如果所请求的几何超出 API 的能力范围，请说明限制，并且只有在用户同意后，才实现最接近且忠实的参数化模型。

评论

支持 Markdown