kicad-layout

此技能旨在帮助 Agent 做好布局。它帮助 Agent 了解自身的不足，并鼓励它完成那些通常会忽略的布局步骤。本技能专为 GPT-6-Astra 和 claude-fable-5.1 编写，针对性地解决了它们的问题，但其他 Agent 也可以使用。对于人类：随着模型和工具不断进步，其中很多内容会变成不必要的冗余，请确保及时更新。

在原位编辑当前电路板

对于常规布局、布线和清理工作，请从项目根目录的 .backplane.json（project 或显式指定的 pcb）中解析规范电路板路径，并保持该路径不变。使用 IPC SaveDocument 或工具的 --save，将有意义的阶段成果（包括未完成的工作）保存到该路径；不要等到最终电路板完成后才保存。读回已保存的路径，然后用 viewer_show 显示该规范文件，接着确认查看器和历史记录都指向这个已保存文件；如有不一致，请报告。保留 <native-filename>.backplane.json 配套文件和现有历史记录。

将备份和中间输出保存在单独的备份／构建目录中。如果工具写入了暂存文件，请先验证，再备份并将其提升到规范路径，然后再继续。不要只将进度留在内存中或最终副本中，也不要悄悄更改当前活动文件名。只有在明确要求进行实验时，才使用替代电路板，并清楚标明。电路板只能由一个 Agent／进程写入；其他 Agent 可以检查或准备要集成的更改。

• 确保每个部件的封装都合适，并尽量找到合适的 3D 模型。如果找不到合适的 3D 模型，就自行创建低精度模型。保留项目的库结构，但优先将内容放入项目自包含的库文件中。
• 如果可以使用 KiCad IPC（或同类型）工具，或 kiPy，请始终优先使用它们。
• 对于元件布局，请使用布局放置技能：该技能会根据各连接可容忍的距离对元件排序，并提供 IPC 脚本来移动元件、检查距离和可布线性。
• 关于自动布线：除非有明确指示，否则尽量不要使用任何自动布线软件，而应手动自行布线。如果电路板变得非常复杂，包含细间距元件和数千条网络，可以选择使用自动布线工具，例如 tscircuit 或 freerouting。但应尽可能避免使用。
• 除非另有明确指示，否则可以并且应该调整原理图，让布局更合理、更简洁。进行引脚交换等操作，让走线更短、层间跳转更少，整体也更整洁。但这有风险，进行引脚交换时务必谨慎，确保不会影响项目目标或功能，也要格外小心，避免在原理图中引入新问题。
• 同样，在布局方面，除非另有指示，否则可以调整高层次的元件布局，直到电路板易于布线且功能完整。
• 以上所有工作也应遵循布局和布线最佳实践。需要在高层次和低层次上权衡最佳实践，并判断各项实践的必要性。如有任何疑问，都应进行思考。布线很快但实践不当的电路板毫无用处。你已经了解大多数此类实践，因此请据此合理行动。如果不确定某项理论或实践，可以在线查证。
• 有些经常被 Agent 忽视的具体概念／实践（但并非全部）需要特别考虑：良好的过孔缝合、共面地对走线阻抗的影响、高频无效铜皮及其耦合噪声、所有重要信号的清晰回流路径等，请酌情处理。
• 确保连接器易于接入。确认连接器应朝向哪一侧，以及导线将从哪里引出；确保 3D 模型中标明这些信息，必要时还可以查看快速 3D 渲染进行验证。
• 如果深入布局后发现不满意，可以从更高层次重新思考，并在适当时决定重做部分甚至几乎全部布局。