PCB Skill
Agent Skill:从硬件想法一路做到可下单焊接的 PCB——原理图、选型、布局、布线、验证、采购到预付款页。运行于 Claude Code/Codex 桌面端,经 MCP 驱动 EasyEDA Pro。Python + MIT。
评分明细
适用场景
这是什么?适合谁?
PCB Skill(daishuge/pcb-skill)是一个把硬件想法推进到可下单、可焊接、可点亮电路板的 Agent Skill:概念 → 原理图与选型 → 布局与布线 → 验证 → 采购,一直到购物车推进到预付款页面才交还人工确认。它运行在 **Claude Code(桌面端)或 Codex(桌面端)**内,通过 MCP 协议驱动 EasyEDA Pro 完成画图,用浏览器(已登录元件商城)完成比价与加购。
它的定位不是”PCB 理论教程”,而是封装真实验收 gate 的工程规则集:插座转 180° 导致显示屏永远插不上、电容被模块外壳压住、keep-out 只画在丝印层、检查器悄悄量了上一个版本——这些理论不管的坑由确定性检查脚本拦截。仓库 2026-09-08 创建,2 天 100★/18 fork,MIT,Python。
适合谁:
- 想让 Claude Code / Codex 全程辅助从想法到打样的硬件工程师与创客
- 做快速原型、需要小批量免费打样(免费原型尺寸包络内)的团队
- 用 EasyEDA Pro 画图、想用 Agent 驱动 EDA 流程的开发者
不适合:需要多层高速信号完整性全流程(阻抗仿真等)的专业板卡团队;不用 EasyEDA 生态的用户;期望 Agent 自动付款下单的用户——下单与付款永远由人工完成。
使用前提:Claude Code 或 Codex 桌面端、EasyEDA Pro + MCP 桥、已登录 PCB 厂与元件商城的浏览器。
准备工作
- 安装:git clone 仓库后把
skills/pcb/、scripts/、setup/三个目录复制到技能目录(见下方命令) - 环境:Claude Code(
~/.claude/skills/pcb)或 Codex(~/.codex/skills/pcb)、EasyEDA Pro、Python - 登录:浏览器登录你的 PCB 厂(如 JLCPCPC)与元件供应商账号
- 成本:Skill 本身 MIT 免费;打样与元件按 BOM 计费(设计目标之一是免费原型包络内 0 元打样)
- 时间:环境准备(EasyEDA MCP 桥 + 浏览器登录)约 1-2 小时;一块简单板从概念到预付款页约 1-2 天
快速上手(3 步)
第一步:安装 Skill
git clone https://github.com/daishuge/pcb-skill.git
cd pcb-skill
DEST=~/.claude/skills/pcb # Codex: DEST=~/.codex/skills/pcb
mkdir -p "$DEST" && cp -R skills/pcb/. scripts setup "$DEST"/
# 验证 —— 缺目录会在设计中段才暴露,务必现在查
ls "$DEST"/SKILL.md "$DEST"/references "$DEST"/scripts "$DEST"/setup >/dev/null && echo "pcb installed"
预期产出:pcb installed 提示,技能目录四要素齐全。
第二步:按 setup 检查表过环境
逐项核对 setup/README.md 三张检查表:① EasyEDA Pro + MCP 桥(setup/easyeda-mcp.md);② 浏览器装 Agent 扩展并已登录 PCB 厂与元件商城(setup/browser-logins.md);③ 若桌面端每次浏览器动作都弹权限卡,按 setup/auto-approve-macos.md / setup/auto-approve-windows.md 配置审批监听。
预期产出:MCP 能连上 EasyEDA Pro,浏览器内已登录供应链账号。
第一步任务:从一句话想法到概念约束
在 Claude Code / Codex 里直接描述需求,例如:“做一个 ESP32-C3 + 0.96 寸 OLED 的最小系统板,Type-C 供电,要手工可焊”。Skill 进入 Phase 1(概念):把需求分成硬约束/软约束并逐条确认——凡两个答案会导出不同板子的疑问题,必须全部问完才放行。
成功判定:Agent 输出一份”硬约束已锁定、软约束已商定”的概念清单,并主动给出免费打样包络(如 100×100mm 内)的尺寸预算。
四阶段工作流与验收 gate
| 阶段 | 产出 | 验收 gate |
|---|---|---|
| 1 概念 | 硬/软约束清单 | 所有关键问题已问完并确认 |
| 2 原理图+选型 | 原理图、带价 BOM、暂存购物车 | 网表断言通过;每个价格标 VERIFIED 或 ESTIMATE |
| 3 布局+布线 | 已布局布线覆铜的板 | 布局”可布通”而非仅合法;DRC 干净;对抗式审查通过 |
| 4 制造+采购 | 已核验 Gerber、停在预付款页的订单 | 产出包由独立于 EDA 的脚本再核验一遍 |
三条设计原则贯穿全程:性价比(每个元件价格来自实时页面或标注估算,BOM 扣除已有库存)、好装配(手工焊接视角:禁底部端接封装、每个焊盘可达、有合理焊接顺序)、免费 PCB(从第一笔草图就设计在免费原型包络内,而不是最后才想起来)。
验证脚本刻意独立于 EDA 工具:scripts/verify/ 做 Gerber 解析、间距扫描、钻孔普查、网表断言、3D 干涉检查——scripts/placement/ 从真实焊盘算 courtyard 与过线通道,scripts/routing/ 提供 Specctra DSN/SES 自动布线链与四态看门狗(防止长任务静默挂死 10 小时,作者在参考项目上真实踩过)。
初级用法
只用验证器不换 EDA
scripts/verify/ 可独立于整套 skill 使用:导出 Gerber 后跑间距/钻孔/网表断言,给手工画完的板加一道独立复核。
免费 BOM 询价
让 Agent 只跑 Phase 2 的选型与购物车暂存:从实时页面逐元件抓价并标注 VERIFIED/ESTIMATE,再与自有库存对冲。
一块参考板跑通全流程
第一次使用建议拿 docs/case-study.md 里的参考板规格复刻一遍:小尺寸、两层板、手工可焊,1 天内能走完全部四个 gate。
高级玩法
Specctra 自动布线链
scripts/routing/ 的 DSN/SES 链把布线外包给外部 autorouter,配四态看门狗与速率下限监控,适合扇出密集的 BGA/QFN 板。
对抗式布局审查
Phase 3 结束时让 Agent 跑”一次通过、只读、对抗式”审查:重新推导数字而不是读取数字,且终止条件在开始前写死,避免审查循环失控。
bring-up 检查单联动
references/ 里的 bring-up 文档(点亮顺序、首测项)与验证脚本联动,打样回来后直接按单验收。
小技巧
- 安装验证一步都不能省——
ls四要素失败远比设计中段报错便宜 - 让 Agent 把每个价格都标 VERIFIED 或 ESTIMATE,混在一起就无法审计
- 手工焊的板坚持”无底部端接封装”原则,返修成本天差地别
- 长任务前确认 notify 中继在跑:进度回调让你随时知道布线没有静默挂死
- 复用库存:BOM 先对冲你已有的元件再下单,原型成本能砍掉一大截
常见踩坑
踩坑 1:只复制了 skills/pcb/ 目录
- 现象:Agent 能读 SKILL.md 但检查脚本报缺文件
- 原因:
SKILL.md以相对路径加载references/、scripts/、setup/,三者必须与它同级 - 解决:按安装命令把
skills/pcb/.、scripts、setup一起复制,并用ls验证
踩坑 2:EasyEDA MCP 桥没配好
- 现象:Agent 无法驱动画图,Phase 2 起卡死
- 原因:MCP 桥是外部依赖,不在 skill 安装范围内
- 解决:按
setup/easyeda-mcp.md逐步配置并确认 MCP 能列出 EasyEDA 工具
踩坑 3:浏览器没登录商城
- 现象:选型阶段抓不到实时价格,全部标 ESTIMATE
- 原因:Agent 在你已登录的浏览器里购物,登录态是前提
- 解决:按
setup/browser-logins.md登录 PCB 厂与元件商,购物车/付款保持人工
踩坑 4:权限卡风暴打断长布线
- 现象:桌面端每个浏览器动作都弹权限卡,自动布线频繁中断
- 原因:默认审批策略对高频动作不友好
- 解决:按
setup/auto-approve-*.md配置审批监听;注意它刻意不碰购物车与付款
踩坑 5:静默挂死误以为在工作
- 现象:布线跑了几小时没输出
- 原因:等待条件不满足时过滤器不吐行(作者参考项目实挂 10h53m)
- 解决:确认
scripts/notify/进度中继在工作;看门狗四态有速率下限
踩坑 6:项目极新,文档可能变
- 现象:命令或目录结构与本文不符
- 原因:仓库 2026-09-08 才创建,迭代快
- 解决:一切以官方 README 与 setup 文档为准
常见问题 FAQ
Q1: 它会自动下单付款吗?
A: 不会,也不会。Agent 只推进到预付款页并把点击交还给你;审批监听器在设计上就不接触购物车与付款。
Q2: 不用 EasyEDA Pro 行吗?
A: 不行,MCP 驱动的是 EasyEDA Pro。用 KiCad/Altium 的用户只能复用验证脚本与流程思想,画图环节需自行桥接。
Q3: 免费”免费 PCB”是什么意思?
A: 指多数打样厂对新用户/小板提供免费原型(如 100×100mm 内 2 层板)。Skill 从第一笔草图就把尺寸控制在该包络内,让打样成本为 0;超包络则失去该优势。
Q4: 和直接让 Claude 画 PCB 有什么区别?
A: 区别在验收 gate:插座方向、电容避让、keep-out 层别、Gerber 独立复验这些”理论不管”的检查被固化成脚本,且检查器刻意独立于 EDA——EDA 画错了它也能抓出来。
Q5: 支持什么 Agent 宿主?
A: 官方文档面向 Claude Code 与 Codex 桌面端(技能目录分别为 ~/.claude/skills/ 与 ~/.codex/skills/)。其他宿主未官方支持。
Q6: 真实成本怎么估?
A: 参考板案例在 docs/case-study.md,含缺陷与诚实成本表;BOM 每项标 VERIFIED/ESTIMATE,打样免费包络内 0 元,元件 + 运费为大头。
参考链接
本文基于公开资料(GitHub 官方 README 与 setup 文档)整理,AI 辅助生成,未做本地安装实测;采集日期 2026-09-12。功能与数据以官方仓库最新说明为准。
📊 评分与标签
评分说明
总分 8.4/10 · P_优选
📊 可观测社区指标(采集日期:2026-09-12)
- GitHub: daishuge/pcb-skill ★100, 🔱18(GitHub API 实时验证)
- License: MIT;Python;仓库创建 2026-09-08,最后推送 2026-09-10(4 天 100★/18 fork)
- 附带独立验证脚本族(placement/routing/verify/notify)与 setup 检查表
- ⚠️ 仓库极新(4 天),热度可持续性与长期维护待观察
评分依据可追溯至公开来源,每项分数均有明确理由和数据支撑。
📦 可安装性 2.4/2.5
- 安装为纯复制三目录(
skills/pcb/+scripts+setup)到~/.claude/skills/pcb或~/.codex/skills/pcb,命令含验证一步(ls四要素) - 无 pip/npm 依赖安装负担;SKILL.md 以相对路径加载同级目录,结构自洽
- 限制:EasyEDA Pro + MCP 桥 + 浏览器登录是外部前提,首次环境搭建 1-2 小时
- 竞品对比 1(通用 Claude skills 仓库安装器
npx skills add):一键装但无 EDA 环境检查;pcb-skill 用 setup 检查表强制过环境 gate - 竞品对比 2(自写 prompt 式 PCB 助手):无安装语义;pcb-skill 有明确目录契约与安装验证
🎯 实用性 2.4/2.5
- 覆盖硬件原型完整链路:概念→原理图→选型(实时比价+库存对冲)→布局布线→独立验证→预付款页,且下单/付款刻意保留人工
- 封装真实验收 gate(插座方向/电容避让/keep-out 层别),并有 docs/case-study.md 记录缺陷与诚实成本
- 稀缺组合:硬件工程 × Agent,目前站内同题材仅此一件
- 限制:绑定 EasyEDA Pro + Claude Code/Codex 桌面端生态;KiCad 用户只能复用验证脚本思想
- 竞品对比 1(直接让 LLM 画 PCB):无确定性验收,方向/避让类错误无法拦截
- 竞品对比 2(商业 EDA 的 AI 助手):集成在单一 EDA 内,无跨供应链采购联动
📖 文档质量 1.8/2.0
- README 结构清晰:三原则、四阶段 gate 表、目录树、四条工程规则(含 10h53m 静默挂死实例)
- setup/ 目录分 macOS/Windows 审批配置、EasyEDA MCP、浏览器登录三张检查表;另有 case-study
- 限制:正文以英文为主,中文用户需自行翻译;无视频/图示教程
- 竞品对比 1(多数 4 天新仓库):只有一句话 README;本项目文档成熟度远超同期
- 竞品对比 2(awesome 清单式仓库):纯链接无方法论;此处方法论与脚本一一对应
👥 社区活跃 1.4/1.5
- 4 天 100★/18 fork,fork 比例 18% 属健康工程型关注;最后推送 2026-09-10,2 天内仍活跃
- 来源:GitHub API(采集日期 2026-09-12)
- 限制:单人主导、无组织背书;issue 治理节奏未知
- 竞品对比 1(同类硬件 skill 多为 <10★):热度显著领先
- 竞品对比 2(成熟 EDA 插件生态):社区大但不含 Agent 工作流,方向不同
🔗 兼容性 0.4/1.5
- 官方支持面窄:仅 Claude Code / Codex 桌面端 + EasyEDA Pro + MCP;其他宿主与其他 EDA 均未支持
- 验证脚本族(verify/placement/routing)理论上可独立复用于其他 EDA 的 Gerber,但属自担风险用法
- 竞品对比 1(MCP 通用工具):宿主无关;pcb-skill 深度绑定桌面端浏览器与审批监听
- 竞品对比 2(纯 CLI 工具链):跨平台容易;本项目依赖宿主浏览器登录态
🏷️ 标签说明
- 硬件工程: 定位即硬件工程×Agent 的稀缺组合,封装真实验收 gate。来源:GitHub README
- PCB设计: 从概念到可制造 PCB 的全流程 skill。来源:GitHub README
- Agent Skills: 以 SKILL.md + references/scripts/setup 目录结构分发的标准 Agent Skill。来源:GitHub README
- EasyEDA: 经 MCP 协议驱动 EasyEDA Pro 完成画图。来源:GitHub README
- MCP: 通过 MCP 桥连接 EDA 与 Agent 宿主。来源:setup/easyeda-mcp.md
- 开源免费: MIT 许可。来源:GitHub
📋 来源核实
- ✅ 已核验: GitHub 仓库 — 2026-09-12 通过 GitHub API 实时核验:★100、🔱18、MIT、created 2026-09-08、pushed 2026-09-10、未归档
- ✅ 已核验: README.md — 2026-09-12 抓取全文:三原则、四阶段 gate 表、安装命令与目录结构、四条工程规则、case-study 链接
- ⚠️ 未实测:本站未在本地 Claude Code/Codex 中实际安装运行该 skill;EasyEDA MCP 桥配置与浏览器审批监听均以官方 setup 文档为准
- ⚠️ 局限:仓库创建仅 4 天,stars 可持续性、issue 响应与长期维护均无法判断;2 天 74★为 staging 源数据(采集时刻不同),本评分以 2026-09-12 API 实测 100★ 为准