关于 kicad-export
kicad-export 是使用 kicad-cli 检查 KiCad 设计并生成制造文件的技能。它指导命令选择,并根据制造商要求调整导出内容。
主要功能
- 01生成 ERC 和 DRC 报告
- 02导出 Gerber 和钻孔文件
- 03生成坐标与 BOM 文件
- 04转换 JLCPCB 和 NextPCB 坐标文件
- 05导出原理图和 PCB 预览
适用场景
- 01制造前检查 KiCad 设计
- 02为 JLCPCB 或 NextPCB 准备制造文件
- 03生成可复用的项目专属导出命令
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ american-embedded/ kistack --skill kicad-export安装后在 Claude Code 中输入/kicad-export确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/kicad_cli_command_fp_export_svg.mdkicad_cli_command_fp_upgrade.mdkicad_cli_command_introduction.mdkicad_cli_command_jobset_run.mdkicad_cli_command_pcb_drc.mdkicad_cli_command_pcb_export_3dpdf.mdkicad_cli_command_pcb_export_brep.mdkicad_cli_command_pcb_export_drill.mdkicad_cli_command_pcb_export_dxf.mdkicad_cli_command_pcb_export_gencad.mdkicad_cli_command_pcb_export_gerbers.mdkicad_cli_command_pcb_export_glb.mdkicad_cli_command_pcb_export_hpgl.mdkicad_cli_command_pcb_export_ipc2581.mdkicad_cli_command_pcb_export_ipcd356.mdkicad_cli_command_pcb_export_odb.mdkicad_cli_command_pcb_export_pdf.mdkicad_cli_command_pcb_export_ply.mdkicad_cli_command_pcb_export_pos.mdkicad_cli_command_pcb_export_ps.mdkicad_cli_command_pcb_export_stats.mdkicad_cli_command_pcb_export_step.mdkicad_cli_command_pcb_export_stl.mdkicad_cli_command_pcb_export_stpz.mdkicad_cli_command_pcb_export_svg.mdkicad_cli_command_pcb_export_u3d.mdkicad_cli_command_pcb_export_vrml.mdkicad_cli_command_pcb_export_xao.mdkicad_cli_command_pcb_import.mdkicad_cli_command_pcb_render.md详细介绍
使用 kicad-cli 解析此文档,并使用必要的项目生成 ERC/DRC 报告,然后根据用户选择的制造商,继续创建 GERBER、钻孔文件、位置文件和 BOM 文件。为确保结果具有确定性,请将命令顺序保存到 Python 或 bash 脚本中,并针对每个项目进行修改。
JLCPCB 和 NextPCB 的位置文件需要采用特定格式: 一个包含 5 列的 .csv 文件:Designator、Mid X、Mid Y、Layer(T 或 B)和 rotation KiCad 不支持此格式,因此请使用 scripts/convert_position.py 下的 Python 脚本转换。如果用户未安装 Python,请在对其计算机进行更改之前告知用户;但如果用户已指定使用虚拟环境,或你在调用此技能的项目根目录中看到虚拟环境,则无需告知。
JLCPCB 的 BOM 还需要 LCSC 零件编号。请确保 JLCPCB BOM 预设可用;如果不可用,请告知用户需要添加该预设。
确定需要使用哪些 PCB 和原理图导出命令(文档位于此技能下的 references/ 目录中)。例如,我们通常使用以下命令集:
kicad-cli version
kicad-cli sch erc
--output build/-erc.rpt
--format report --units mm
--severity-warning --severity-error
--exit-code-violations .kicad_sch
kicad-cli pcb drc
--output build/-drc.rpt
--format report --units mm
--severity-warning --severity-error
--refill-zones --schematic-parity
--exit-code-violations .kicad_pcb
kicad-cli sch export pdf
--output build/schematic.pdf
[--variant ] [--theme ]
.kicad_sch
kicad-cli sch export bom
--preset JLCPCB --format-preset CSV
--output build/bom_JLCPCB.csv
[--variant ] .kicad_sch
kicad-cli sch export bom
--preset NextPCB --format-preset CSV
--output build/bom_NextPCB.csv
[--variant ] .kicad_sch
kicad-cli sch export netlist
--format kicadxml
--output build/llm-review/netlist.xml
[--variant ] .kicad_sch
kicad-cli sch export netlist
--format kicadsexpr
--output build/llm-review/netlist.kicadsexpr
[--variant ] .kicad_sch
kicad-cli sch export bom
--output build/llm-review/components.csv
--fields Reference,Value,Footprint,Datasheet,DNP,EXCLUDE_FROM_BOM,EXCLUDE_FROM_BOARD
--labels Reference,Value,Footprint,Datasheet,DNP,ExcludeFromBOM,ExcludeFromBoard
--sort-field Reference
[--variant ] .kicad_sch
kicad-cli pcb export gerbers
--output build/gerbs
--layers
--crossout-DNP-footprints-on-fab-layers
--sketch-DNP-footprints-on-fab-layers
--subtract-soldermask
--precision 5 .kicad_pcb
kicad-cli pcb export drill
--output build/gerbs
--format excellon
--drill-origin absolute
--excellon-units in
--excellon-zeros-format decimal
--gerber-precision 5 .kicad_pcb
kicad-cli pcb export pos
--output build/positions_raw.csv
--format csv --units mm
--side both --exclude-dnp
--use-drill-file-origin .kicad_pcb
kicad-cli pcb export pdf
--output build/pcb_layout
--layers
--black-and-white
--crossout-DNP-footprints-on-fab-layers
--sketch-DNP-footprints-on-fab-layers
--include-border-title
--drill-shape-opt 2
--mode-multipage .kicad_pcb
kicad-cli pcb export step
--output build/board.step
--force --subst-models --no-dnp
.kicad_pcb
kicad-cli pcb render
--output build/top.png
--width 1280 --height 720
--background transparent --quality basic
--preset follow_pcb_editor
--light-top 0 --light-bottom 0
--light-side 0.5 --light-camera 0
--light-side-elevation 60
--side top .kicad_pcb
kicad-cli pcb render
--output build/bottom.png
--width 1280 --height 720
--background transparent --quality basic
--preset follow_pcb_editor
--light-top 0 --light-bottom 0
--light-side 0.5 --light-camera 0
--light-side-elevation 60
--side bottom .kicad_pcb
除非用户另有说明,否则 DRC 和 ERC 错误将导致导出失败。如果导出失败,你可以提示他们:“是否继续导出?请回复 OVERRIDE 以重新开始。”