前言¶
在 CATIA V5/V6 里做图纸标注、零件建模或装配自动化，常见路径是写 CATScript、VBScript 或 VBA 宏，再对照 Automation API 文档查对象与方法。文档分散、CATScript 与 VBA 语法差异大，网上示例也未必覆盖你当前工作台。下面介绍 SkillHub 上的 catia宏编写助手（@user_cf90b6c5/catia-marco）：把宏编写相关的 API 说明、语法限制和已知问题收进一个 Skill，在 Cursor 等支持 Skill 的环境里，让模型按同一套约束生成或改宏。
这是什么¶
catia宏编写助手 是面向 CATIA 宏开发的社区 Skill（来源：community，分类：dev-programming，当前版本 1.0.0）。发布者为 SkillHub 用户 user_cf90b6c5，标签标明 requires_api_key=false，安装使用不依赖额外 API Key。
一句话定位：专门用于编写、调试和修改 CATIA V5/V6 自动化宏的工具包；写宏时加载它，相当于旁边有一份可检索的 API 说明，以及 CATScript 语法边界和踩坑记录。
核心功能¶
以下能力均来自 SkillHub 官方页面说明，可按需裁剪使用。
宏语言与工作台覆盖¶
- 支持 CATScript / VBScript / VBA 方向的宏编写与修改。
- 场景覆盖 图纸标注、零件设计、装配 等（与简介中的「图纸自动化、尺寸标注、视图与图纸页操作、组件搜索」等编程任务一致）。
API 与示例¶
- 内置 214 个 CATIA API 接口 的完整文档，便于查阅方法与属性。
- 提供 10 个官方宏示例，可直接参考或在其基础上修改。
语法限制（CATScript）¶
列出 11 条 CATScript 语法限制，用于减少「能写出来但运行报错」的情况。官方举例包括：
- 不能使用
For Each - 不能使用
Format()等
已知踩坑¶
记录 12 条 实际开发中遇到的问题，避免重复排查。官方举例包括：
GetRealColor读不了颜色GetPaperDimensions方法不存在
安装与启用¶
SkillHub 页面给出的安装方式，是让 AI 按通用安装说明拉取指定坐标：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_cf90b6c5/catia-marco`。
操作步骤可以概括为：
- 在已支持 SkillHub Skills 的客户端（如 Cursor）中，将上述提示发给 AI，或自行打开 skillhub 安装说明 按文档操作。
- 确认安装坐标为
@user_cf90b6c5/catia-marco，版本与页面一致时为 v1.0.0。 - 编写或调试 CATIA 宏相关的对话前，启用该 Skill，使模型优先遵循包内的 API 说明、语法限制与踩坑记录。
各客户端的具体菜单或命令以各自文档为准；官方页面未单独列出 Cursor / Codex CLI / Claude Code 的差异时，统一以上述坐标与安装说明为准。
典型用法¶
官方资料未附带可逐行复制的完整宏工程，但明确了使用方式：在宏开发对话中加载本 Skill，向 AI 描述目标（例如图纸标注、视图操作、装配里搜索组件等），由模型结合 214 条 API 文档、10 个示例 以及 11 条语法限制 / 12 条踩坑 生成或修改脚本。
可复现的交互示例（表述需与你在 CATIA 中的真实对象一致）：
- 说明 CATIA 版本（V5 或 V6）、宏类型（CATScript / VBA 等）以及当前文档类型（工程图、Part、Product 等）。
- 描述要做的自动化步骤（如批量标注、切换图纸页、遍历装配节点）。
- 若运行报错，把错误信息与相关 API 名发给 AI，对照 Skill 内的限制与踩坑条目排查。
经过上面的步骤，模型应倾向于避开已记录的 CATScript 禁区，并少调用文档中标注有问题或不存在的接口。
适用场景与注意¶
适合谁
- 需要经常写或改 CATIA 宏的 CAD 二次开发、工艺或制图工程师。
- 希望减少翻分散 API 文档、重复踩同一类 API 坑的时间。
使用注意
- Skill 内容为社区维护的知识包，与现场 CATIA 版本、许可模块是否一致，仍需你在本机宏编辑器里验证。
- SkillHub 页面统计（截至页面展示）：评分 100000，下载 1466，安装 1；数据以 SkillHub 详情页 为准。
- 复杂逻辑仍建议保留版本管理与在 CATIA 内的逐步调试；Skill 辅助生成代码，不替代本机测试。
结尾¶
catia宏编写助手 把 CATIA 宏常用的 API 说明、示例、CATScript 语法边界和已知 API 问题集中在一个 Skill 里，适合在 AI 结对编程时作为固定上下文。需要安装或查看更新时，可访问官方入口：
- API 页：https://api.skillhub.cn/user_cf90b6c5/catia-marco
- SkillHub 页：https://www.skillhub.cn/skills/user_cf90b6c5/catia-marco
