# wch-dev-skill

文档：https://wiki.yang17.top/products/github/wch-dev-skill/
项目来源：https://github.com/JasonYANG170/wch-dev-skill
分类：软件项目
更新时间：2026-10-09T04:29:25.000Z

用于沁恒全系列MCU主控开发的AI技能。AI skills for developing the full range of WCH MCU controllers.

简体中文 | English

wch-dev-skill

统一的 WCH（南京沁恒微电子）全系列微控制器固件开发 AI Skill。让 AI Agent 自动生成符合 WCH SDK 规范的嵌入式代码，覆盖 35+ 芯片家族、10 大架构分组。

支持芯片：CH572/CH579（BLE）、CH583/CH585/CH592/CH595（BLE+USB）、CH32V003/CH32V006/CH32L103（低成本）、CH32V103/CH32V20x/CH32V307/CH32V407（通用）、CH32F103/CH32F20x/CH32M030（ARM）、CH32X035/CH32X315/CH641/CH643（USB-PD）、CH32H417（高性能）、CH569（以太网+USB3.0）、CH561/CH563（ARM7TDMI）、CH543-CH559（8051）。

功能特性

统一路由：自动识别芯片型号，导航到正确的 chips/<family>/ 目录

10 个芯片家族，每个家族包含完整的 recipes（场景指南）、API 速查、陷阱文档和 EXAM 例程

覆盖 BLE 全角色（Peripheral/Central/HID/Mesh/OTA/ANCS）、以太网、USB 3.0、USB-PD、LCD、NFC-A 等

每个场景提供完整的调用链、初始化序列和可复制的代码模板

包含各架构（RISC-V/ARM/ARM7TDMI/8051）的常见错误和陷阱

芯片家族覆盖

家族
目录
芯片
架构
关键特性

CH57x
chips/ch57x/
CH572, CH579
RISC-V
BLE 5.0, LCD (CH579), NET (CH579)

CH58x/CH59x
chips/ch58x-ch59x/
CH583, CH585, CH592, CH595
RISC-V
BLE+USB, LCD, NFCA, ENCODER, KEYSCAN

CH32V 通用
chips/ch32v-general/
CH32V103, CH32V20x, CH32V307, CH32V407
RISC-V
CAN, ETH, USB, BLE, LTDC, ARGB

CH32V 低成本
chips/ch32v-lowcost/
CH32V003, CH32V006, CH32L103
RISC-V
OPA, USB-PD (CH32L103), LPTIM

CH32F ARM
chips/ch32f-arm/
CH32F103, CH32F20x, CH32M030
ARM Cortex-M3
STM32 兼容, BLE, USB-PD

CH32X USB-PD
chips/ch32x-usbpd/
CH32X035, CH32X315, CH641, CH643
RISC-V
USB-PD, PIOC

CH32H417
chips/ch32h-highperf/
CH32H417
RISC-V
USB 3.0, LTDC, SerDes, 双核

CH569
chips/ch56x-ethernet/
CH569
RISC-V
ETH, USB 3.0, eMMC, ECDC

CH561/CH563
chips/ch561-ch563/
CH561, CH563
ARM7TDMI
ETH, USB 2.0 HS

CH5xx 8051
chips/ch5xx-8051/
CH543-CH559
8051
USB, TouchKey

安装说明

1. 拉取仓库到 skill 目录

根据你使用的 AI Agent 文档，找到或创建存放 Skill 的目录：

git clone <repo-url> wch-dev-skill

例如：

Claude Code
项目作用域：位于项目根目录下的 .claude/skills
用户作用域：位于 ~/.claude/skills，对本机所有项目生效
进入到对应的 skills 文件夹下
在终端执行 git clone <repo-url> wch-dev-skill 即可

QwenCode
项目作用域：位于项目根目录下的 .qwen/skills
用户作用域：位于 ~/.qwen/skills，对本机所有项目生效

OpenCode
项目作用域：位于项目根目录下的 .opencode/skills
用户作用域：位于 ~/.config/opencode/skills，对本机所有项目生效

2. 使用指定 skill

在你的 AI Agent 中确认 Skill 已加载，可通过命令指定 skill。

例如：

Claude Code
在终端中输入 claude 后回车，然后输入 /wch-dev-skill 并描述你的需求

QwenCode
在终端中输入 qwen 后回车，输入 /skills 回车，选择 wch-dev-skill

OpenCode
在终端中输入 opencode 后回车，输入 /skills 回车，选择 wch-dev-skill

工作原理

Skill 定义了一套工作流，AI Agent 在生成固件代码时会遵循：

步骤
名称
说明

1
识别芯片
确定具体芯片型号，导航到 chips/<family>/

2
阅读方案
在 recipes/ 中匹配场景，获取完整调用链

3
查询 API
查阅 resources/peripheral_api.md 获取函数签名

4
检查陷阱
阅读 resources/pitfalls.md 避免常见错误

5
验证
确认 API 签名、头文件包含、引脚分配、时钟配置

6
确认
向用户展示实现方案（包含、引脚、初始化序列、主循环）

7
执行
复制最接近的 EXAM 例程，然后修改适配

8
构建
RISC-V/ARM: MounRiver Studio (.wvproj)。ARM7: Keil MDK。8051: Keil C51

9
调试
UART 调试输出（115200 波特率）。BLE: nRF Connect。USB-PD: USB-C 分析仪

覆盖场景

BLE 应用（CH57x / CH58x/CH59x / CH32V20x / CH32F20x）

BLE 从机（Peripheral）— 广播、GATT 服务、通知

BLE 主机（Central）— 扫描、连接、服务发现、读写

BLE HID 设备 — 键盘、鼠标、消费者控制

BLE Mesh — 配网、阿里智能灯模型、厂商模型

BLE OTA — 双镜像备份升级、IAP 引导

BLE 速度测试 — 吞吐量优化、LE 2M PHY

BLE IoCHub — 自定义数据点协议、多设备组网

BLE ANCS / 心率 / 透传 / USB 合用

有线通信

以太网 — TCP/UDP Socket（CH32V307/CH32F20x/CH569/CH561/CH563/CH32H417/CH579/CH595）

USB 设备 — CDC、HID、自定义（全系列）

USB 主机 — 设备枚举、AOA、U 盘

USB 3.0 — 超高速设备（CH569/CH32H417/CH32X315）

USB-PD — PD 协商、电压/电流配置（CH32X035/CH641/CH643/CH32L103/CH32M030/CH32H417）

CAN — CAN 2.0B 收发（CH32V307/CH32F103/CH32L103/CH32H417）

显示与人机交互

LCD 段码屏 — CH579/CH585/CH592/CH595

FSMC/TFT LCD — CH32V307/CH32F20x

LTDC 显示 — CH32V407/CH32H417

ARGB LED — CH32V407/CH32X315

TouchKey — 全系列

KEYSCAN 键盘矩阵 — CH572/CH595

ENCODER 编码器 — CH595

NFCA NFC-A — CH585

外设驱动

GPIO / UART / SPI / I2C / ADC / Timer / PWM — 全系列

DAC / OPA / CMP — 多数系列

Flash 读写擦除、DMA 传输、EXTI 中断

RTC / IWDG / WWDG / 低功耗模式

RTOS 支持

FreeRTOS / RT-Thread / HarmonyOS / TencentOS — CH32V/CH32F/CH32X/CH58x/CH59x 系列

UCOS — CH563

目录结构

wch-dev-skill/
 SKILL.md # 统一路由和指南
 README.md # 本文件（中文）
 README_EN.md # 英文说明
 CHANGELOG.md # 版本历史
 chips/
 ch57x/ # CH572/CH579 BLE 5.0
 recipes/ # 20 个场景指南
 resources/ # API 速查、陷阱、配置、EXAM 例程
 ch58x-ch59x/ # CH583/CH585/CH592/CH595 BLE+USB
 recipes/ # 30 个场景指南
 resources/ # API 速查、陷阱、配置、EXAM 例程
 ch32v-general/ # CH32V103/V20x/V307/V407
 recipes/ # 21 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch32v-lowcost/ # CH32V003/V006/L103
 recipes/ # 15 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch32f-arm/ # CH32F103/F20x/M030 ARM Cortex-M3
 recipes/ # 22 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch32x-usbpd/ # CH32X035/X315/CH641/CH643 USB-PD
 recipes/ # 14 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch32h-highperf/ # CH32H417 双核 USB3+LTDC
 recipes/ # 38 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch56x-ethernet/ # CH569 ETH+USB3.0
 recipes/ # 18 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch561-ch563/ # CH561/CH563 ARM7TDMI ETH
 recipes/ # 12 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程
 ch5xx-8051/ # CH543-CH559 8051
 recipes/ # 12 个场景指南
 resources/ # API 速查、陷阱、EXAM 例程

参考资源

WCH 官网 → http://wch.cn

MounRiver Studio → http://www.mounriver.com

EVT SDK 源码 → 各芯片目录下的 EVT/EXAM/

BLE 参考手册 → chips/ch57x/resources/EXAM/BLE/

每个家族的 API 速查 → chips/<family>/resources/peripheral_api.md

常见陷阱 → chips/<family>/resources/pitfalls.md