专为全国大学生电子设计竞赛（NUEDC）及立创·天猛星 / 地猛星 / 地正星开发板（MSPM0G3507 / L1306）与自定义 MSPM0G3519 打造的 AI 编程 Skill
让 Codex / Claude Code 替你接管 SysConfig 外设配置与 DriverLib 驱动，你只管专注算法与控制逻辑。
来源与版权：本仓库基于 mc3545dada/mspm0-skill 的历史版本修改而来，相关原始内容受 MIT License 许可，并保留版权声明
Copyright (c) 2026 mc3545dada。本仓库在此基础上重写了定位、补充了板卡资料与示例、调整了工具脚本。具体以提交历史为准。
mspm0-skill 是一套面向 AI Agent（Codex / Claude Code / 兼容工具）的 TI MSPM0 嵌入式开发规则集。它不是 SDK、不是库、也不是 IDE 插件，而是一份让编程 Agent 具备资深嵌入式工程师直觉的行为规范。
Agent 加载本 Skill 后会：
- 把
.syscfg当作硬件配置的唯一信源，绝不手工修改ti_msp_dl_config.c/.h等生成文件 - 修改引脚前自动检查板级约束（BSL、晶振、SWD、ROSC、板载外设）
- 按当前板型（天猛星 / 地猛星 / 地正星 / 自定义 G3519）加载对应引脚保护规则
- 用已验证的 DriverLib 调用模式，而非猜测 API 名称
- 每次修改后跑静态检查，在构建前发现风险
支持平台：MSPM0G3507、MSPM0G3519（custom-mspm0g3519）、MSPM0L1306（地正星）；板卡规则位于 boards/*.json（机器可读唯一数据源）。
| 能力 | 解决的问题 | 对应实现（本仓库均有） |
|---|---|---|
| 🧠 直接理解 SysConfig | 检查/修改 .syscfg，保留 metadata/时钟/PinMux/DMA/中断，不篡改生成文件 |
scripts/check_syscfg.py + SKILL.md |
| 🔧 识别工程与工具链 | 区分 CCS / Keil / CMake+GCC+OpenOCD / FreeRTOS 工程并给对应路径 | SKILL.md「Project Shape」 |
| ⚡ 构建与烧录指引 | CCS/Keil/CMake 构建与烧录入口、DSLite 与 OpenOCD 示例 | references/sysconfig_ccs_workflow.md |
| 🖥️ CCS-DSS 调试 | 通过 CCS DSS 连真实硬件，做探针探测/断点/寄存器/复位 | scripts/ccs_dss_debug.py |
| 📡 串口收发 | Python 串口控制台，文本/十六进制收发、时间戳 | scripts/serial_console.py |
| 📚 例程与 SDK 检索 | GPIO/PWM/Timer/UART 等示例 + 检索本地 TI SDK 例程 | scripts/list_examples.py + index_syscfg_examples.py + examples/ |
一行安装（需 Node.js 环境）：
npx skills add Ibook000/mspm0-skill也可以只复制本仓库根目录（本仓库根目录即 skill 本体）到对应 Agent 的 skills 目录：
| Agent | 安装位置 |
|---|---|
| Claude Code | ~/.claude/skills/mspm0-skill/ |
| Codex 等 | ~/.agents/skills/mspm0-skill/ |
| OpenClaw | ~/.openclaw/skills/mspm0-skill/ |
| CodeBuddy Code | ~/.codebuddy/skills/mspm0-skill/ |
安装后的 skill 目录名为
mspm0-skill。装好可在 Agent 中用/skills（或等价命令）确认已加载。规则与参考文档是纯 Markdown，不装依赖也能用；只有要运行check_syscfg.py等辅助脚本时才需要pip install -r requirements-dev.txt。
Windows PowerShell 手动安装：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force .\mspm0-skill "$env:USERPROFILE\.claude\skills\mspm0-skill"本仓库是 AI Agent Skill，真正的规则入口是 SKILL.md。Agent 被加载后的标准动作：
- 先读
SKILL.md（权威入口：工作流、修改边界、验证口径） - 识别板卡（
.syscfg的--device/--package或用户说明）→ 读取对应boards/*.json与references/boards/<board>.md - 以
.syscfg为唯一信源，只改.syscfg/ 应用代码，绝不手工改生成文件 - 改前跑
python scripts/check_syscfg.py <dir> --board <board-id>检查引脚冲突 - 把「源码 / SysConfig 校验 / 编译 / 烧录 / 真实硬件」分层报告；没真板子不得称“硬件已验证”
在 Agent 中直接说：
读取 mspm0-skill/SKILL.md，按里面的规则工作。
当前项目：MSPM0G3507，板卡是立创·天猛星。
需求：用 PB22 板载 LED 做 1 kHz 呼吸灯；不要改 ti_msp_dl_config.c/.h。
步骤：先跑 python scripts/check_syscfg.py <项目目录> --board tianmengxing 检查引脚冲突，
只改 .syscfg 与应用代码，改完再跑一次检查。
最后把「源码/校验/编译/烧录/硬件」各自验证到哪一步分开说明。
机器可读索引：llms.txt · docs/project-index.json。
| 特性 | 天猛星 (tianmengxing) | 地猛星 (dimengxing) | 地正星 (dizhengxing) | 自定义 MSPM0G3519 (custom-mspm0g3519) |
|---|---|---|---|---|
| MCU | MSPM0G3507 LQFP-64 | MSPM0G3507 48-pin | MSPM0L1306 VQFN-32 | MSPM0G3519 LQFP-64 |
| 板载 LED | PB22（低电平亮） | PA14（低电平亮，270Ω） | PA14（高电平亮） | PB22（低有效，示例） |
| USB-UART | CH340E — PA10/PA11 | CH340E — PA10/PA11 | CH340E — PA22/PA23 | CH340E — PA10/PA11（示例） |
| SPI Flash | 板载 SPI Flash (PB6~PB9) | W25Q32 (PB6~PB9) | 无，需外接 | W25Q128 (PB6~PB9，示例） |
| OLED | 板载 OLED（引脚以原理图/板卡资料为准） | 需外接 | 需外接 | I2C (PA0/PA1，示例) |
| IMU | LSM6DS3 (PA27/PA28) | 需外接 | 需外接 | LSM6DS3 (PA27/PA28，示例) |
| WS2812 RGB | PB26 (TIMA1 CCP0) | 需外接 | 需外接 | PB26（示例） |
完整引脚占用、默认电平与避坑说明见
references/boards/。地猛星/地正星/自定义 MSPM0G3519 的板载外设多为示例连接，在外接板上需适配到对应引脚；地正星仅 GPIOA 端口且 LED 高电平点亮，跨板移植务必核对极性与可用引脚。自定义 MSPM0G3519 为自定义/示例板，板载资源以用户原理图为准。
| 文档 | 内容 |
|---|---|
| SKILL.md | 🔥 Agent 规则入口：工作流、修改边界、验证口径、脚本命令全集 |
| boards/ | 机器可读的板卡识别 / 引脚 / 板载资源（唯一数据源） |
| references/boards/ | 各板卡引脚与板载资源规则（由 JSON 生成） |
| MSPM0G3507_Pinout_Mapping | 天猛星/地猛星引脚映射与避坑 |
| sysconfig_ccs_workflow | SysConfig & CCS/Keil/CMake 工作流 |
| driverlib_runtime_rules | DriverLib 安全调用法则 |
| hardware_validation_notes | 硬件调试经验（HFXT/Flash/复位/干扰） |
| ccs_dss_debug | CCS DSS 调试指南 |
| sdk_schema_lookup | SDK Schema / 例程检索方法 |
| pin_occupation_table | G3519 引脚占用表 |
| docs/faq.md | MSPM0 / SysConfig / 板卡 / 安装常见问题 |
| examples/ | led_blink / pwm_breath_led / uart_blocking_tx / oledui_full_g3519 等 |
常用脚本（完整参数见 SKILL.md「Examples and Tools」）：
python scripts/check_syscfg.py <project-dir> --board tianmengxing # 引脚/生成物/工程结构审计
python scripts/verify_example.py <project-dir> --snapshot --json # 静态/SysConfig/构建/烧录/硬件 各阶段状态
python scripts/list_examples.py # 列出内置示例- 贡献：欢迎提交 Issue / PR / Discussions（见仓库顶部链接）；即使只是指出一个宏名或板载资源写错也很有用。
- License：MIT。使用、复制、修改或再发布本仓库及其来自上游的实质性内容时，请保留
Copyright (c) 2026 mc3545dada。 - 致谢：上游作者 mc3545dada、TI（DriverLib / SysConfig）、嘉立创（天猛星/地猛星/地正星/天巧星开发板）。
祝各位电赛战友：一次过编，不冒白烟！顺利拿奖！🏆