技能介绍

解决什么问题

pycatia 脚本看起来只是调用 COM 接口，真正写起来很容易踩坑：忘记先启动 CATIA 会导致 catia() 直接失败；application.active_document 在没有打开文档时返回 None；参数写死在建模逻辑里，后续改尺寸就像翻车现场；批量处理文件夹时路径格式、许可证缺失、COM 引用生命周期都会突然冒出来。对 CATIA V5 自动化工程师来说，这些不是小 bug，而是会让工作台崩溃、让模型改到一半无法继续的问题。

技能如何工作

该技能把一次 pycatia 开发拆成可检查的工作流：

智能路由：用户说“帮我写”走完整脚本生成流程；说“怎么用某个 API”跳到 API 查询；说“报错/修复”进入自动调试。
环境检查：先确认 Python 版本、pycatia 安装、CATIA COM 可达性和可用模块许可证，再继续生成代码。
需求澄清：解析操作类型、文档类型、目标特征、输入输出和是否批量，并对缺失信息做工程化默认或明确提示。
脚本生成：输出自包含脚本，包含 from pycatia import catia、application = catia()、参数集中、try/except、if __name__ == "__main__" 和逐步注释。
调试修复：根据 traceback、pycatia 版本和 CATIA 版本定位 COM 未启动、API 路径错误、路径格式、许可、选择集为空、对象为 None 或超时等问题。
交付核验：确认脚本可运行、输出文件存在、模型按预期修改，再进入局部迭代。

适用边界

仅适用于 Windows + CATIA V5 + pycatia 环境。运行脚本前必须先启动 CATIA，不能跨函数长期缓存 COM 对象，路径使用 Windows 格式。修改文档前会提示备份，文件输出目录会要求 os.makedirs，涉及许可证的脚本会标注所需模块。API 查询优先使用内置参考，必要时可用 WebSearch 补充，但不会搜索外部 CATIA 文档正文。Agent 不会自动执行脚本，只生成代码、运行指引和修复建议。