Arduino UNO Q 板载 Nanobot 自动化编程指南之六

​本文主要介绍Nanobot Skil是让 AI Agent 更专业的技能模块。

一、什么是 Skill？

Skill（技能） 是 Nanobot 系统中的核心概念，它是一种模块化、自包含的包，用于扩展 AI Agent 的能力。可以把 Skill 理解为 Agent 的"入职培训手册"——它让一个通用型的 Agent
转变为具备特定领域专业能力的专家。
比如，一个没有 skill 的 Agent 可能知道什么是 Arduino，但不知道如何在 UNO Q 上正确编写 Bridge 通信代码。而加载了 arduino-uno-q skill 后，Agent 就能：
1，正确使用 Wire1 而非 Wire 进行 Qwiic I2C 通信，
2，用 Bridge.call() 而非 subprocess 调用 MCU，
3，启动应用后立即检查状态并查看日志。
一句话定义：Skill 是封装了领域知识、工作流程和工具的模块，让 Agent 在特定场景下"像专家一样工作"。

二、Skill 的核心特征

1. 渐进式披露设计
Skill 采用三层加载机制，高效利用 Agent 的上下文窗口：

这就像一本书的目录始终可见，正文在需要时才翻开，附录资料更是仅在用到时才查阅。

2. 简洁原则
默认假设：Agent 已经很聪明。 只添加 Agent 不知道的知识。每一行内容都要问自己："这真的值得占用 token 吗？"
3. 适当的自由度设置
根据任务特性匹配控制粒度：

三、Skill 的作用

Skill 为 Agent 提供四大能力：

四、以 arduino-uno-q 为例：一步一步制作 Skill

步骤 1：理解具体需求
首先明确 skill 的使用场景。对于 arduino-uno-q，核心问题是：
- 用户会如何触发？"帮我写个温度监测应用"、"点亮 LED"、"读取 SHT45"
- Agent 需要知道什么？双架构（MPU/MCU）、Bridge 通信、I2C 设备地址
- 常见错误有哪些？用 Wire 而非 Wire1、用 subprocess 而非 Bridge.call
步骤 2：规划可复用资源
分析需求后，确定 skill 需要哪些资源：

步骤 3：初始化 Skill 目录
使用初始化脚本创建骨架：
scripts/init_skill.py arduino-uno-q --path skills/public --resources scripts,references,assets
生成的目录结构：
arduino-uno-q/
├── SKILL.md # 必需：技能说明（含 frontmatter）
├── scripts/ # 可选：CLI 脚本
├── references/ # 可选：参考文档
└── assets/ # 可选：模板文件
（下接：Arduino UNO Q 板载 Nanobot 自动化编程指南之七）