# TuyaOpen-dev-skills

**Repository Path**: tuya-open/TuyaOpen-dev-skills

## Basic Information

- **Project Name**: TuyaOpen-dev-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TuyaOpen 开发技能包

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![TuyaOpen](https://img.shields.io/badge/TuyaOpen-主仓库-orange.svg)](https://github.com/tuya/TuyaOpen)

[English](README.md) | **中文**

---

面向 [TuyaOpen](https://github.com/tuya/TuyaOpen) 硬件开发的 AI 开发技能包，配合 [Claude Code](https://claude.ai/code)、[Cursor IDE](https://cursor.com) 等 AI 编程助手使用，让 AI 助手深度理解 TuyaOpen 开发流程，加速从环境搭建到设备调试的全过程。

## 什么是 Skills？

Skills 是结构化的知识文件（`SKILL.md`），为 AI 编程助手提供特定工具、框架和工作流的深度上下文理解。加载到 Cursor IDE 后，AI 助手可以：

- 自动搭建 TuyaOpen 开发环境
- 使用正确的参数编译、烧录、监控固件
- 理解 Kconfig 依赖关系和开发板配置
- 从串口日志诊断设备错误
- 遵循 TuyaOpen 编码规范和安全实践

> **IDE 支持：** 技能包遵循 [Agent Skills](https://agentskills.io/) 开放标准，可在 Claude Code（TuyaOpen IDE）、Cursor 及任何兼容 AI 助手中自动加载。

## 技能列表

| 技能 | 目录 | 说明 |
|------|------|------|
| **环境搭建** | [`tuyaopen/env-setup`](skills/tuyaopen/env-setup/) | 安装依赖、激活环境（Linux/macOS/Windows） |
| **项目编译** | [`tuyaopen/build`](skills/tuyaopen/build/) | 编译项目、配置 Kconfig 选项 |
| **项目与配置管理** | [`tuyaopen/project-config`](skills/tuyaopen/project-config/) | 创建新项目、管理编译配置 |
| **代码检查** | [`tuyaopen/code-check`](skills/tuyaopen/code-check/) | 格式校验、文件头检查、禁止中文字符 |
| **新增开发板** | [`tuyaopen/add-board`](skills/tuyaopen/add-board/) | 添加开发板 BSP：Kconfig、驱动、引脚配置 |
| **开发闭环** | [`tuyaopen/dev-loop`](skills/tuyaopen/dev-loop/) | 构建→烧录→监控→分析的迭代循环 |
| **设备授权** | [`tuyaopen/device-auth`](skills/tuyaopen/device-auth/) | 将 UUID/AuthKey/PID 写入设备（源代码或串口 KV flash） |
| **调试助手** | [`tuyaopen/debug-helper`](skills/tuyaopen/debug-helper/) | 非阻塞后台串口日志捕获，用于智能体 |

## 开发流程

技能包覆盖完整的 TuyaOpen 开发生命周期：

```mermaid
flowchart LR
    envSetup["1. 环境搭建"] --> projectConfig["2. 项目配置"]
    projectConfig --> build["3. 编译"]
    build --> codeCheck["代码检查"]
    build --> flashMonitor["4. 烧录监控"]
    flashMonitor --> deviceAuth["设备授权"]
    flashMonitor --> devLoop["5. 开发闭环"]
    devLoop -->|"修复并重编译"| build
    projectConfig --> addBoard["新增开发板"]
```

**典型流程：** 搭建环境 → 创建/配置项目 → 编译 → 烧录到设备 → 监控日志 → 分析并迭代。

## 支持的平台

| 平台 | 芯片 |
|------|------|
| T5AI | T5AI 系列 |
| ESP32 | ESP32, ESP32-S3, ESP32-C3, ESP32-C6 |
| LINUX | Ubuntu, Raspberry Pi, DshanPi |
| T2 | T2-U |
| T3 | T3 LCD Devkit |
| LN882H | LN882H, EWT103-W15 |
| BK7231X | BK7231X |

## 安装方法

Cursor 会自动从以下目录加载技能：

| 位置 | 作用域 |
|------|--------|
| `.agents/skills/` | 项目级 |
| `.cursor/skills/` | 项目级 |
| `~/.cursor/skills/` | 用户级（全局） |

### 方式 A：告知智能体安装技能（推荐）

```text
Install the skill for this project: https://github.com/tuya/TuyaOpen-dev-skills.git
```

### 方式 B：复制到 TuyaOpen 项目

将 `skills/tuyaopen` 目录复制到 TuyaOpen 项目的 `.agents/skills/` 下：

```bash
git clone https://github.com/tuya/TuyaOpen-dev-skills.git
mkdir -p /path/to/TuyaOpen/.agents/skills
cp -r TuyaOpen-dev-skills/skills/tuyaopen /path/to/TuyaOpen/.agents/skills/tuyaopen
```

### 方式 C：符号链接

创建符号链接，让技能包与本仓库保持同步：

```bash
git clone https://github.com/tuya/TuyaOpen-dev-skills.git
mkdir -p /path/to/TuyaOpen/.agents
ln -s /path/to/TuyaOpen-dev-skills/skills/tuyaopen/ /path/to/TuyaOpen/.agents/skills/tuyaopen
```

### 方式 D：按需选择

只复制你需要的技能：

```bash
mkdir -p /path/to/TuyaOpen/.agents/skills/tuyaopen
cp -r TuyaOpen-dev-skills/skills/tuyaopen/build/ /path/to/TuyaOpen/.agents/skills/tuyaopen/
cp -r TuyaOpen-dev-skills/skills/tuyaopen/env-setup/ /path/to/TuyaOpen/.agents/skills/tuyaopen/
```

## 项目结构

```
TuyaOpen-dev-skills/
├── README.md
├── README_zh.md
├── LICENSE
└── skills/
    └── tuyaopen/
        ├── env-setup/        SKILL.md + scripts/{check_env.sh,.bat,.ps1}
        ├── build/            SKILL.md + references/KCONFIG_GUIDE.md
        ├── project-config/   SKILL.md + references/TOS_COMMANDS.md
        ├── code-check/       SKILL.md + scripts/check_files.py
        ├── add-board/        SKILL.md + references/BOARD_LAYERS.md
        ├── dev-loop/         SKILL.md + scripts/build_run.py + references/ERROR_CODES.md
        ├── device-auth/      SKILL.md + references/PROVISIONING.md
        └── debug-helper/     SKILL.md + scripts/monitor_helper.py
```

每个技能遵循 [Agent Skills](https://agentskills.io/) 开放标准：
- `SKILL.md` — 简洁的核心指令，由 Agent 自动加载
- `references/` — 详细参考文档，按需加载以节省上下文
- `scripts/` — Agent 可直接执行的脚本

## 相关资源

- [TuyaOpen](https://github.com/tuya/TuyaOpen) — SDK 主仓库
- [TuyaOpen 文档](https://tuyaopen.ai/docs/quick-start) — 官方文档
- [涂鸦 IoT 平台](https://platform.tuya.com) — 设备管理云平台
- [Cursor IDE](https://cursor.com) — AI 驱动的代码编辑器

## 参与贡献

欢迎贡献！添加或改进技能的步骤：

1. Fork 本仓库
2. 在 `skills/<技能名>/` 下编辑或创建 `SKILL.md`
3. 遵循 YAML front-matter 格式（`name`、`description`、`license`、`compatibility`）
4. 保持 `SKILL.md` 简洁——将详细参考资料放到 `references/` 目录
5. 如有可自动化的工作流，将可执行脚本放到 `scripts/` 目录
6. 提交 Pull Request

## 许可证

本项目采用 [Apache License 2.0](LICENSE) 开源协议。