mcpField
K
kicad-layout

kicad-layout

github.com/american-embedded其他415173 次安装3 天前更新
代码仓库

关于 kicad-layout

指导 AI Agent 编辑和布线 KiCad 电路板,并持续使用项目指定的主板文件。技能强调谨慎布局、验证和布线规范;可用时优先使用 IPC 类工具或 kiPy。

主要功能

  1. 01在配置的主板文件中编辑
  2. 02保存阶段成果并保留备份
  3. 03提供封装与 3D 模型指导
  4. 04优先手动布线
  5. 05关注信号完整性与回流路径

适用场景

  1. 01继续处理当前主板布局
  2. 02检查连接器的可达性和朝向
  3. 03通过元件布局降低布线复杂度
  4. 04审视高频布局注意事项

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/american-embedded/kistack --skill kicad-layout

安装后在 Claude Code 中输入/kicad-layout确认已加载。

详细介绍

这项技能旨在帮助 Agent 完成良好的布局。它能帮助 Agent 了解自身的不足,并鼓励它完成通常会忽略的布局步骤。该技能专为 GPT-6-Astra 和 claude-fable-5.1 编写,并针对这两个模型进行了优化,但其他 Agent 也可以使用。对于人类:随着模型和工具不断进步,其中很多内容会变得多余。请确保及时更新。

直接编辑当前电路板

对于常规的元件摆放、布线和整理工作,首先确认项目配置的规范 .kicad_pcb 路径,也就是项目或查看器打开的电路板文件,并始终使用该路径。每完成一个有意义的阶段,就将结果保存到该路径,以便当前电路板和协作者都能看到进展。将备份和中间工具输出放在单独的备份或构建目录中。如果工具写入了暂存文件或备用文件,请先验证,再将结果连同备份一起移回规范路径,然后再继续;不要悄悄切换当前文件名。只有在用户明确要求进行实验或采用备用设计时,才使用备用电路板,并清楚标明。协调好文件的所有权,确保同一时间只有一个 Agent 或进程写入当前电路板;其他 Agent 可以检查电路板,或准备待集成的修改。

  • 确保每个元件都有合适的封装,并尽量找到质量不错的 3D 模型。如果找不到合适的 3D 模型,就自行创建低保真度模型。保留项目的库结构,但优先将内容放入独立的项目库文件中。
  • 如果可以使用 KiCad IPC(或类似)工具,或 kiPy,请始终优先使用。
  • 摆放元件时,使用 layout-placement 技能:它会根据各连接所能容忍的距离对元件排序,并提供用于移动元件、检查距离和可布线性的 IPC 脚本。
  • 关于自动布线:除非另有指示,否则尽量不要使用任何自动布线软件,而应自行手动布线。如果电路板变得非常复杂,包含间距很小的元件和约数千条网络,可以考虑使用自动布线工具,例如 tscircuit 或 freerouting;但应尽可能避免。
  • 除非另有明确指示,否则可以修改原理图,让布局更合理、更整洁。可以交换引脚之类的操作,以缩短走线、减少换层,并让整体布局更整洁。但这样做有风险,进行引脚交换时务必小心,不要影响项目目标或功能,也要谨慎避免在原理图中引入新问题。
  • 同样,除非另有指示,否则可以调整布局中的高层级摆放,直到电路板易于布线且功能完整。
  • 以上所有工作还应遵循布局和布线的最佳实践。你需要思考高层级和低层级的最佳实践,以及每一项的必要程度。每当有任何疑问时,都要在各个层面进行判断。采用不良实践快速布线的电路板毫无用处。你已经了解其中大部分实践,因此请据此合理行事。如果不确定某项理论或实践,可以随时上网查阅。
  • 以下是 Agent 常常忽略的部分概念和实践(并非全部),你需要特别留意:合理的过孔缝合、共面接地对走线阻抗的影响、高频无效铜皮及其传导的耦合噪声,以及为所有重要信号提供干净的回流路径;请酌情处理。
  • 确保连接器便于使用。检查连接器应朝向哪一侧、线缆将从何处引出,并确保这些信息在 3D 模型中有所体现;如有需要,也可以查看快速 3D 渲染来进行验证。
  • 如果在深入设计后发现布局有不理想之处,可以从更高层面重新考虑,并视情况决定重做其中一部分,甚至几乎全部。

评论

支持 Markdown