PCB Skill

Agent Skill:从硬件想法一路做到可下单焊接的 PCB——原理图、选型、布局、布线、验证、采购到预付款页。运行于 Claude Code/Codex 桌面端,经 MCP 驱动 EasyEDA Pro。Python + MIT。

📊 评分明细

📦 打包完整度
2.1 2.1 / 2.5
🎯 实用性
2.1 2.1 / 2.5
📖 文档清晰度
1.7 1.7 / 2
👥 社区影响力
1.3 1.3 / 1.5
🔗 集成度
1.3 1.3 / 1.5

🎯 适用场景

硬件工程PCB设计Agent SkillsEasyEDAMCP开源免费

这是什么?适合谁?

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 厂与元件商城的浏览器。

准备工作

  1. 安装:git clone 仓库后把 skills/pcb/scripts/setup/ 三个目录复制到技能目录(见下方命令)
  2. 环境:Claude Code(~/.claude/skills/pcb)或 Codex(~/.codex/skills/pcb)、EasyEDA Pro、Python
  3. 登录:浏览器登录你的 PCB 厂(如 JLCPCPC)与元件供应商账号
  4. 成本:Skill 本身 MIT 免费;打样与元件按 BOM 计费(设计目标之一是免费原型包络内 0 元打样)
  5. 时间:环境准备(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 文档(点亮顺序、首测项)与验证脚本联动,打样回来后直接按单验收。

小技巧

  1. 安装验证一步都不能省——ls 四要素失败远比设计中段报错便宜
  2. 让 Agent 把每个价格都标 VERIFIED 或 ESTIMATE,混在一起就无法审计
  3. 手工焊的板坚持”无底部端接封装”原则,返修成本天差地别
  4. 长任务前确认 notify 中继在跑:进度回调让你随时知道布线没有静默挂死
  5. 复用库存:BOM 先对冲你已有的元件再下单,原型成本能砍掉一大截

常见踩坑

踩坑 1:只复制了 skills/pcb/ 目录

  • 现象:Agent 能读 SKILL.md 但检查脚本报缺文件
  • 原因:SKILL.md 以相对路径加载 references/scripts/setup/,三者必须与它同级
  • 解决:按安装命令把 skills/pcb/.scriptssetup 一起复制,并用 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★ 为准