PCB Skill 的作用
PCB Skill 是一种代理技能，可引导硬件创意从最初概念发展为能够下单、焊接并完成调试启动的 PCB。它运行于 Claude Code desktop 或 Codex desktop 中，通过 MCP 桥接控制 EasyEDA Pro，并使用已登录 PCB 制造商和元器件供应商账户的浏览器。
该项目不是通用的 PCB 理论课程，而是提供一套分阶段的工程流程，用于发现实际缺陷：插座方向旋转错误、元器件隐藏在模块主体下方、无效的禁布区、错误的几何变换、过时的验证输入，以及静默失败的监控脚本。
代理可以准备购物车并导航到付款前页面，但绝不会下单或付款。最终购买操作仍需手动完成。
设计原则
该流程围绕三个优先事项组织。
- 成本效益： 每个元器件都应根据实时供应商页面定价，或明确标记为估算值。物料清单还会根据你已有的元器件进行调整。
- 手工组装： 电路板按照便于你组装的方式设计。流程会避开底部端接封装，确保焊盘易于触达，并考虑不会将焊点困住的组装顺序。
- 免费打样： 从最初草图开始，电路板就会控制在所选免费打样限制内，而不是在最后才调整尺寸或简化设计。
前置条件
使用该技能前，请准备好所需的桌面应用和账户：
- Claude Code desktop 或 Codex desktop。
- 已配置所需 MCP 桥接的 EasyEDA Pro。
- 已安装代理扩展的兼容浏览器。
- 已登录 PCB 制造商和元器件供应商账户的浏览器会话。
- 可选：如果操作系统会为每次浏览器操作显示权限提示，请准备权限审批监控程序。
请按照仓库中的 设置指南 完成环境检查清单。仓库还为 macOS 和 Windows 提供了平台专用的权限审批监控程序说明。
权限审批监控程序受到有意限制。它可以减少重复的权限提示，但不会操作购物车或付款控件。
安装 PCB Skill
1. 克隆仓库
git clone https://github.com/daishuge/pcb-skill.git2. 为代理安装
对于 Claude Code，将技能复制到 Claude 技能目录：
cp -r pcb-skill/skills/pcb ~/.claude/skills/pcb对于 Codex，改用 Codex 技能目录：
cp -r pcb-skill/skills/pcb ~/.codex/skills/pcb3. 配置 EasyEDA Pro 和 MCP
完成 EasyEDA MCP 设置。PCB Skill 依赖此桥接来驱动 EasyEDA Pro，因此请在开始电路板项目之前验证连接。
4. 准备浏览器会话
打开装有所需代理扩展的浏览器，并登录计划使用的 PCB 制造服务和元器件供应商。代理会通过这些现有会话进行采购，而不会自行处理凭据。详情请参阅 浏览器登录说明。
开始 PCB 项目
技能和集成准备就绪后，向代理提供一个具体的硬件创意。请包含已知的电气、机械、制造、预算和库存限制。例如，可以这样提出请求：
为我的显示模块设计一块适合手工焊接的控制器板。
尽可能使用我库存中已有的元器件。
将设计控制在我的 PCB 制造商免费打样限制内。
询问所有会影响电路板设计的要求。
准备采购和制造订单，但在付款前停止。这不是特殊的命令语法，而是一种实用的方式，用于说明项目目标以及 PCB Skill 旨在强制执行的边界。
遵循四阶段流程
阶段 1：定义概念
第一阶段将硬性约束与软性偏好区分开来。硬性约束可能包括连接器兼容性、外壳尺寸、所需供电电压或制造限制。软性偏好可能包括元器件品牌、连接器位置或可选功能。
只有在代理询问了所有可能因答案不同而导致电路板不同的问题后，该阶段才算完成。不要急于通过这一关：此处遗留的不确定性会在之后变成代价高昂的返工。
阶段 2：创建原理图并采购元器件
代理会开发原理图、建立带价格的物料清单并准备供应商购物车。网络表断言必须通过后，该阶段才能被接受。
请仔细检查采购结果。每个价格都应标记为来自实时页面的 VERIFIED，或标记为 ESTIMATE。成本计算还应考虑库存中已有的元器件，而不是将 BOM 中的每一行都视为新的采购项目。
此时，应同时检查封装选型和电气参数。项目的装配原则倾向于选择焊盘易于接触的封装，并排除不适合目标手工焊接流程的封装。
阶段 3：放置、布线并审查电路板
布局阶段将生成完成元件放置、布线和铺铜的 PCB。元件放置必须具备可布线性，不能仅仅满足 EDA 工具判定的合法性。仓库包含用于根据实际焊盘推导 courtyard、识别过孔通道以及检查模块本体周围间距的放置工具。
该阶段要求设计规则检查干净通过，并完成一次成功的对抗性审查。审查过程为只读操作，会重新推导重要测量值，而不是信任现有数值或状态指示器。
阶段 4：验证生产文件并准备采购
代理会生成 Gerber 文件包，并独立于创建这些文件的 EDA 软件进行验证。仓库中的验证脚本涵盖 Gerber 解析、间距扫描、钻孔计数、网表断言和 3D 干涉检查等方面。
验证完成后，代理可以准备生产和元件采购，并导航至付款前页面。在手动提交任何订单前，你仍需负责检查最终价格、数量、配送信息、生产选项和付款控件。
了解仓库工具
skills/pcb/SKILL.md：定义代理技能及其核心行为。skills/pcb/references/：包含按需提供的工作流、审查、制造、采购、EDA-MCP 常见问题、机械与 3D 检查以及调试指导。scripts/placement/：提供涉及基于焊盘推导的 courtyard、布线空间和模块本体间距的放置检查。scripts/routing/：包含 Specctra DSN 和 SES 自动布线链路、四状态 watchdog 以及速率下限监控。scripts/verify/：独立于 EasyEDA 执行验证，包括 Gerber、间距、钻孔、网表和干涉检查。scripts/notify/：传递进度信息，避免长时间运行的操作保持静默。docs/case-study.md：记录参考电路板上发现的缺陷，并报告其实际成本。
高级可靠性建议
在审查前定义终止条件
绿色的电路板视图或看起来整洁的布局，并不能证明设计正确。每个阶段都应以一次单轮对抗性审查结束。在审查开始前写下终止标准；否则，审查可能变成无明确边界的循环。
测量决定性主张
诸如这可能不受支持的说法不应决定是否继续工作。对于会阻止或批准某个阶段的主张，必须要求证据。记录哪些数值是直接测量的，哪些数值是根据这些测量结果计算得出的。
校准验证工具
不要仅因为检查器成功完成，就假定它是正确的。应使用已知的非对称物体校准几何变换。对称测试物体可能掩盖旋转、镜像和坐标系错误。
让长时间运行的任务可观测
对于每个等待条件或日志过滤器，都应询问：如果此时发生崩溃，是否会产生一行可见日志？PCB Skill 包含 watchdog 和通知组件，因为一个静默运行的进程很难与已停滞或失败的进程区分开来。
检查最终文件包，而不只是源设计
应针对准备上传的实际 Gerber 和钻孔数据运行独立检查。这有助于防范导出问题、过期文件，以及验证工具意外读取先前版本而非当前电路板的情况。
将案例研究用作审查清单
项目案例研究解释了促成该工作流的真实缺陷。在接受你的第一个设计前阅读它，以便将抽象的关卡与具体的失效模式联系起来。
结论
PCB Skill 将 PCB 开发转化为一系列明确且可测试的关卡，涵盖需求、原理图绘制、采购、布局、布线、生产验证和采购准备。它的主要价值不只是自动绘图，而是跨工具和阶段进行有纪律的检查。将其安装到 Claude Code 或 Codex 中，完成 EasyEDA MCP 和浏览器设置，并始终对每次最终采购保留人工控制权。