claudeers.
// Data & Analytics

pcb-agent-workflow

用 Claude Code/Codex 搭配 KiCad 10 設計 PCB、交 JLCPCB 製造的工作流程:流程文件、專案範本、JLC 客服溝通 skill、生產稿比對腳本與範例設計

// Data & Analytics[ cli ][ claude ]#claude#data◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
98/100
last commit 22 days ago
last release none
releases 0
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up pcb-agent-workflow (claude-plugin project) into my current project.
Found on https://claudeers.com/pcb-agent-workflow
Repo: https://github.com/John-owo/pcb-agent-workflow
Homepage/docs: —
Detected install method: claude-plugin → /plugin install pcb-agent-workflow@John-owo/pcb-agent-workflow
Category: data. Platforms: cli.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add John-owo/pcb-agent-workflow
/plugin install pcb-agent-workflow@John-owo/pcb-agent-workflow
// or clone
git clone https://github.com/John-owo/pcb-agent-workflow

// compatibility

Platformscli
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

pcb-agent-workflow

用 Claude Code 或 Codex 當助手,在 KiCad 10 設計 PCB、交 JLCPCB 製造的一套工作流程。

這套流程來自一塊 4 層 GNSS 測試板(u-blox MAX-M10S,25 × 36.5 mm)從設計、審查、報價、送審、客服往返到確認生產稿的實際經驗。重複有用的做法寫成文件和 skill;踩過的雷寫成檢查項目。

第一次做 PCB? 從 新手入門 開始:從安裝 KiCad 走到在 JLC 下單,每一步寫你要做什麼、可以請 agent 做什麼、怎麼確認做對了。其他文件之後再看。

內容

路徑內容
docs/getting-started.md新手入門:第一塊板的範圍、環境、原理圖、選料、板子規則、佈線、匯出、下單
docs/first-board-checklist.md送廠前的檢查清單,給人看,也給 agent 審查用
docs/glossary.md術語表:Gerber、BOM、CPL、DFM、工藝邊、Basic/Extended 料等
docs/workflow/collaboration.md人與多個 agent 協作:單一寫入者、WORKLOG、接手順序、審查最多兩輪、哪些動作要使用者同意
docs/workflow/kicad-tools.mdKiCad 原生 CLI 與 KiCad MCP 的分工、常用命令、修改 PCB 前的保全
docs/workflow/release-package.md固定發行包:內容、雜湊清單、release-checks、版本資料夾命名
docs/workflow/jlc-ordering.mdJLC 下單:服務等級、BOM/CPL、配料核對、壓成本、送單設定、付款後流程
skills/jlc-support/跟 JLC 客服、工程、業務窗口溝通的 skill:寫信結構、六種範本、期限計算腳本、工具搭配、停止條件
skills/jlc-production-review/審查工廠生產稿與貼裝確認的 skill:把工廠 CAM 稿對齊回原始 Gerber 逐層比對、分類差異、核對貼裝;附比對腳本與 BOM/CPL 檢查
skills/readable-schematic-layout/把原理圖與佈局畫成人類好讀、好除錯的 skill:內建 symbol、電源 symbol、實際畫線、依流向分區、文字不重疊;附 netlist 比對與腳號對焊盤檢查腳本,證明只改畫法、沒改電路。獨立版本見 John-owo/kicad-readable-schematic
templates/新專案用的 AGENTS.md、CLAUDE.md、WORKLOG.md、README.md,以及 KiCad 專案的 .gitignore
scripts/發行包打包驗證、Konnect stdio 呼叫器、本 repo 的隱私掃描與 skill 檢查(各 skill 專用的腳本放在 skill 自己的 scripts/)
examples/max-m10s-breakout-revc/實際下單過的範例設計包:KiCad 原生檔、Gerber、BOM、CPL、裝配圖、驗證紀錄

流程總覽

flowchart LR
  A[設計<br/>KiCad 10] --> B[驗證<br/>ERC / DRC / agent 審查]
  B --> C[固定發行包<br/>雜湊清單]
  C --> D[上傳與送審<br/>配料核對]
  D --> E[付款]
  E --> F[生產稿比對]
  F --> G[使用者確認]
  G --> H[到貨與實測]
  S([jlc-support<br/>客服與工程溝通]) -.-> D
  S -.-> E
  S -.-> F
  R([jlc-production-review<br/>生產稿與貼裝審查]) -.-> F

開始使用

新專案

把 templates/ 裡的四個 Markdown 檔複製到 PCB 專案根目錄,把 <...> 換成自己的內容;kicad-project.gitignore 複製後改名為 .gitignore。專案已經有 README.md 的話,不要直接覆蓋,把範本的段落合併進去。之後每次接手,agent 會從 README.md 和 WORKLOG.md 讀起。

安裝 jlc-support skill

Claude Code 與 Codex 共用同一份 SKILL.md:

git clone https://github.com/John-owo/pcb-agent-workflow.git

先建立 skills 資料夾,再複製。沒有這個資料夾時,複製指令會把 skill 的內容直接攤在 skills/ 底下,agent 就找不到它。

Claude Code(macOS/Linux/Git Bash):

mkdir -p ~/.claude/skills && cp -r pcb-agent-workflow/skills/jlc-support ~/.claude/skills/

Codex:

mkdir -p ~/.codex/skills && cp -r pcb-agent-workflow/skills/jlc-support ~/.codex/skills/

Windows PowerShell(Codex 的話把 .claude 換成 .codex):

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Copy-Item -Recurse -Force pcb-agent-workflow\skills\jlc-support "$HOME\.claude\skills\"

裝好之後,~/.claude/skills/jlc-support/SKILL.md(或 .codex 底下的同一路徑)要存在。更新時重跑同一組指令即可。

只想在單一專案使用,就放到該專案的 .claude/skills/jlc-support/。安裝後重新開一個 agent 對話,跟它說「幫我寫信催 JLC 的 DFM」或「訂單被取消了,幫我追問」,就會套用這個 skill。

安裝 jlc-production-review skill

步驟同上,把指令裡的 jlc-support 換成 jlc-production-review。比對腳本需要 Python 3.12 與固定版本的套件:在 skill 資料夾裡執行 python -m pip install -r scripts/requirements-cam.txt(建議裝在 venv);check_bom_cpl.py 只用標準庫。

安裝 readable-schematic-layout skill

步驟同上,把指令裡的 jlc-support 換成 readable-schematic-layout。裝好後跟 agent 說「把原理圖改成好讀的畫法,不要改電路」或「原理圖文字重疊,整理一下」就會套用。比對腳本只用 Python 標準庫,用法見 SKILL.md 第 3 節。

這個 skill 也單獨放在 John-owo/kicad-readable-schematic,給只想要這個 skill 的人使用;兩邊內容相同,以本 repo 為準同步。

搭配的 KiCad 分析 skill

原理圖分析、BOM、DRC 審查、EMC、SPICE 等 skill 使用 aklofas/kicad-happy(MIT)。本 repo 不附副本,請依該 repo 的說明安裝。這套流程實際用到的有 kicad、bom、jlcpcb、lcsc、datasheets、emc、spice。

docs/agents 是什麼

docs/agents/ 是給 mattpocock/skills 那套工程類 skill(triage、to-tickets、to-spec 等)讀的設定:issue 記在哪裡、triage 標籤叫什麼。沒安裝那套 skill 就用不到,可以忽略。

Codex 與 Claude Code 交接

兩個 agent 輪流接手同一個任務時,交接格式見 John-owo/codex-cc-handoff。

核心原則

  • 一個工作目錄同時只有一位寫入者。 換手時在 WORKLOG 記錄 owner 與停止點。
  • 改 PCB 前先保全完整備份。 雜湊清單只能識別檔案,不能還原。
  • ERC/DRC 通過,不等於電氣正確、板廠接受或實板能動。
  • 付款、送單、寄信、確認生產稿,每一次都等使用者同意。 agent 做到起草和準備為止。唯一的例外是催辦與純技術澄清:使用者可以說明範圍和期限,事先授權。
  • 固定發行包與動態進度分開。 交給工廠的版本不再改;訂單進度另外記。

限制

  • 範例板完成了 ERC/DRC 與 agent 審查,也實際送單了,但還沒有實板測試。範例是送單時的發行包;工廠 CAM 之後做的微調不在裡面。實測程序與結果見 examples/max-m10s-breakout-revc-tests。
  • JLC 的期限、價格、料庫狀態是 2026-09 的觀察,以當下的網站和信件為準。
  • 流程以 Windows、KiCad 10、JLCPCB 為主要環境。其他板廠可以參考溝通原則,但網站流程不同。

支援範圍

這套流程只在下面的環境驗證過:

項目支援
作業系統Windows
EDAKiCad 10
agentClaude Code、Codex(兩者都要能用)
板廠JLCPCB
收貨地台灣(順豐)

其他環境(macOS、Linux、其他 KiCad 版本、PCBWay 等其他板廠)可能可以用,但沒有驗證。這類 issue 會標成 wontfix,回覆「可能可用,未驗證」;溝通原則不受板廠限制,可以照用。

授權

MIT,見 LICENSE。範例中改自 KiCad 官方元件庫的 footprint 與 symbol,以及其他第三方內容的來源,見 NOTICE。原廠 datasheet 不隨附,範例 README 列有原廠連結。

// faq

What is pcb-agent-workflow?

用 Claude Code/Codex 搭配 KiCad 10 設計 PCB、交 JLCPCB 製造的工作流程:流程文件、專案範本、JLC 客服溝通 skill、生產稿比對腳本與範例設計. It is open-source on GitHub.

Is pcb-agent-workflow free to use?

pcb-agent-workflow is open-source under the MIT license, so it is free to use.

What category does pcb-agent-workflow belong to?

pcb-agent-workflow is listed under data in the Claudeers registry of Claude-compatible tools.

31 views
★ 72 stars
unclaimed
updated about 1 month ago

// embed badge

pcb-agent-workflow on Claudeers
[![Claudeers](https://claudeers.com/api/badge/pcb-agent-workflow.svg)](https://claudeers.com/pcb-agent-workflow)

// retro hit counter

pcb-agent-workflow hit counter
[![Hits](https://claudeers.com/api/counter/pcb-agent-workflow.svg)](https://claudeers.com/pcb-agent-workflow)

// reviews

// guestbook

0/500

// related in Data & Analytics

🔓

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

// datacoreyhaines31/⟨JavaScript⟩★ 59,974◷ MIT[ claude ]
🔓

Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini 3.1 P…

// datarouter-for-me/⟨Go⟩★ 58,873◷ MIT[ claude ]
🔓

Apache Airflow - A platform to programmatically author, schedule, and monitor workflows

// dataapache/⟨Python⟩★ 47,441◷ Apache-2.0[ claude ]
🔓

CLI tool for configuring and monitoring Claude Code

// datadavila7/⟨Python⟩★ 33,876◷ MIT[ claude ]
→ see how pcb-agent-workflow connects across the ecosystem