前言¶

做智能硬件时，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 根目录）：

1. references/hardware-catalog.md — 开发任务清单与任务依赖拓扑（9 域、68 种任务类型）。
2. references/structure-requirements.md — 每种任务类型的结构要求与组件槽位（清单法输入）。
3. references/exemplars.md — 优秀范本框架（样本法输入；部分槽位标注需企业脱敏填充）。

九域生命周期覆盖¶

按产品生命周期划分的域与任务规模（摘自 SKILL.md）：

与 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 等环境中复现。

1. 激活与依赖检查
   开启对话并提及触发词（如「EVT 验证清单」「BLE OTA 方案文档」）。Agent 应加载本 Skill，并检测/安装 universal-task-os。

2. 首次加载目录
   读取 references/hardware-catalog.md，确认域分类、目标任务类型及依赖拓扑。

3. 按任务取槽位
   针对具体任务类型（例如 H3 原理图、H6 认证申请），读取 references/structure-requirements.md 中的组件清单；若采用样本法，再读 references/exemplars.md。

4. 委托 UTOS 产出（需 UTOS）
   将清单作为清单法输入、范本作为样本法输入、拓扑作为执行轴依赖，由 UTOS 编排元操作序列并生成结构化交付物。企业侧需自行填充标注 [待企业提供] / [待补充] 的范本与字段。

5. 只读查阅（无 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