HW Review — Assistente de Auditoria de Hardware
ericshang98/hw-review
Auditoria de hardware pin-a-pin com evidência de datasheet
Ver no GitHubSkill 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-review1 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
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
从原理图到固件,逐引脚、逐器件、有证据地审查你的硬件设计。
这是什么
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.md | datasheet 索引,无 ❌ 状态 |
hw-review-status.md | BOM、文件清单、引脚分配、审查进度 |
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