前言¶
做 MCU 固件时，寄存器配置、时钟树、中断优先级和 RTOS 任务划分往往要对照厂商手册与既有工程习惯。通用大模型能写 C，但对「这块板子用 HAL 还是 LL」「FreeRTOS 里谁持有互斥量」这类上下文经常缺位。SkillHub 上的「嵌入式系统」把 STM32/ESP32、FreeRTOS 与裸机开发收进一套可被 Agent 读取的 Skill 说明，让对话更贴近固件工程语境。下面介绍它是什么、能做什么，以及如何安装启用。
这是什么¶
「嵌入式系统」是 SkillHub 坐标 @kunlungrowth/embedded-systems 下的企业来源（enterprise）Skill，当前版本 1.0.0，分类为 dev-programming，由 昆仑增长 发布。官方简介只有一句，但边界很清楚：用 STM32/ESP32、FreeRTOS 与裸机开发固件。标签标明 requires_api_key=false，使用时不需要额外配置 API Key。
- SkillHub 页面：https://www.skillhub.cn/skills/kunlungrowth/embedded-systems
- API 元数据地址：https://api.skillhub.cn/kunlungrowth/embedded-systems
它与「随便问 AI 写段 C」的差别在于：Skill 以通用 SKILL.md 形式注入领域约束与流程，Agent 在相关任务里会优先按 Skill 里的说明组织回答，而不是只按通用编程知识发挥。
核心功能¶
依据已公开的简介与元数据，可核实的能力范围如下（未在官方资料中出现的能力不写）：
- 平台：面向 STM32、ESP32 两类常见 MCU 生态的固件开发讨论与实现辅助。
- 运行模型：同时覆盖 FreeRTOS 多任务场景与 裸机（无 OS 或极简调度）开发。
- 交付形态：固件层面的设计、代码与调试思路——具体章节以安装后 Skill 包内的
SKILL.md为准。 - 接入成本：无需 API Key，适合在本地或企业内网 Agent 中直接挂载。
SkillHub 上该 Skill 的评分为 100000，下载 2977 次（统计来自 SkillHub 元数据，会随时间变化）。
安装与启用¶
安装分两条路：用 SkillHub CLI 装进 Agent 的 skills 目录，或把官方提示词交给 AI 按文档自助安装。无论哪种方式，技能文件都必须落在当前 Agent 能识别的 skills 目录，否则不会生效。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（含默认 Skill）或仅 CLI：
# 完整安装（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
说明与权限、沙箱联网等细节见：https://skillhub.cn/install/skillhub.md
2. 用 CLI 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录；省略时默认装到 ./skills/，多数客户端不会自动加载。
skillhub install kunlungrowth/embedded-systems --dir <你的 skills 目录>
常用客户端的 skills 路径（来自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目 .windsurf/skills/ |
在 Cursor 中，典型命令为：
skillhub install kunlungrowth/embedded-systems --dir ~/.cursor/skills/
装好后按你所用客户端的要求刷新或重启，使新 Skill 被索引。
3. 通过提示词让 AI 安装¶
SkillHub 页面提供的安装提示如下，可直接发给支持读文档的 Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@kunlungrowth/embedded-systems`。
Agent 应读取上述安装文档，再把 @kunlungrowth/embedded-systems 安装到对应 skills 目录。
典型用法¶
官方公开的可复现步骤主要是「安装 + 按简介范围提问」，示例如下。
安装（提示词方式）
请根据 https://skillhub.cn/install/skillhub.md，安装 `@kunlungrowth/embedded-systems`。
安装（CLI 方式，以 Cursor 为例）
skillhub install kunlungrowth/embedded-systems --dir ~/.cursor/skills/
启用后的对话方式
安装并启用后，在固件相关任务中显式说明平台与运行模型，便于 Agent 对齐 Skill 范围，例如：
- 说明目标芯片（STM32 或 ESP32）与工具链（如 HAL、ESP-IDF 等你自己工程里在用的栈）。
- 标明是 FreeRTOS 工程还是 裸机 工程，以及当前卡点（时钟、DMA、中断、任务间同步等）。
Skill 不会替代编译器、调试器与硬件；它提供的是与「STM32/ESP32 + FreeRTOS/裸机固件」一致的 AI 协作上下文。更细的触发语、检查清单或代码模板以安装包内 SKILL.md 为准。
适用场景与注意¶
适合谁
- 正在做 STM32 或 ESP32 产品固件，需要在 IDE 里和 AI 结对写驱动、移植 RTOS、梳理中断与任务结构的开发者。
- 希望把团队惯用的嵌入式表述固定下来，减少 AI 答非所问（例如把裸机工程误按 Linux 驱动来写）的团队。
限制与注意
- 范围以简介为准：仅承诺 STM32/ESP32、FreeRTOS 与裸机固件方向；其他架构（如 RISC-V 专用 SDK、Linux 嵌入式）不在官方简介范围内。
- 企业来源：
source: enterprise，若你所在环境对第三方 Skill 有合规要求，安装前按内部规范评估。 - 目录必须正确：未使用
--dir指向 Agent skills 目录时，安装成功也可能不被加载。 - 统计会变动：评分、下载量以 SkillHub 页面与元数据为准，勿把本文中的数字当作长期固定值。
结尾¶
「嵌入式系统」把 STM32/ESP32 上的 FreeRTOS 与裸机固件开发收敛成可安装的 Agent Skill，免 API Key，通过 SkillHub CLI 或官方安装提示即可挂到 Cursor 等客户端。若你的日常工作就在这类 MCU 固件上，值得把它放进 skills 目录，再在具体工程上下文里向 AI 提问。
官方 SkillHub 页面：https://www.skillhub.cn/skills/kunlungrowth/embedded-systems
