AI Skill + MCP toolkit for reliable desktop CAD automation.
让 Codex、Claude、Cursor 等 Agent 通过自然语言调用真实 CAD 软件，并对执行结果进行验证与追踪。
Tool success is not treated as task success.
工具调用成功，不代表任务真的完成；需要 Review 的任务会经过结果验证后再交付。
User → Agent (Codex / Claude / Cursor) → Skill / MCP → Execution Core → CAD → Artifacts + Evidence
AI 负责理解意图、查证 API、规划步骤；Execution Core 保证执行过程可追踪、可验证、失败可恢复。
See It In Action
一个真实流程：自然语言需求 → Agent 调用 Skill → SolidWorks 生成原生 SLDPRT + SLDDRW → 导出 PDF → 自动复核尺寸与证据。
| 案例 | 能力 | 状态 |
|---|---|---|
| M6×1 真实螺纹孔 | Metric Tap Thread，重建后回读 | verified |
| CNC 多圆角/倒角安装座 | 语义选边、可变半径、face/full-round/setback | stable |
| 标准渐开线直齿轮 | 模数/齿数/压力角驱动实体 | pilot |
Quick Start
三种入口任选其一即可，不需要同时启动。
Option 1 — Skill（最简单）
npx github:wzyn20051216/solidworks-automation-skill
# 或
claude skill add https://github.com/wzyn20051216/solidworks-automation-skill
Option 2 — MCP
npm install -g @smithery/cli
smithery mcp add wzyn20051216/solidworks-automation-skill --client codex --config '{}'
Option 3 — CAD Studio 桌面版
从 GitHub Releases 下载 Windows 安装包。
Choose one entry point. You do not need to run all three.
| 入口 | 适合谁 | 需要 GUI | 典型用法 |
|---|---|---|---|
| Skill | 支持 skill 导入的 Agent 客户端 | 否 | 自然语言驱动 SolidWorks |
| MCP | Codex / Claude / Cursor / Windsurf 等 MCP 客户端 | 否 | Agent 自动 Tool Calling |
| CAD Studio | 需要图形界面管理项目/任务/预览/交付 | 是 | 桌面端提交任务 |
三者是平级入口，共用同一套能力清单（capabilities.yaml）、脚本与证据系统。安装后可用 python scripts/cad_doctor.py 做环境诊断；详细安装与 CLI 见 docs/CAD_STUDIO_USER_MANUAL.md。
Why This Project
LLM 会规划，但常见的 AI CAD 自动化有几个真实问题：
- LLM 会规划，但不会真正操作桌面 CAD 软件
- Tool 返回
success不代表任务真的完成 - CAD API 版本、环境、Backend 差异复杂
- 固定 Tool 集合覆盖不完所有工程需求
- Agent 执行过程通常不可追踪、不可审计
本项目的解法：
| 问题 | 方案 |
|---|---|
| 自然语言 → 真实操作 | Skill / MCP 接入真实 COM 与后端 |
| Tool success ≠ Task success | Verification-first completion |
| Backend 失败 | Backend Router + Recovery Decision |
| 能力缺失 | Capability Gap → 交还 Agent 查证 |
| 执行不可追踪 | 结构化 Trace |
| 是否可靠 | Golden Workflow Eval |
Architecture
User / Agent
↓
Skill / MCP
↓
Execution Core（Capability · Verification · Recovery Decision · Trace）
↓
Backend Router
↓
Python COM / C# / OCCT
↓
CAD Software
↓
Artifacts + Evidence
Root Skill = 通用能力、规则与执行基础设施（连接、建模、审查、MCP）。
Subskills = 专项领域工作流（工程图、螺纹孔、CNC 圆角、VibeCAD、AutoCAD），由 Root Skill 按需调用，不需要用户手动启动。
Execution Core = 内部可靠执行层：统一状态、结果验证、失败恢复决策与执行追踪。它是内部实现，不是独立服务、不需要用户启动。
Capability Gap = 找不到能力时结构化返回
CAPABILITY_GAP，交还 Agent 查证，而不是「做不了」：Existing Tools → Tool Composition → Backend Fallback → Capability Gap → Agent 查 references / 官方 API / SDK → 最小实现 → Verification
No comments yet.