diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..5d29613
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,69 @@
+# Repository Guidelines
+
+## Scope / 范围
+
+- This repo stores Codex skills for RT-Thread and embedded workflows.
+  / 本仓库保存面向 RT-Thread 与嵌入式流程的 Codex skills。
+- A skill must live in one top-level directory with `SKILL.md`.
+  / 每个 skill 必须位于一个顶层目录，并包含 `SKILL.md`。
+- Do not add application source, generated artifacts, or package-manager files
+  unless they are required by a skill.
+  / 除非 skill 必需，不要加入应用源码、生成物或包管理文件。
+
+## Structure / 结构
+
+- Use lowercase hyphenated directories with the `rtthread-` prefix:
+  `rtthread-create-bsp/`, `rtthread-git-commit/`.
+  / 目录使用小写连字符命名，并使用 `rtthread-` 前缀。
+- Keep shared files at the root: `README.md`, `LICENSE`, `AGENTS.md`. / 根目录仅保留共享文件。
+- Add supporting files inside the owning skill directory. / 支撑文件放在所属 skill 目录内。
+
+## Commands / 命令
+
+Run these checks before submitting changes: / 提交前运行以下检查：
+
+```sh
+rg --files
+git diff --check
+rg -n "^(name|description):" */SKILL.md
+npx markdownlint-cli2 "**/*.md"
+```
+
+- `rg --files`: inspect tracked layout. / 检查文件布局。
+- `git diff --check`: reject whitespace errors. / 检查空白符错误。
+- Metadata search: confirm `name` and `description`. / 确认元数据完整。
+- `markdownlint-cli2`: optional Markdown lint. / 可选 Markdown 检查。
+
+## Style / 风格
+
+- Start every `SKILL.md` with YAML front matter.
+  / 每个 `SKILL.md` 以 YAML front matter 开头。
+
+```yaml
+---
+name: rtthread-review
+description: Use when reviewing RT-Thread C code.
+---
+```
+
+- Keep skill names lowercase and hyphenated with the `rtthread-` prefix.
+  / skill 名称使用小写连字符，并使用 `rtthread-` 前缀。
+- Prefer short headings, checklists, and executable commands. / 优先使用短标题、清单和可执行命令。
+- Preserve Chinese technical guidance in existing Chinese skills.
+  / 保留现有中文 skill 的中文技术表达。
+
+## Validation / 验证
+
+- There is no build or test suite. / 本仓库没有构建或测试套件。
+- Validate by reading the changed skill as an agent instruction. / 以 agent 指令视角阅读并验证修改。
+- New workflows must state inputs, steps, outputs, and done criteria. / 新流程必须说明输入、步骤、输出和完成标准。
+
+## Commits & PRs / 提交与 PR
+
+- Use scoped commit titles: `module: brief description`. / 提交标题使用范围前缀。
+- Example: `rtthread-review: tighten resource safety checklist`.
+- Keep each commit focused on one skill or one documentation change.
+  / 每次提交只包含一个 skill 或一个文档改动。
+- PRs must list changed directories, validation commands, and behavior examples
+  when relevant.
+  / PR 需列出修改目录、验证命令及必要的行为示例。
diff --git a/README.md b/README.md
index fd97a09..b1b3f74 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,3 @@
 # rtthread-skills
+
 SKILLs for RT-Thread & Embedded System Developement
diff --git a/rtthread-create-bsp/SKILL.md b/rtthread-create-bsp/SKILL.md
new file mode 100644
index 0000000..519d2d8
--- /dev/null
+++ b/rtthread-create-bsp/SKILL.md
@@ -0,0 +1,218 @@
+---
+name: rtthread-create-bsp
+description: Use when creating a new RT-Thread BSP from local chip datasheets and optional vendor driver libraries, with minimum kernel plus UART plus shell bring-up under rt-thread/bsp.
+---
+
+# RT-Thread Create BSP
+
+## Role
+
+你是一位精通 RT-Thread BSP 架构与芯片底层初始化的嵌入式工程师，能
+基于本地芯片手册（含寄存器描述）和外设驱动库，产出规范、可编译、
+可维护的 BSP。
+
+## Goal
+
+在 `rt-thread/bsp` 下正确位置创建一个新 BSP，默认交付最小可运行功能：
+
+- 内核启动
+- UART 控制台
+- FinSH shell
+
+同时满足 RT-Thread 社区风格：简洁、清晰、可移植，并优先遵循同 vendor
+下已有 BSP 的命名与目录习惯。
+
+## Scope
+
+本 skill 默认只做最小 BSP 使能，不强制包含 SPI/I2C/网络/文件系统等扩展
+驱动。先保证“可启动 + 可串口交互 + 可进入 msh”。
+
+## Required Input
+
+用户至少提供：
+
+- `rt-thread` 仓库根目录本地路径
+- 厂商名和开发板名（用于目录命名）
+- MCU 型号、内核架构、FLASH/RAM 大小
+- 本地数据手册与参考手册路径（寄存器定义必须可查）
+- 可用的厂商外设驱动库路径（如有）
+- 目标工具链（gcc/mdk/iar）
+- 用作控制台的 UART 实例与引脚信息
+
+## Directory Rule
+
+BSP 路径必须放在：
+
+`rt-thread/bsp/<vendor>/<board_name>/`
+
+命名规则：
+
+- `vendor`：全小写，如 `stm32`、`nxp`、`gd32`
+- `board_name`：遵循同 vendor 下已有 BSP 命名，通常全小写，可使用连字符，
+  如 `stm32f407-rt-spark`
+
+## Minimal BSP Layout
+
+优先参考同 vendor、同芯片系列或同 CPU 架构的已有 BSP，并保持其目录组织、
+Kconfig 分层、SConscript 写法和驱动命名习惯。下面是最小 BSP 的参考结构，
+不是必须强制套用的统一模板。
+
+```text
+rt-thread/bsp/<vendor>/<board_name>/
+├── rtconfig.py
+├── SConstruct
+├── SConscript
+├── Kconfig
+├── README.md
+├── board/
+│   ├── board.c
+│   ├── board.h
+│   ├── Kconfig
+│   ├── SConscript
+│   └── linker_scripts/
+│       └── link.lds
+├── drivers/
+│   ├── drv_uart.c
+│   ├── drv_uart.h
+│   └── SConscript
+└── applications/
+    ├── main.c
+    └── SConscript
+```
+
+## Workflow
+
+1. 解析芯片资料  
+   从手册提取最小启动必需信息：时钟树、内存映射、中断号、UART 寄存器、
+   UART 时钟源与 GPIO 复用。
+2. 选择 BSP 落点  
+   确认 `rt-thread/bsp/<vendor>/<board_name>` 路径及命名，并找出最接近的
+   同 vendor/同系列 BSP 作为模板。
+3. 建立构建骨架  
+   优先复制并裁剪相近 BSP 的 `rtconfig.py`、`SConstruct`、`SConscript`、
+   `Kconfig`，只保留当前最小 BSP 所需内容。
+4. 完成板级初始化  
+   在 `board/board.c` 实现 `rt_hw_board_init`，至少完成时钟、中断、heap、
+   控制台设备准备。
+5. 实现 UART 驱动  
+   优先复用厂商驱动库；无库时按寄存器实现最小 UART。接入
+   `rt_serial_device` 框架并注册设备。
+6. 使能 shell  
+   保证控制台设备名、串口驱动、FinSH 配置一致，启动后可进入 `msh />`。
+7. 完善文档  
+   `README.md` 说明硬件资源、编译方式、下载步骤、串口输出示例。
+8. 验证构建  
+   先运行 `scons --menuconfig` 或 `scons --pyconfig-silent` 更新 `.config` 和
+   `rtconfig.h`，再运行 `scons`；若用户环境支持，再验证
+   `scons --target=mdk5` 或 `scons --target=iar`。
+
+## Implementation Rules
+
+### 1) 命名与风格
+
+- 文件名、函数名、变量名：遵循同 vendor 下已有 BSP 风格，通常全小写；
+  C 符号使用下划线，目录名可按既有 BSP 使用连字符或下划线
+- 宏：全大写下划线
+- 代码类型优先使用 RT-Thread 类型（`rt_uint32_t`、`rt_err_t` 等）
+
+### 2) 可移植性
+
+- 板级差异通过 `board.h` 与 Kconfig 宏隔离
+- 驱动通过 RT-Thread 设备框架暴露，不把芯片寄存器细节泄露到应用层
+
+### 3) 最小功能边界
+
+- 只保证 kernel + uart + shell 跑通
+- 额外外设默认不纳入首版 BSP
+
+### 4) 资料优先级
+
+- 第一优先级：芯片参考手册/数据手册
+- 第二优先级：厂商驱动库（仅作为实现参考）
+- 冲突时以手册为准，注释中说明差异
+
+## Key File Requirements
+
+### rtconfig.py
+
+- 必须定义工具链和架构关键变量（如 `PLATFORM`、`ARCH`、`CPU`、`EXEC_PATH`）
+- 工具链路径优先读环境变量，减少硬编码
+
+### SConstruct
+
+- 正确导入 `rtconfig` 与 `building.py`
+- 调用 `PrepareBuilding` 和 `DoBuilding`
+- 包含 BSP 根 `SConscript`
+
+### SConscript
+
+- 聚合 `board/`、`drivers/`、`applications/` 的对象文件
+- 仅加入当前最小 BSP 所需源文件
+
+### Kconfig
+
+- BSP 根 `Kconfig` 作为入口，`source` 到 `board/Kconfig`
+- `board/Kconfig` 定义最小串口相关开关（如 `BSP_USING_UART1`）
+
+### board/board.c
+
+- 必须实现 `rt_hw_board_init`
+- 至少初始化：中断、heap、UART 所需底层时钟/IO、控制台设备
+
+### drivers/drv_uart.c
+
+- 接入 RT-Thread 串口框架（`rt_serial_device` / `rt_hw_serial_register`）
+- 保障控制台可收发，支持 shell 基本交互
+
+### applications/main.c
+
+- 保持最小入口，避免塞入业务逻辑
+- 启动后不阻塞系统调度
+
+### README.md
+
+至少包含：
+
+- 板卡和 MCU 简介
+- 当前支持能力（仅 kernel + uart + shell）
+- 编译与下载步骤
+- 串口参数与启动日志示例
+- 已知限制与后续扩展建议
+
+## Output Contract
+
+生成结果应包含：
+
+1. `rt-thread/bsp` 下新 BSP 完整目录与文件
+2. 可直接执行的构建命令
+3. 最小启动日志示例（含 shell 提示符）
+4. 已支持与未支持外设清单
+
+## Done Checklist
+
+- [ ] BSP 路径位于 `rt-thread/bsp/<vendor>/<board_name>`
+- [ ] 命名遵循同 vendor 下已有 BSP 风格
+- [ ] `rtconfig.py` / `SConstruct` / `SConscript` / `Kconfig` 齐全
+- [ ] `board.c` 已实现 `rt_hw_board_init`
+- [ ] UART 驱动已注册并可作为控制台
+- [ ] 上电后可进入 FinSH shell
+- [ ] 已通过 `scons --menuconfig` 或 `scons --pyconfig-silent` 更新 `.config`
+      和 `rtconfig.h`
+- [ ] `scons` 编译通过
+- [ ] `README.md` 完整说明最小 BSP 用法
+
+## Input Template
+
+```text
+rtthread_root: /path/to/rt-thread
+vendor: stm32
+board_name: stm32f407-rt-spark
+mcu: STM32F407VGT6 (Cortex-M4, 168MHz, 1MB Flash, 192KB RAM)
+toolchain: gcc
+datasheet_paths:
+  - /path/to/datasheet.pdf
+  - /path/to/reference_manual.pdf
+driver_lib_path: /path/to/hal_or_sdk (optional)
+console_uart: uart1
+console_pins: pa9/pa10
+```
diff --git a/rtthread-create-pkg/SKILL.md b/rtthread-create-pkg/SKILL.md
new file mode 100644
index 0000000..dfda6c1
--- /dev/null
+++ b/rtthread-create-pkg/SKILL.md
@@ -0,0 +1,187 @@
+---
+name: rtthread-create-pkg
+description: Use when creating a new RT-Thread package that follows community naming and layering rules, with default inc/src layout and package-local Kconfig for easier management.
+---
+
+# RT-Thread Create Package
+
+## Role
+
+你是一位精通 RT-Thread 软件包生态的嵌入式工程师，熟悉社区代码风格、
+面向对象 C 设计方法，以及软件包索引与构建流程。
+
+## Goal
+
+从零创建一份符合 RT-Thread 风格的软件包，默认结构为：
+
+- 头文件放在 `inc/`
+- 源码放在 `src/`
+- 软件包内包含 `Kconfig`（便于统一管理）
+
+并同时给出可用于 packages 索引仓库的 `Kconfig` 与 `package.json` 模板。
+
+## Design Principles
+
+1. 简洁清晰：命名统一、目录明确、职责单一。
+2. 面向对象：用 `struct` 封装状态，用函数指针表抽象行为。
+3. 接口最小化：公开 API 少而稳，内部细节用 `static` 隐藏。
+4. 可移植：通过 Kconfig 宏和 RT-Thread 框架隔离平台差异。
+5. 可维护：文档、示例、构建脚本齐全且可直接使用。
+
+## Naming Rules
+
+- 包名：按功能命名，全小写，建议连字符（如 `sensor-aht10`、`webclient`），
+  不默认添加 `rt-thread-` 或 `rtthread-` 前缀。
+- 目录名：全小写（如 `inc`、`src`、`examples`、`docs`）。
+- 文件名：全小写下划线（如 `foo_core.c`、`foo_port.c`）。
+- 函数/变量：全小写下划线。
+- 宏：全大写下划线。
+
+## Default Layout
+
+```text
+<pkg-name>/
+├── LICENSE
+├── README.md
+├── Kconfig
+├── SConscript
+├── inc/
+│   └── <pkg_name>.h
+├── src/
+│   ├── <pkg_name>.c
+│   └── <pkg_name>_internal.h
+├── examples/
+│   ├── SConscript
+│   └── <pkg_name>_sample.c
+├── docs/
+│   ├── api.md
+│   ├── architecture.md
+│   └── diagrams/
+│       └── architecture.puml
+└── tests/                      # optional
+    └── utest_<pkg_name>.c
+```
+
+## Kconfig Policy
+
+通常软件包可不放 `Kconfig`，但本 skill 默认**在包内保留 `Kconfig`**，用于：
+
+- 集中管理配置项
+- 降低维护成本
+- 便于后续同步到 packages 索引仓库
+
+规则：
+
+- 包内 `Kconfig` 作为私有配置入口。
+- packages 索引中的 `Kconfig` 保留主开关与版本选择。
+- 两者的宏命名保持一致，避免配置漂移。
+
+## Workflow
+
+1. 定义包边界  
+   明确包功能、是否需要线程、是否依赖 RT-Thread 特定框架。
+2. 创建目录骨架  
+   生成 `LICENSE`、`README.md`、`Kconfig`、`SConscript`、`inc/`、`src/`、
+   `examples/`。
+3. 设计最小 API  
+   对外仅暴露必要接口，内部状态放入私有结构体。
+4. 编写构建脚本  
+   通过 `GetDepend()` 控制条件编译，默认编译 `src/*.c`。
+5. 增加示例与文档  
+   提供可运行示例；README 与 docs 使用 Markdown；图用 PlantUML。
+6. 生成索引模板  
+   给出 packages 仓库所需 `Kconfig` 与 `package.json`。
+7. 编译验证  
+   至少确保在 RT-Thread 工程中可通过 `scons` 构建。
+
+## Core File Requirements
+
+### 1) Package `Kconfig` (in package root)
+
+- 主开关：`PKG_USING_<PKG_NAME>`
+- 版本选项：`choice/endchoice`
+- 私有配置：`<PKG_NAME>_<OPTION>`
+- 支持依赖声明：`select` / `depends on`
+
+### 2) Root `SConscript`
+
+- `CPPPATH` 默认包含 `inc/`
+- 仅在 `GetDepend('PKG_USING_<PKG_NAME>')` 时编译 `src/*.c`
+- 可选包含 `examples/SConscript`
+
+### 3) Public Header (`inc/<pkg_name>.h`)
+
+- 提供最小公开 API
+- 头文件保护宏完整
+- 不暴露内部结构细节（必要时使用前向声明）
+
+### 4) Source (`src/*.c`)
+
+- 私有函数使用 `static`
+- 错误路径释放资源
+- 类型优先使用 RT-Thread 标准类型
+
+### 5) README + Docs
+
+- README 至少包含：简介、特性、依赖、快速上手、API 摘要、示例
+- `docs/` 至少包含：`api.md`、`architecture.md`
+- `docs/diagrams/*.puml` 存放 PlantUML 源文件（架构图/时序图/状态图）
+
+## OOP Pattern (C Style)
+
+- 用结构体封装对象状态（如 `struct foo_device`）。
+- 用 `ops` 函数指针表实现多态（如 `init/read/write/control`）。
+- 通过“父结构体作为首成员”方式兼容 RT-Thread 设备框架扩展。
+
+## Packages Index Output
+
+创建软件包后，需额外产出索引模板（用于 `RT-Thread/packages`）：
+
+1. `packages/<category>/<pkg-name>/Kconfig`
+2. `packages/<category>/<pkg-name>/package.json`
+
+其中 `package.json` 至少包含：
+
+- `name`
+- `description`
+- `category`
+- `author`
+- `license`
+- `repository`
+- `site`（版本与下载信息）
+
+## Output Contract
+
+执行本 skill 后应给出：
+
+1. 软件包目录树（含 `inc/`、`src/`、包内 `Kconfig`）
+2. 关键模板文件内容（`Kconfig`、`SConscript`、`README`、`package.json`）
+3. 最小 API 与示例代码骨架
+4. 可直接运行的构建与验证命令
+
+## Done Checklist
+
+- [ ] 包名与目录命名符合规范（全小写、语义清晰）
+- [ ] 头文件在 `inc/`，实现文件在 `src/`
+- [ ] 包内 `Kconfig` 已创建并可管理核心配置
+- [ ] `SConscript` 使用 `GetDepend()` 做条件编译
+- [ ] README 与示例可帮助用户快速上手
+- [ ] docs 含 Markdown 与 PlantUML 源文件
+- [ ] 索引模板（`Kconfig` + `package.json`）可用于 packages 仓库
+- [ ] 在 RT-Thread 工程中可通过 `scons` 编译
+
+## Input Template
+
+```text
+package_name: sensor-aht10
+category: misc
+description: brief package description
+rtthread_framework: none / sensor / device / dfs / netdev
+need_worker_thread: yes/no
+expected_api:
+  - foo_init
+  - foo_open
+  - foo_read
+license: Apache-2.0
+repository: https://github.com/xxx/sensor-aht10
+```
diff --git a/rtthread-git-commit/SKILL.md b/rtthread-git-commit/SKILL.md
new file mode 100644
index 0000000..27cf26e
--- /dev/null
+++ b/rtthread-git-commit/SKILL.md
@@ -0,0 +1,80 @@
+---
+name: rtthread-git-commit
+description: Use when preparing RT-Thread related commits and you need concise module-scoped commit messages that follow community style.
+---
+
+# RT-Thread Git Commit
+
+## Role
+
+你是一位熟悉 RT-Thread 项目文化的资深嵌入式工程师，能写出符合社区简洁、清晰惯例的 Git 提交信息。
+
+## Goal
+
+分析用户的修改内容，将其拆分为多个语义独立的提交块，并生成符合
+RT-Thread 风格的 commit message。只有用户明确要求提交时，才逐个执行
+`git add` 和 `git commit`。
+
+## 分块提交流程
+
+当用户调用此 skill 时，执行以下流程：
+
+1. **扫描改动**：执行 `git status` 和 `git diff` 分析当前仓库的所有修改。
+2. **识别功能块**：根据改动文件路径和内容，识别出逻辑上相互独立的功能块（如：驱动的独立修改、组件的独立修改、BSP 的独立修改、跨文件的同类修改等）。
+3. **用户确认**：展示识别出的功能块列表，供用户确认或调整分块方式。
+4. **确认验证**：为每个功能块列出已运行或建议运行的验证命令与结果。
+5. **生成消息**：为每个功能块生成 commit message。
+6. **可选提交**：仅当用户明确要求实际提交时，对每个功能块依次执行：
+   - `git add <该块涉及的文件>`
+   - 默认使用 `git commit -m "<message>"`
+   - 仅当用户或仓库规则要求签名提交时，使用 `git commit -S -m "<message>"`
+7. **完成报告**：汇总本次消息建议或已创建 commit 及其描述。
+
+## Guidelines
+
+### 格式要求
+
+- **标题行**：`模块: 简短描述`
+  - 模块名使用受影响的仓库路径或模块名，保持 lowercase，优先贴近源码目录，
+    如 `bsp/stm32`、`components/drivers/spi`、`kernel/sched`。
+  - 简短描述用英文或中文，动词开头，不超过 50 字符，不带句号。
+- **正文**（可选但推荐有说明）：
+  - 每行不超过 72 字符。
+  - 说明修改 **为什么** 是必要的（问题现象或设计缺陷）。
+  - 简述 **实现思路**，保持描述简单直白。
+  - 指出 **影响范围**（某个 BSP、组件或配置宏）。
+  - 注明 **验证命令、测试环境与结果**（开发板、编译器、RT-Thread 版本、
+    测试用例）。
+- **尾部**：若有关联 Issue 或 PR，写 `Fixes #123`。
+
+### 内容风格
+
+- 用词精炼，避免冗余修饰。
+- 路径和模块名应贴近仓库目录；代码符号在提交信息中保持 RT-Thread C 命名，
+  如 `rt_device_read` 而不是 `rt_device_read()`。
+- 体现 RT-Thread 的简洁与可移植性追求。
+
+## Example
+
+```text
+bsp/stm32: 修复 spi3 dma 发送完成回调未调用问题
+
+spi3 dma 传输结束后，应用层等待的信号量永不返回。原因是 stm32 hal 库
+dma 回调未连接到 rt-thread 驱动框架的完成函数。
+
+解决：在 drv_spi.c 的 dma 初始化中显式注册 xfer_cplt_callback。
+
+影响范围：仅 stm32f407-rt-spark bsp 中使用 spi3 dma 的情形。
+验证命令：scons --menuconfig && scons。
+测试环境：stm32f407-rt-spark，gcc 10.3，rt-thread v5.0.2。
+测试用例：spi_dma_sample.c 连续发送 1KB 数据，无超时。
+```
+
+## Input
+
+请用户提供：
+
+- 本次修改涉及的主要文件或模块名。
+- 修改背景及原因。
+- 测试验证方法。
+- **重要**：若修改涉及多个独立功能块，请明确告知每个块对应的文件或模块，以便分块提交。
diff --git a/rtthread-git-rebase/SKILL.md b/rtthread-git-rebase/SKILL.md
new file mode 100644
index 0000000..abdf8ee
--- /dev/null
+++ b/rtthread-git-rebase/SKILL.md
@@ -0,0 +1,82 @@
+---
+name: rtthread-git-rebase
+description: Use when rebasing RT-Thread work onto latest upstream master and cleaning unmerged local commits into a clear patch series.
+---
+
+# RT-Thread Git Rebase
+
+## Role
+
+你是 RT-Thread 维护者助手，指导开发者使用 `git rebase` 整理提交历史，保持主线清晰线性。
+
+## Goal
+
+帮助用户先同步 RT-Thread 上游 `master`，再将当前分支 rebase 到最新基线，
+并把未合并提交整理成逻辑清晰、提交信息准确的补丁序列。
+
+## Guidelines
+
+### 操作前提
+
+- 优先使用 RT-Thread 上游远端（通常是 `upstream`）作为基线。
+- 若未配置 `upstream`，先确认 `origin` 是否就是 RT-Thread 官方仓库。
+- 同步上游最新 `master`：
+  `git fetch upstream master`
+- 确认分叉点：
+  `git merge-base HEAD upstream/master`
+- 提醒用户：rebase 会改写历史，若分支已被他人拉取，推送时需谨慎使用
+  `--force-with-lease`。
+
+### 交互式 rebase 命令说明
+
+- `pick`：保留提交。
+- `reword`：仅修改提交信息。
+- `squash` / `fixup`：合并到上一个提交并丢弃或保留信息。
+- `edit`：暂停以便修改提交内容（如拆分或调整代码）。
+- `drop`：彻底删除提交。
+
+### 未合并提交整理原则
+
+- 以 `upstream/master..HEAD` 作为“待整理提交”范围。
+- WIP、临时调试、fix typo 等碎片提交应合并到对应逻辑提交。
+- 一个提交只做一类改动，且尽量保持“可独立编译、可独立审阅”。
+- 提交顺序按依赖关系排列，先基础改动，再功能改动。
+
+### RT-Thread 特定原则
+
+- **一个逻辑改动一个提交**：修复同一驱动 bug 的多次尝试应 squash 为一个补丁。
+- **提交必须可独立编译**：即 `scons` 能至少生成一个目标工程。
+- **避免合并提交**：禁止将上游更新合并到特性分支，必须使用 rebase 保持历史线性。
+- **提交信息简洁清晰**：标题为 `模块: 简述`，正文说明原因与影响。
+
+### commit message 质量要求
+
+- 标题准确表达改动目的，避免 `fix bug`、`update` 这类模糊描述。
+- 标题推荐格式：`模块: 简述`。
+- 正文优先写清：问题现象、根因、解决思路、影响范围。
+- 若涉及测试，补充测试环境和结果，确保补丁可审阅可复现。
+
+### 冲突处理
+
+当 rebase 过程中出现冲突：
+
+1. 编辑冲突文件，保留正确代码。
+2. `git add <resolved-files>`
+3. `git rebase --continue`
+
+若不确定如何解决，可提供错误输出以供分析。
+
+## Workflow
+
+1. 检查远端与分支：确认 `upstream/master` 可用并已 `fetch` 最新。
+2. 列出未合并提交：基于 `upstream/master..HEAD` 评估需要保留/合并/删除的提交。
+3. 给出 `git rebase -i upstream/master` 清单（pick/reword/squash/fixup/edit/drop）。
+4. 冲突时指导逐个文件解决并继续 rebase。
+5. rebase 完成后复查历史与 commit message，必要时二次 `rebase -i --reword`。
+6. 最后提示推送策略：`git push --force-with-lease`。
+
+## Input
+
+- 当前分支名。
+- 上游远端与基线分支（如 `upstream/master`）。
+- 未合并提交的大致数量与现状（如 WIP 多、message 不清晰、需合并为几条）。
diff --git a/rtthread-review/SKILL.md b/rtthread-review/SKILL.md
new file mode 100644
index 0000000..eea187e
--- /dev/null
+++ b/rtthread-review/SKILL.md
@@ -0,0 +1,79 @@
+---
+name: rtthread-review
+description: Use when reviewing RT-Thread C code for naming style, portability, resource safety, and framework compliance.
+---
+
+# RT-Thread Review
+
+## Role
+
+你是 RT-Thread 项目代码审查员，严格依据社区的简洁、清晰、可移植原则评审代码。
+
+## Goal
+
+对用户提供的 RT-Thread 代码进行全面 review，指出违反风格指南或设计原则的问题，并给出具体修改建议。
+
+## Review Checklist
+
+### 1. 命名风格（Unix 哲学，全小写下划线）
+
+- **文件名**：如 `drv_spi.c`、`sensor_asair_aht10.c`，禁止驼峰或大小写混用。
+- **函数名**：全小写下划线，动词在前，如 `rt_device_read`、`aht10_read_temperature`。
+- **变量名**：全小写下划线，意义明确，如 `dev_count`、`rx_buffer`。
+- **宏/枚举常量**：全大写下划线，如 `AHT10_I2C_ADDR`。
+- **结构体/类型名**：全小写下划线，可加 `_t` 后缀表示类型，
+  如 `struct aht10_device`、`typedef struct rt_device *rt_device_t`。
+
+### 2. 简洁清晰原则
+
+- 避免过长函数；函数职责应单一，必要时按现有模块风格拆分辅助函数。
+- 避免深层嵌套逻辑（>3 层），采用早返回或拆分辅助函数。
+- 注释用于解释 **为什么** 而非重复代码；公开 API 注释应清晰，并优先遵循
+  现有模块注释风格。
+
+### 3. C 语言面向对象实践
+
+- 设备/组件通过结构体封装状态
+  （如 `struct aht10_device { struct rt_i2c_bus_device *i2c; ... };`）。
+- 使用函数指针表（ops）模拟多态，如 `struct rt_device_ops`。
+- 继承关系通过结构体第一个成员包含父结构体实现（如 `struct my_dev { struct rt_device parent; ... };`）。
+
+### 4. 模块接口清晰、可移植
+
+- 硬件相关代码必须用宏条件编译隔离（如 `#ifdef BSP_USING_SPI1`）。
+- 对外暴露的 API 数量尽量少，参数简单，易于其他平台复用。
+- 禁止在通用组件中直接操作寄存器，应通过 RT-Thread 驱动框架接口（如 `rt_device_read`）或 HAL 层。
+- 使用标准 RT-Thread 数据类型（`rt_uint8_t`、`rt_err_t` 等）而非裸 C 类型。
+
+### 5. 资源与并发管理
+
+- 动态内存分配后必须在所有错误路径中释放。
+- 共享数据访问必须加锁（互斥量或关中断），优先使用 `rt_mutex_t` 保护非 ISR 上下文。
+- ISR 内严禁调用可能阻塞的 API（如 `rt_sem_take` 带非零超时）。
+- 线程栈大小需根据局部变量估算并留有裕量。
+
+### 6. 错误处理
+
+- 检查关键 API 返回值（如 `rt_device_open`、`rt_malloc`）。
+- 错误码使用 RT-Thread 标准负值：`-RT_ERROR`、`-RT_ETIMEOUT` 等。
+
+## Output Format
+
+以清单列出问题，按严重程度分类：
+
+- **严重**：可能导致崩溃、死锁、内存泄漏或严重不符合规范。
+- **一般**：影响可读性、可维护性或轻微性能问题。
+- **建议**：优化性改进，非强制。
+
+每一项包含：
+
+- **位置**（文件名:行号或函数名）
+- **问题描述**
+- **修改建议**（附代码示例）
+
+## Input
+
+用户可提供：
+
+- 代码片段、文件链接或 PR 链接。
+- 修改目的简述。