内容
<div align="center">
# AutoCAD 技能
**面向 Codex、Claude Code 及兼容的 Agent Skills 运行器的生产型机械 CAD 技能。**
[](https://github.com/beiming183-cloud/AutoCAD-skills/actions/workflows/validate.yml)
[](https://github.com/beiming183-cloud/AutoCAD-skills/releases/latest)
[](LICENSE)
[](https://code.claude.com/docs/en/skills)
[English](README.md) · [简体中文](README.zh-CN.md) · [技能来源](skills/mechanical-drafting-gbt/SKILL.md) · [发行版本](https://github.com/beiming183-cloud/AutoCAD-skills/releases)
</div>
## 为什么存在
AI 生成的 CAD 看起来很逼真，但仍可能存在错误：端点几乎接触，视图描述不同的部件，组件相互穿过，标注为 `1:1` 的图纸实际上是适应页面大小的，或者成功的工具调用创建了错误的坐标。
本项目将这些错误模式转化为明确的检查关卡。它需要参数权威、请求与实际值的回读、语义拓扑、跨视图证明、物理合理性边界、图纸比例真实性和人工发布授权。
> 成功的操作并不代表成功的设计评审。干净的几何 DRC 并不是完整的产品设计评审。
## 涵盖内容
| 领域 | 内置期望 |
| --- | --- |
| GB/T 机械制图 | 默认第一角投影、无指定时的线条层次、尺寸标注、视图/剖面、中文文本、标题栏、螺纹、齿轮、样条曲线、弹簧、轴承 |
| AutoCAD 和 MCP | 就绪发现、严格的输入请求、原子化分阶段提交、句柄回读、`请求/实际/差异`、有界恢复、确定性回退 |
| 2D 和 3D | 参数化零件、装配体、机构、投影视图、共享 2D 骨架、剖面真实性、交换/导入证据 |
| 语义 DRC/DFM | 悬浮和近似接触的端点、非故意的交叉、未拥有的线条、开放材料边界、遮挡、视图源一致性、干涉和工艺检查 |
| 消费品 | 用户/场景简介、三个概念选项、采购零件包络、主电源/移动部件安全架构、人机工程学、电缆和稳定性 |
| 产品定义 | GPS/GD&T、公差堆叠、检查计划、BOM/配置/修订权限、发布清单和证据边界 |
当前软件包为 [`mechanical-drafting-gbt`](skills/mechanical-drafting-gbt/)。其英文运行时基准和中文维护镜像一同检查。
## 快速开始
### 使用捆绑安装器安装
```bash
git clone https://github.com/beiming183-cloud/AutoCAD-skills.git
cd AutoCAD-skills
# Codex 个人技能：$CODEX_HOME/skills 或 ~/.codex/skills
python scripts/install_skill.py --target codex
# Claude Code 个人技能：~/.claude/skills
python scripts/install_skill.py --target claude-user
```
对于项目范围内的 Claude Code 安装：
```bash
python scripts/install_skill.py --target claude-project --project /path/to/your/project
```
安装器拒绝覆盖现有的技能。使用 `--dry-run` 来检查目标目录。
### 直接在 Codex 中安装
要求 Codex 安装此仓库路径：
```text
Install the skill from:
https://github.com/beiming183-cloud/AutoCAD-skills/tree/main/skills/mechanical-drafting-gbt
```
Codex 在 `$CODEX_HOME/skills` 下安装仓库技能。Claude Code 在 `~/.claude/skills/` 下发现个人技能，在 `.claude/skills/` 下发现项目技能，如 [Claude Code 技能指南](https://code.claude.com/docs/en/skills) 中所述。
## 试用
安装后，向您的代理询问具体问题：
```text
Audit this two-view gearbox drawing. Prove both views come from the same
parameter source, classify every dangling endpoint and unintended crossing,
and verify the title-block scale against the plotted PDF.
```
```text
Create three low-cost enclosure concepts for this desktop mains-powered
product. Define users, scenarios, port count, actions and cable directions.
Do not enter detailed CAD until I select a concept and the safety architecture
and purchased-part envelopes are documented.
```
```text
Model this shaft parametrically under GB/T conventions, then generate the
drawing and inspection plan. Keep every unsupported fit, material and surface
requirement as TBD instead of guessing.
```
参见 [消费品关卡示例](examples/consumer-product-review.md) 和 [DRC 报告示例](examples/drc-report.sample.json)。
## 发布关卡
稳定检查包括：
- `E_POSTCONDITION_MISMATCH`：停止创建的几何体与请求不匹配时。
- `DANGLING_ENDPOINT`、`NEAR_MISS_CONNECTION`、`INTERIOR_CROSSING`：按实体分类拓扑结构，而非一概而论。
- `VIEW_SOURCE_CONSISTENCY`：主视图必须共享一个权威模型或参数骨架。
- `PLOT_SCALE_CONSISTENCY`：数字标题栏比例必须与实际 PDF 变换匹配。
- `CONSUMER_CONCEPT_GATE`、`MAINS_SAFETY_GATE`、`PRODUCT_DESIGN_REVIEW`：几何有效性不能绕过产品定义和安全架构。
## 兼容性和范围
| 运行器/环境 | 状态 | 备注 |
| --- | --- | --- |
| Codex | 支持 | 标准 `SKILL.md`、渐进式引用、无账户耦合 |
| Claude Code | 支持 | 使用 Agent Skills 开放格式；复制到个人或项目技能 |
| 其他 Agent Skills 运行器 | 可移植基准 | 运行期特定元数据是可选的；验证本地发现规则 |
| AutoCAD/MCP 桥接器 | 能力依赖 | 技能映射到暴露的安全工具，不会发明缺失的操作 |
| CAD 内核和结构化 DXF 工具 | 支持回退 | 仅当几何体和后置条件可以独立验证时使用 |
此仓库 **不** 捆绑 AutoCAD、MCP 服务器、CAD 内核、电气认证或自动制造批准。代理生成的制造工件在获得授权外部流程批准之前仍为 `候选后人工审查` 状态。
## 仓库布局
```text
AutoCAD-skills/
├── README.md / README.zh-CN.md
├── assets/ # 项目和社交预览视觉元素
├── examples/ # 具体提示和机器可读证据
├── scripts/ # 安装器和仓库验证器
├── .github/ # CI 和贡献模板
└── skills/
└── mechanical-drafting-gbt/ # 清洁、可移植的运行时技能包
├── SKILL.md
├── SKILL.zh-CN.md
├── references/
└── scripts/
```
## 在本地验证
```bash
python scripts/validate_repo.py
```
验证器检查技能前置信息、英文/中文镜像偏移、稳定规则 ID、Markdown 链接、JSON 示例、私有路径、占位符文本和临时安装往返。GitHub Actions 在每次推送和拉取请求时运行相同的命令。
## 从 v1.x 升级
运行时技能从仓库根目录移动到 `skills/mechanical-drafting-gbt/`，版本为 v2。现有的已安装副本继续有效。要进行干净的更新，请保留任何本地自定义，将旧安装目录移开，然后从新子目录安装。安装器故意不覆盖现有文件。
## 常见问题
**它是否单独控制 AutoCAD？**
不，它定义工作流和验证合约。实际操作取决于环境中可用的 AutoCAD/MCP/COM/脚本工具。
**DRC 通过是否认证图纸或产品？**
不，结果仅限于已评估的规则、表示和证据。安全、性能和制造发布需要适用的工程和授权人工审查。
**为什么需要三个消费品概念？**
仅新概念和主要表单因子更改需要比较。已批准的概念可以在其修订版和决策权限记录后重复使用。
**我可以贡献另一个 CAD 工作流或标准吗？**
是的，请确保规则可追溯、可衡量且供应商中立；更改镜像核心行为时，请添加英文和中文覆盖。
## 贡献
阅读 [CONTRIBUTING.md](CONTRIBUTING.md)，开启一个聚焦的问题，或提交带有现实故障案例和验证证据的拉取请求。请勿提交发明的标准、不可验证的制造值或将缺失证据转为通过的检查。
如果此技能阻止了一个看似合理但不正确的图纸发货，请考虑为仓库加星。这有助于其他 CAD 和 AI 代理用户找到该项目。
## 许可证
MIT。参见 [LICENSE](LICENSE)。
MCP 市场