AI 辅助嵌入式开发教程
嵌入式开发的工作方式正在发生结构性变化。从手动翻阅数据手册、逐行配置寄存器，到借助 ChatGPT 生成代码片段，再到由 AI Agent 直接接管工程创建、编译和烧录——三代开发模式的演进在两年内完成。
本教程记录的是第三代：Agent + Skill 驱动的嵌入式开发流程。
三代开发模式对比
编译 → 报错 → 修改 → 烧录
粘贴到 IDE → 手动适配 → 编译烧录
自动配置外设 → 自动编译 → 一键烧录
一个 Agent + 一个 Skill，即可进入第三代开发流程。
核心概念
在进入教程之前，需要明确两个关键概念：
Agent（AI 编码代理）
Agent 是能够操作本地文件系统、执行 Shell 命令的 AI 开发工具。 与网页端 LLM 不同，Agent 可以直接读写项目文件、调用编译器、运行烧录工具。它的工作方式类似于一个远程协作的开发者——你描述需求，它在你的本地环境中完成实际开发操作。
目前主流的 Agent 工具包括：独立 AI IDE（Trae）、命令行工具（Claude Code CLI、Codex）、VS Code 插件（Cline、Roo Code）。底层能力相同，交互形态不同。
Skill（领域知识包）
Skill 是注入 Agent 的结构化领域知识。 Agent 本身是通用的代码生成工具，不具备特定芯片平台的专业知识——它不清楚 MSPM0G3519 的引脚复用关系、不知道天巧星开发板的板载外设占用情况、不了解 MSPM0 SDK 的工程模板结构。
天巧星 Skill 包含：完整的 LQFP-64 引脚映射表、板载外设占用清单、SDK 示例工程索引、CCS Theia 工程生成规则、SysConfig 配置约束。安装 Skill 后，Agent 能够基于准确的硬件信息做出正确的工程决策。
Agent 负责执行，Skill 提供知识。Agent + Skill = 具备特定平台开发能力的 AI 工程工具。
教程内容
本教程面向有一定嵌入式基础的开发者，不要求 AI 工具使用经验。完整流程五步：
- 理解 Agent 与 Skill 的协作机制 — 明确两者的职责边界和交互方式
- 选择并安装 Agent 工具 — 三种主流工具的能力对比与安装配置
- 部署天巧星 Skill — 将平台知识注入 Agent，配置本地工具链
- 项目实战 — LED 闪烁 + UART 回显，从需求描述到烧录验证的完整流程
- 自由开发 — PWM、ADC、I2C、SPI 等外设的自然语言驱动开发
主流 Agent 工具一览
| 对比维度 | Claude Code CLI | Codex | Trae |
|---|---|---|---|
| 网络要求 | ❌ 需要稳定的外网连接 | ❌ 需要稳定的外网连接 | ✅ 国内直连 |
| 费用 | 按量计费（API Key） | 有免费额度，超出需付费 | 免费 |
| 操作方式 | 命令行终端 | 命令行 / Web / IDE | IDE 图形界面 |
| 中文支持 | 模型支持中文，界面为英文 | 模型支持中文，界面为英文 | 原生中文界面与交互 |
| 上手门槛 | 高 — 需外网、API Key、命令行操作 | 中 — 需外网、OpenAI 账号 | 低 — 下载安装即可使用 |
| 代码生成能力 | ⭐ 最强（Claude Opus/Sonnet） | ⭐ 强（GPT-4o / o3） | ⭐ 胜任日常开发 |
国内开发者推荐 Trae：无网络限制、免费、中文原生、图形化操作。如果你已具备外网条件且习惯命令行工作流，Claude Code CLI 在代码生成质量和工具链集成深度上更有优势。
本教程默认使用 Trae 作为演示环境
Claude Code CLI 和 Codex 的安装与 Skill 部署步骤在对应章节中均有覆盖。
其他可选工具
以下 VS Code 插件同样支持 Skill 安装，适合不想更换 IDE 的开发者：
| 工具 | 类型 | 特点 |
|---|---|---|
| Cline | VS Code 插件 | 社区活跃，支持自定义规则文件和多模型后端 |
| Roo Code | VS Code 插件 | Cline 的社区分支，功能接近 |
| Continue | VS Code / JetBrains 插件 | 开源，支持本地模型与云端模型混用 |
天巧星 Skill 的安装逻辑对所有支持 Skill 机制的 Agent 工具通用。具体操作见 部署天巧星 Skill 章节。
教程导航
| 章节 | 链接 | 内容 |
|---|---|---|
| Agent 与 Skill 介绍 | agent-intro | Agent 和 Skill 的概念、三种工具的详细对比与选型建议 |
| 安装 Agent 工具 | agent-install | Node.js 环境准备、三种 Agent 的安装与验证 |
| 部署天巧星 Skill | skill-deploy | Skill 安装、工具链配置、验证 |
| Skill 开发实战 | skill-usage | LED 闪烁 + UART 回显完整实战流程 |
| 常见问题 | faq | 安装、编译、烧录、引脚冲突等常见问题汇总 |
学习路线
- 选择 Agent（3 分钟）：根据网络条件、费用预算和操作习惯做出选择。不确定时选 Trae。详见 Agent 介绍。
- 安装 Agent（10 分钟）：安装 Node.js 运行时、Agent 工具本体、完成账号认证。详见 安装 Agent 工具。
- 部署 Skill（5 分钟）：将天巧星 Skill 安装到 Agent 中，运行
setup.py配置本地 CCS 和 SDK 路径。详见 部署天巧星 Skill。 - 项目实战（15 分钟）：用自然语言完成 LED 闪烁和 UART 回显两个工程的创建、编译、烧录。详见 Skill 开发实战。
- 自由开发：掌握基本流程后，可向 Agent 发起任意外设开发需求——PWM、ADC、I2C、SPI 等。
适用硬件
本教程基于 立创·天巧星 MSPM0G3519 开发板 编写。
核心规格：
| 参数 | 规格 |
|---|---|
| MCU | TI MSPM0G3519，Arm Cortex-M0+，主频 80MHz |
| 封装 | LQFP-64(PM) |
| 存储 | 512KB Flash + 128KB SRAM |
| 调试器 | 配套 XDS110（USB 供电 + 烧录 + 串口三合一） |
| 通信接口 | 2× UART、2× I2C、2× SPI |
| 模拟外设 | 2× 12-bit ADC、1× 12-bit DAC |
| 定时器 | 高级定时器（PWM / 输入捕获 / 正交编码器） |
| 板载外设 | SPI Flash (W25Q64)、OLED 显示屏、WS2812 RGB LED、蜂鸣器、用户按键、旋转编码器、IMU 姿态传感器、无线串口模块、USB 转 UART (CH340) |
天巧星 Skill 已完整适配该开发板的引脚映射和板载外设占用关系，Agent 在生成工程时会自动规避已占用引脚。
后续将扩展支持地猛星（LQFP-48）、地正星（LQFP-32）等更多 TI 系列开发板，关注 openkits-skills 仓库获取更新。