前言¶
做智能硬件时，Agent 很容易只盯住某一段：写固件时不管 DFM，画原理图时不管 SRRC，排 NPI 时又缺 EVT/DVT/PVT 的交付物清单。团队 wiki 往往按部门分栏，和「从 PRD 到量产」的真实依赖也对不齐。
下面介绍 SkillHub 上的 Smart Hardware Reference：把智能硬件开发整理成任务清单、结构槽位和范本框架，并声明如何交给 Universal Task OS（UTOS）做管线编排与文档产出。它解决的是「领域知识怎么结构化、怎么被 Agent 按阶段消费」，而不是替代 EDA 或产线系统。
这是什么¶
Smart Hardware Reference 是面向 Agent 的 智能硬件开发知识参考库，在 SkillHub 上归类为知识管理（页面标签含知识库问答、资料整理、信息检索）。作者为波动几何（王教成）；SkillHub 页面显示维护方为科恩实验室安全审核、云鼎实验室安全审核，当前版本 v1.0.0。
一句话定位：它是 Universal Task OS 的领域负载物——提供「有哪些任务、每种任务要填哪些槽位、优秀文档长什么样」，执行框架本身在 UTOS；未安装 UTOS 时仅支持只读查阅，不能代为编排产出管线。
社区页面：https://skillhub.cn/skills/smart-hardware-reference
Skill 包名：@indiv-wangjiaocheng/smart-hardware-reference
说明：任务线索中的地址 https://api.skillhub.cn/user_e02e04b8/smart-hardware-reference 在 HTTP 抓取时返回 405；SkillHub 上 user_e02e04b8/smart-hardware-reference 路径显示 Skill 未找到。实际安装与下载走 indiv-wangjiaocheng 命名空间（CLI 下载地址形如 api.skillhub.cn/api/v1/download?slug=smart-hardware-reference&namespace=indiv-wangjiaocheng）。
核心功能¶
三层参考结构¶
技能包内用三个 reference 文件分层组织（路径相对于 Skill 根目录）：
references/hardware-catalog.md— 开发任务清单与任务依赖拓扑（9 域、68 种任务类型）。references/structure-requirements.md— 每种任务类型的结构要求与组件槽位（清单法输入）。references/exemplars.md— 优秀范本框架（样本法输入；部分槽位标注需企业脱敏填充）。
九域生命周期覆盖¶
按产品生命周期划分的域与任务规模（摘自 SKILL.md）：
| 域 | 任务数 | 典型任务 |
|---|---|---|
| H1 需求与市场 | 7 | 产品需求 PRD、竞品拆解、用户场景、定价策略 |
| H2 架构与规格 | 8 | 系统架构、BOM 初版、功耗预算、尺寸堆叠 |
| H3 硬件设计 | 10 | 原理图、PCB Layout、射频调试、电源、EMC 预评估 |
| H4 嵌入式软件 | 8 | 固件架构、驱动、协议栈、OTA、低功耗 |
| H5 结构与 ID | 6 | ID、结构、散热、防水防尘、材料选型 |
| H6 原型与验证 | 7 | 原型计划、功能验证、可靠性测试、安规预审、认证申请 |
| H7 量产与供应链 | 8 | 工艺文件、试产报告、供应商管理、质控、包装 |
| H8 运维与服务 | 8 | 云平台、数据分析、售后、固件迭代、召回预案 |
| H9 项目管理 | 6 | 项目计划、风险、跨部门协同、里程碑、成本 |
与 UTOS 的分工¶
| 本 Skill 提供 | UTOS 消费方式 |
|---|---|
| 开发任务清单 | 内容轴·清单法的成品目录 |
| 结构要求槽位 | 内容轴·清单法的组件清单 |
| 优秀范本 | 内容轴·样本法的样本 |
| 任务依赖拓扑 | 执行轴·管线编排的依赖输入 |
激活时会检测 universal-task-os 是否已安装；未安装则尝试自动安装。安装失败则进入只读模式：可查阅清单与要求，拒绝文档产出、管线编排、内容生成类任务。
领域特有维度¶
技能内显式列出三类硬件常见约束（非泛泛软件需求）：
- 硬软一体：MCU 选型、固件架构、OTA、低功耗；Wi-Fi/BLE 等连接与天线；设备接入与 FOTA 等云端协同。
- 制造约束：DFM、DFT、供应链与 MOQ/LTA 等。
- 合规认证：CCC/FCC/CE/KC/PSE、SRRC/蓝牙 SIG 等；以及医疗、车载、工业宽温等行业专项。
有 UTOS 时，交付阶段可经 G 类守护单元插入安规、EMC、环保等合规检查点（见 SKILL.md 与 UTOS 接口说明）。
触发与发现¶
描述与 SKILL.md 中列出的触发词一致，便于 Agent 路由，例如：智能硬件、嵌入式、IoT、固件、PCB、原理图、量产、NPI、EVT、DVT、PVT、FCC、CE、SRRC、OTA、BLE、PCBA，以及英文 hardware、embedded、firmware 等。
SkillHub 页面显示约 1.2 千次下载、AI 评分 4.3/5.0（截至页面展示，非实时统计）。
安装与启用¶
通用 Skill 格式为包内 SKILL.md + references/。推荐通过 SkillHub CLI 安装到当前 Agent 的 skills 目录（装错目录会导致 Agent 读不到，需重启或重新加载）。
1. 检查或安装 SkillHub CLI¶
依据官方说明 https://skillhub.cn/install/skillhub.md：
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 Smart Hardware Reference¶
将 --dir 指向你使用的 Agent 的 skills 目录。官方文档给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装命令（与 SkillHub 页面提示及 skillhub search 输出一致）：
skillhub install smart-hardware-reference --namespace indiv-wangjiaocheng --dir ~/.cursor/skills/
也可让 Agent 按安装文档执行包名：
请根据 https://skillhub.cn/install/skillhub.md，安装 @indiv-wangjiaocheng/smart-hardware-reference。
3. 依赖技能¶
SKILL.md 声明 强依赖 universal-task-os。首次激活会尝试安装；若你只需要查表，可不装 UTOS，但任何「按清单/范本产出文档或编排开发管线」类请求会被拒绝并提示先安装 UTOS。
典型用法¶
下面步骤来自技能自带的 SKILL.md 使用规则，可在 Cursor 等环境中复现。
-
激活与依赖检查
开启对话并提及触发词（如「EVT 验证清单」「BLE OTA 方案文档」）。Agent 应加载本 Skill，并检测/安装universal-task-os。 -
首次加载目录
读取references/hardware-catalog.md，确认域分类、目标任务类型及依赖拓扑。 -
按任务取槽位
针对具体任务类型（例如 H3 原理图、H6 认证申请），读取references/structure-requirements.md中的组件清单；若采用样本法，再读references/exemplars.md。 -
委托 UTOS 产出（需 UTOS）
将清单作为清单法输入、范本作为样本法输入、拓扑作为执行轴依赖，由 UTOS 编排元操作序列并生成结构化交付物。企业侧需自行填充标注[待企业提供]/[待补充]的范本与字段。 -
只读查阅（无 UTOS）
例如：「列出 H7 量产域 8 类任务及依赖」——仅引用 catalog 与 structure 文件即可，不触发管线执行。
适用场景与注意¶
适合谁
- 硬件 PM、系统架构、嵌入式、结构、NPI 工程师，希望在 Agent 对话里按生命周期阶段对齐交付物，而不是零散问答。
- 已在用或计划用 Universal Task OS 的团队，需要智能硬件领域的清单法/样本法素材。
限制与注意
- 不含执行框架：没有 UTOS 时不能代为「跑完」文档管线，只能参考查阅。
- 范本与部分结构字段需企业自行脱敏与补全，否则样本法/清单法不完整。
- 不能替代专业工具链（Altium/KiCad、产线 MES、认证实验室流程）；认证与测试结论仍需人工与实物验证。
- 安装源以 SkillHub 索引的
@indiv-wangjiaocheng/smart-hardware-reference为准；勿与已下线的user_e02e04b8页面路径混淆。
结尾¶
Smart Hardware Reference 把智能硬件从需求到运维的 9 域 68 类任务、结构槽位和范本框架固化成 Agent 可读的知识包，并与 UTOS 的执行轴、内容轴对接。若你的痛点是「阶段交付物对不齐、合规与制造约束总被漏掉」，可以把它当作领域字典装进 Agent，再按需补齐企业与 UTOS。
官方社区页：https://skillhub.cn/skills/smart-hardware-reference
安装说明：https://skillhub.cn/install/skillhub.md
