简体中文

English

简体中文

English

外观

部署天巧星 Skill ​

Agent 工具已经就绪，但目前它只是一个通用代码生成工具——不了解 MSPM0G3519 的引脚约束，不知道天巧星的板载外设布局，也无法调用 CCS 工具链完成编译和烧录。

本步骤的目标：将天巧星 Skill 注入 Agent，并配置本地 CCS 和 SDK 路径，使 Agent 具备完整的 TI MSPM0 开发能力。

前置条件

部署 Skill 前，请确保已安装以下软件：

  • CCS Studio — TI 官方 IDE，提供 SysConfig、DSLite、gmake 等工具链
  • MSPM0 SDK — TI MSPM0 软件开发包，包含库文件和示例工程

未安装时，Skill 的工程创建、编译、烧录功能将无法使用。

🚀 最简单的方式

如果你正在使用 AI Agent，复制以下内容发送给它即可完成全部部署：

帮我安装天巧星 MSPM0G3519 的 Skill，仓库地址 https://gitee.com/lcsc/openkits-skills ，Skill 名称为 mspm0kit-tianqiaoxing

Agent 会自动完成克隆仓库、导入 Skill、配置工具链等所有步骤。下文是手动操作教程，供需要自行操作时参考。

1. Skill 仓库 ​

openkits-skills 是立创开发板维护的 AI Skill 开源仓库：

平台地址说明
GitHubhttps://github.com/jlckfb/openkits-skills国际访问
Giteehttps://gitee.com/lcsc/openkits-skills国内推荐，下载速度更快

本教程命令默认使用 Gitee 地址。

1.1 可用 Skill 列表 ​

Skill适用平台说明
mspm0kit-tianmengxing天猛星 MSPM0G3507 (LQFP-64)天猛星专用：引脚映射、封装适配、工程生成、编译烧录
mspm0kit-tianqiaoxing天巧星 MSPM0G3519 (LQFP-64)天巧星专用：引脚映射、封装适配、工程生成、编译烧录
mspm0-ccs通用 MSPM0基础 Skill：SysConfig 使用规范、DriverLib API 参考、CCS 工程结构

依赖关系

mspm0kit-tianqiaoxing 依赖 mspm0-ccs。使用 npx skills add 命令安装时会自动解析并安装依赖，无需手动处理。

1.2 天巧星 Skill 核心能力 ​

mspm0kit-tianqiaoxing 提供以下能力：

能力说明
工程生成从 MSPM0 SDK 示例出发，自动创建完整的 CCS Theia 工程
封装适配SDK 示例默认面向 LaunchPad（LQFP-100），Skill 自动完成到天巧星 LQFP-64 的引脚重映射
引脚冲突检测自动检查目标引脚是否被板载外设占用，冲突时给出警告和替代建议
一键编译调用 SysConfig CLI 生成配置代码 + gmake 编译链接
一键烧录通过 DSLite 将编译产物写入芯片 Flash
串口监视自动打开串口终端，监听 UART 输出

2. 安装 Skill 到 Claude Code CLI ​

一行命令完成安装，无需手动克隆仓库：

bash
npx skills add https://gitee.com/lcsc/openkits-skills.git -s mspm0kit-tianqiaoxing -a claude-code

GitHub 用户：

bash
npx skills add lckfb/openkits-skills -s mspm0kit-tianqiaoxing -a claude-code

安装过程中的交互选项：

  1. 安装范围选择 → 输入 Global（全局安装，所有项目可用）
  2. 确认安装 → 输入 yes

安装完成后，mspm0kit-tianqiaoxing 及其依赖 mspm0-ccs 自动就位。

验证安装 ​

重新启动 Claude Code CLI，输入 / 打开命令面板，搜索 mspm0kit-tianqiaoxing。能找到该 Skill 即安装成功。

也可以直接测试：

> 使用天巧星 skill，帮我创建一个 LED 闪烁的工程

如果 Agent 能正确识别引脚约束并选择 SDK 模板，说明 Skill 已生效。

3. 安装 Skill 到 Codex ​

bash
npx skills add https://gitee.com/lcsc/openkits-skills.git -s mspm0kit-tianqiaoxing -a codex

GitHub 用户：

bash
npx skills add lckfb/openkits-skills -s mspm0kit-tianqiaoxing -a codex

交互选项与 Claude Code 相同：Global → yes。

安装后文件位于 ~/.codex/skills/ 目录。

验证安装 ​

重启 Codex，输入 / 搜索 mspm0kit-tianqiaoxing，或直接发送测试指令验证。

卸载 ​

bash
# 查看已安装 Skill
npx skills list -a codex

# 卸载
npx skills remove mspm0kit-tianqiaoxing -a codex

4. 安装 Skill 到 Trae ​

Trae 不支持命令行 Skill 安装，需要先克隆仓库到本地，再通过图形界面导入。

4.1 克隆仓库 ​

bash
# Gitee（国内推荐）
git clone https://gitee.com/lcsc/openkits-skills.git

4.2 导入 Skill ​

  1. 打开 Trae → 左下角齿轮图标 → 设置
  2. 左侧导航找到 Skills 面板
  3. 点击 导入 Skill
  4. 在文件选择器中定位到 openkits-skills/mspm0kit-tianqiaoxing 目录，确认
  5. 重复步骤 3-4，导入 openkits-skills/mspm0-ccs（依赖 Skill）

确认启用状态

导入完成后，在 Skills 面板中确认两个 Skill 旁边的开关均为启用状态。

5. 配置本地工具链 ​

Skill 需要知道 CCS 和 SDK 的本地安装路径才能调用编译和烧录工具。运行一次配置脚本即可完成，后续无需重复。

5.1 前置软件 ​

软件说明下载地址
CCS TheiaTI 官方 IDE（含 SysConfig、DSLite、gmake）TI 官网
MSPM0 SDK≥ 2.10.00.04，包含库文件与示例工程TI MSPM0-SDK
XDS110 驱动天巧星配套调试器驱动（通常 CCS 安装时已包含）CCS 内置

版本要求

天巧星 Skill 基于 MSPM0 SDK 2.05.01.00 开发和测试。使用其他版本可能出现 API 不匹配或路径不一致问题。建议安装该特定版本。

5.2 运行配置脚本 ​

bash
cd openkits-skills/mspm0kit-tianqiaoxing/scripts
python setup.py

脚本以交互方式询问三项配置：

配置项示例值说明
CCS 安装目录C:/ti/ccstheia140Windows 下使用正斜杠 /，路径不含中文或空格
MSPM0 SDK 目录C:/ti/mspm0_sdk_2_10_00_04SDK 根目录
调试探针类型XDS110天巧星配套调试器

各平台默认路径参考：

平台CCS 默认路径SDK 默认路径
WindowsC:/ti/ccstheia140C:/ti/mspm0_sdk_2_10_00_04
macOS/Applications/ti/ccstheia140/Applications/ti/mspm0_sdk_2_10_00_04
Linux~/ti/ccstheia140~/ti/mspm0_sdk_2_10_00_04

跳过交互

如果路径均为默认安装位置：

bash
python setup.py --accept-defaults

首次建议使用交互模式，确认路径与实际一致。

配置完成后，Skill 目录下生成配置文件，后续编译和烧录操作会自动读取这些路径。

5.3 配置验证 ​

配置脚本执行完毕后会输出检查结果。确认以下项目均为 OK：

  • CCS 目录存在且包含 ccs 可执行文件
  • SDK 目录存在且版本匹配
  • SysConfig CLI 可调用
  • gmake 可调用
  • DSLite 可调用

6. 端到端验证 ​

打开 Agent，发送：

帮我在天巧星上创建一个 GPIO LED 闪烁的工程

观察 Agent 的响应。如果它能够：

  1. 正确识别天巧星为 MSPM0G3519 LQFP-64 平台
  2. 分析引脚可用性（参考板载外设占用表）
  3. 选择合适的 SDK 模板（如 gpio_toggle_output）
  4. 输出包含引脚分配和时钟配置的规划摘要

则说明 Skill 部署成功，Agent 已具备天巧星开发能力。

验证前提

确保已完成第 5 节的工具链配置。否则 Agent 可能在编译阶段因找不到 CCS/SDK 路径而报错。

7. 安装后目录结构 ​

部署完成后的 Skill 文件结构：

~/.claude/skills/                          # Claude Code CLI
├── mspm0-ccs/                             # 基础 Skill
│   ├── SKILL.md                           # Skill 元信息与触发规则
│   ├── references/                        # SysConfig/DriverLib 参考文档
│   └── scripts/                           # 通用工具脚本
└── mspm0kit-tianqiaoxing/                 # 天巧星 Skill
    ├── SKILL.md                           # Skill 元信息
    ├── peripherals/                       # 引脚映射、外设占用清单
    └── scripts/
        ├── setup.py                       # 首次配置脚本
        ├── scaffold.py                    # 工程脚手架生成
        ├── build.py                       # 编译（SysConfig + gmake）
        ├── flash.py                       # 烧录（DSLite）
        ├── cleanup.py                     # 构建产物清理
        └── serial_console.py             # 串口监视

Trae 用户的 Skill 文件位于 Trae 应用数据目录中，通过 Skills 面板管理。

Skill 部署完成。下一步进入实战环节——用自然语言完成 LED 闪烁和 UART 串口通信的完整开发流程。