convez.ai
SkillDevOps & InfraestruturaAvançado
ericshang98

HW Review — Assistente de Auditoria de Hardware

ericshang98/hw-review

Auditoria de hardware pin-a-pin com evidência de datasheet

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que realiza revisão rigorosa de projetos de hardware, desde esquemas até firmware, validando cada pino e componente contra datasheets oficiais. Extrai BOM de arquivos .epro2 (嘉立创 EDA), rastreia topologia de redes, verifica alinhamento software-hardware e impõe o princípio 'Evidence before claims' — nenhuma conclusão sem comprovação documental.

Instalação

$npx convez-ai ericshang98/hw-review

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
13
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Validação completa de esquemas eletrônicos antes de manufatura
  • Verificação de alinhamento entre firmware (DTS/Kconfig) e hardware real
  • Rastreamento de redes anônimas e mapeamento de pinos em projetos complexos
  • Auditoria de circuitos críticos (alimentação, RF, USB, carregamento)

Veredito

Skill altamente especializado para engenheiros de hardware que exigem rigor na validação — não faz concessões com 'talvez' ou 'confirme depois'. Reduz drasticamente ciclos de correção pós-manufatura através de auditoria sistemática com rastreabilidade em datasheet. Limitado a esquemas .epro2 (嘉立创), mas conceito transferível a outros formatos via Claude puro.

README

A tradução para o português deste README ainda está na fila.

🔍 hw-review

硬件开发助手 · 一个为 Claude Code 打造的 Skill

从原理图到固件,逐引脚、逐器件、有证据地审查你的硬件设计。

License Skill Python Deps


这是什么

hw-review 是一个 Claude Code 技能(Skill)。装好之后,当你让 Claude 「帮我看看这个原理图」「检查这个引脚接对了吗」「全面审查这个硬件项目」时,Claude 会自动加载这套审查流程,把自己变成一个较真到底的硬件审查搭档。

它的核心信念只有一句:

Evidence before claims, always. — 没有证据的判断不是判断,是猜测。

每一个结论都必须能追溯到 datasheet 的页码、参考设计的编号,或原理图里解析出的真实连线。它不接受「待确认」「基于一般经验」「差不多对」这类话术——硬件没有差不多。

能做什么

能力说明
📐 读原理图解析嘉立创 EDA .epro2 工程,提取完整 BOM、网络拓扑、引脚映射
📄 管理 Datasheet自动按四级优先级抓取每颗器件的资料(官方 PDF → 产品页参数 → 开发板原理图反推 → SDK 头文件),不放过晶振/天线等关键被动元件
🕸️ NET 拓扑追踪把 $1N52 这类匿名网络全部追踪到「哪个元件的哪个引脚」,脚本自动化,不手动猜
📌 逐引脚验证每颗 IC(不只是主芯片)的每个引脚都对照 datasheet 验证;连接器、二极管、MOSFET 的极性和映射一并查
⚡ 关键电路深度验证电源 / 射频 / USB / 充电四类关键电路不允许留 ⚠️,必须追查到 ✅ 或 ❌
🔗 软硬件对齐比对固件的 Devicetree / Kconfig / 驱动寄存器与硬件实际连接是否一致

它为什么不一样

大多数「AI 审查」会很客气地告诉你「这里建议确认一下」。这个 Skill 不会。它内置了一套铁律和一张偷懒借口表,专门用来对抗大模型偷工减料的倾向:

  • 「datasheet 找不到」→ 换关键词搜、搜 LCSC 产品页、搜开发板原理图反推
  • 「这个器件简单不用查」→ CUS08F30 接反了就不是保护而是短路
  • 「关键电路我标了 ⚠️ 让用户自己确认」→ ⚠️ 意味着你还没做完,不是把责任甩给用户
  • 「Phase 1 结束了不回头补资料」→ Phase 之间没有单向门,缺信息立刻回去搜

安装

这个 Skill 零外部依赖(解析脚本只用 Python 标准库),安装就是把目录放进 Claude Code 的 skills 目录。

方式一:git clone(推荐)

git clone <this-repo-url> ~/.claude/skills/hw-review

方式二:手动拷贝

下载本仓库,把整个文件夹放到:

~/.claude/skills/hw-review/

装好后重启 Claude Code 会话,技能即被自动发现。验证:直接问 Claude「我有哪些 skill」,或丢给它一个 .epro2 文件说「帮我看看这个原理图」。

也可以放进项目级的 .claude/skills/ 目录,只对单个项目生效。

用法

装好后无需记任何命令,用自然语言触发即可:

你说触发的流程
「帮我看看这个原理图」项目解析 + 原理图审查(Phase 1 + 2)
「帮我管理 datasheet」四级 datasheet 抓取流程
「这个引脚接对了吗」读 datasheet + NET 追踪 + 单引脚验证
「检查软硬件是否对齐」固件 DTS/Kconfig ↔ 原理图比对(Phase 3)
「全面审查这个项目」Phase 1 → 2 → 3 → 4 完整跑

单独运行 .epro2 解析脚本

不通过 Claude 也能直接用解析器:

python3 parse_epro2.py your_project.epro2 ./output/

输出:记录类型统计、文档结构(含多版本)、BOM、Designator 列表、NET 与 PAD_NET 连接关系,并把结构化结果写入 output/parsed_data.json。

工作流程

Phase 1  项目解析与文档准备   → 解压 .epro2、提取 BOM、抓全 datasheet
Phase 2  原理图审查           → NET 拓扑追踪 + 逐 IC 逐引脚验证 + 关键电路深度验证
Phase 3  软硬件对齐(如有固件) → DTS/Kconfig/驱动 ↔ 原理图
Phase 4  构建验证(如有固件)   → west build / flash / 基本功能验证

每个 Phase 都有明确的完成标准,未满足不得进入下一阶段。

产出物

文件内容
datasheets/各芯片手册 PDF 与参数文件
datasheets/index.mddatasheet 索引,无 ❌ 状态
hw-review-status.mdBOM、文件清单、引脚分配、审查进度
hw-review-findings.md问题清单,每条附证据来源
hw-lessons-learned.md踩坑记录

templates/ 目录里提供了后三个文件的空白模板。

仓库结构

hw-review/
├── SKILL.md            # 技能主体:审查哲学、铁律、四大能力、工作流程
├── parse_epro2.py      # 嘉立创 EDA .epro2 解析器(纯标准库)
├── templates/          # 产出物模板
│   ├── hw-review-status.md
│   ├── hw-review-findings.md
│   └── hw-lessons-learned.md
├── references/         # 扩展参考资料(可自行补充)
├── README.md
└── LICENSE

适用范围与限制

  • 原理图解析目前专门支持嘉立创 EDA 的 .epro2 格式;KiCad .kicad_sch、Altium .SchDoc 可由 Claude 读取审查,但没有专用解析脚本。
  • datasheet 抓取依赖联网搜索;Claude Code 需具备 WebSearch / WebFetch 能力。
  • 这是一套审查辅助工具,最终设计责任仍在工程师本人——它的价值在于逼出证据、堵住偷懒,而不是替你签字。

贡献

欢迎 PR:补充其他 EDA 格式的解析器、扩充 references/ 里的器件参考电路、改进偷懒借口表。

License

MIT © 2026 Shang

Ver o original no GitHub

Bom para

Relacionados