pcb

一个用于描述和构建PCB电路板的命令行工具与语言工具链。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pcb。
它的用途是:一个用于描述和构建PCB电路板的命令行工具与语言工具链。
完整的 Skill 内容见:https://321skill.com/skills/pcb/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我用 pcb 工具创建一个简单的 LED 闪烁电路项目。” 它会引导你创建 `blinky.zen` 文件,定义电源、电阻、LED 和电路板。然后,你可以运行 `pcb build blinky.zen` 来验证设计,再运行 `pcb layout blinky.zen` 生成 KiCad 文件,从而在图形界面中完成布局。

介绍

pcb 是一个用于电路板项目的命令行工具,它基于 Zener 语言(一种 Starlark 方言)来描述 PCB 原理图。该工具的核心功能是构建这些设计、管理项目依赖,并生成 KiCad 布局文件,将电路设计从代码描述转化为可生产的工程文件。

用户通过编写 .zen 文件来定义电路模块、组件和连接关系,然后使用 pcb build 命令验证和构建设计,再通过 pcb layout 命令生成 KiCad 项目文件,从而在 KiCad 中进行进一步的布局和布线。整个工具链通过一个版本化的 pcbc 工具进行管理,支持安装、更新和修复。

它非常适合从事硬件开发、嵌入式系统或电子工程的全栈开发、后端开发工程师,以及需要进行电路原型设计或教学演示的高校学生和学术研究者。对于希望将软件工程中的版本控制、依赖管理和自动化流程引入硬件设计流程的团队尤其有价值。

需要注意的是,虽然生成和编辑布局需要 KiCad 10.x,但构建和验证 Zener 文件本身不需要。此外,原生 Windows 支持尚处于实验阶段,如果遇到问题,建议使用 WSL2 环境。

核心特点

它将硬件设计(PCB)代码化,引入了类似软件开发的依赖管理和版本控制工作流,而不仅仅是 KiCad 文件的生成器或封装。其核心的 Zener 语言允许开发者以编程方式描述和复用电路模块。

注意事项

不适合仅需使用图形界面进行一次性或简单电路设计的用户,也不适合不熟悉命令行和版本控制概念的硬件工程师。

常见问题

使用 pcb 需要先安装 KiCad 吗?

构建和验证 Zener 代码不需要 KiCad,但生成和编辑最终的 PCB 布局文件需要 KiCad 10.x。

pcb 支持 Windows 吗?

支持,但原生 Windows 支持是实验性的,如果命令不工作,建议使用 WSL2 环境。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pcb/raw/index.md 读取 pcb 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。