awtk-dev

스타12

포크1

업데이트2026년 3월 2일 07:28

AWTK项目开发规范检查和编译验证。Invoke when user is working on AWTK project code modifications, before code review, or when compiling AWTK applications.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

XL-Hello

XL-Hello/AIcode

GitHub 저장소 열기 Creator 저장소 보기

다운로드

AWTK 项目开发规范

1. 代码规范检查

进行代码修改时，首先必须确保符合项目技能中的代码规范要求：

参考文档: /home/xl/dreame/AIcode/skills/review-code_2/code_spec/dreame_code.md

1.1 命名与代码风格

项目	规范
缩进风格	4个空格
大括号风格	K&R 风格（左大括号与函数/结构体/枚举等在同一行）
变量命名	驼峰命名法（首字母小写）
函数命名	模块前缀_驼峰格式，如 `keybind_reportProp`、`dreUI_logI`
文件命名	下划线命名法（全小写）

1.2 注释要求

所有函数、结构体、枚举必须添加注释
注释使用中文
单行注释：// 函数功能概述
多行注释：/* 功能概述、参数、返回值等 */

1.3 代码复杂度

单个源文件建议最大行数：1024
单个函数建议最大行数：128
嵌套层级建议：3层及以下

1.4 内存管理

malloc/calloc/realloc 必须与 free 配对使用
string_t* 类型不需要手动释放，由内部引用计数管理

1.5 日志记录

统一使用 dreUI_log* 系列函数
禁止使用 printf 直接输出

2. 编译验证

代码修改后，必须按以下方式进行编译验证：

2.1 模拟器版本（推荐用于开发调试）

终端中运行执行工程中AwtkApplication文件夹下的dreame.sh脚本。

2.2 嵌入式版本（完整系统构建）

# 完整构建
cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project && ./dreame.sh clean && ./dreame.sh build

# 仅 audio 核
cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project && ./dreame.sh clean audio && ./dreame.sh build audio

# 清理构建
cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project && ./dreame.sh clean

3. 项目结构

AwtkApplication/
├── src/
│   ├── main.c              # 入口点
│   ├── application.c       # 应用程序逻辑
│   ├── pages/              # 页面实现
│   └── dreame/             # Dreame 品牌功能
│       ├── cardPage/       # 卡片式 UI 组件
│       ├── custom_widgets/ # 自定义控件
│       ├── manager/        # 管理器（设备、网络、屏幕）
│       └── dataServer/     # 通信层
├── res/                    # 资源文件
└── dreame.sh               # 构建脚本（模拟器版本的编译脚本）

4. 开发工作流程

当处理 AWTK 项目时，按以下步骤执行：

代码修改前：确认理解上述规范要求
代码修改时：遵循命名规范、注释要求、内存管理规则
代码修改后：
- 运行模拟器版本编译验证（推荐）
- 如有需要，运行嵌入式版本完整构建
提交前：确保编译通过，无错误无警告

5. 快速编译命令

如果当前工作目录在 AwtkApplication 下，可以直接运行：

./dreame.sh

如果需要在其他位置编译，使用完整路径：

cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project/WB100-SDK/apps/awtk_launch/AwtkApplication && ./dreame.sh

이 저장소의 다른 Skills

같은 저장소

a-share-data

XL-Hello/AIcode

查询A股实时行情、历史数据、技术指标、事件、资金面与个股行业信息。Use when 用户提到股票代码、板块、技术分析、财务指标、指数成分、交易日历、宏观数据或个股所属行业。

2026-06-0512

a-share-paper-trading

XL-Hello/AIcode

A股模拟盘交易与回测技能。Use when 用户要启动模拟仓服务、创建多账户、下限价单/市价单、撤单、查询持仓资金、验证涨跌停成交逻辑或运行A股回测。

2026-06-0512

a-share-strategy-mainboard-multi-swing-defensive

XL-Hello/AIcode

A 股主板流动性池内按趋势回踩（trend_pullback）产出买入候选与持仓卖出信号；另有 realtime_quotes 批量拉取现价快照。供下单前决策；不跑回测、不自动下单。Use when 用户要选股、看实时报价、判断买卖信号或检查持仓是否触发离场条件。

2026-06-0512

tuige-shortline-trading

XL-Hello/AIcode

基于退哥短线交易规则的A股场景化决策技能。Use when 用户要按交易场景查看短线规则、做选股、判断趋势回踩、涨停回调、连板接力、洗盘结束、卖出失效或仓位纪律。

2026-06-0512

review-code-pro

XL-Hello/AIcode

Multi-dimensional code review with structured reports. Analyzes correctness, readability, performance, security, testing, and architecture, and respects project-specific conventions defined in dreame_code.md. Triggers on "review code", "code review", "审查代码", "代码审查".

2026-03-2612

code-review-excellence

XL-Hello/AIcode

Provides comprehensive code review guidance for React 19, Vue 3, Rust, TypeScript, Java, Python, and C/C++. Helps catch bugs, improve code quality, and give constructive feedback. Use when: reviewing pull requests, conducting PR reviews, code review, reviewing code changes, establishing review standards, mentoring developers, architecture reviews, security audits, checking code quality, finding bugs, giving feedback on code.

2026-03-0212

name	awtk-dev
description	AWTK项目开发规范检查和编译验证。Invoke when user is working on AWTK project code modifications, before code review, or when compiling AWTK applications.

AWTK 项目开发规范

1. 代码规范检查

进行代码修改时，首先必须确保符合项目技能中的代码规范要求：

参考文档: /home/xl/dreame/AIcode/skills/review-code_2/code_spec/dreame_code.md

1.1 命名与代码风格

项目	规范
缩进风格	4个空格
大括号风格	K&R 风格（左大括号与函数/结构体/枚举等在同一行）
变量命名	驼峰命名法（首字母小写）
函数命名	模块前缀_驼峰格式，如 `keybind_reportProp`、`dreUI_logI`
文件命名	下划线命名法（全小写）

1.2 注释要求

所有函数、结构体、枚举必须添加注释
注释使用中文
单行注释：// 函数功能概述
多行注释：/* 功能概述、参数、返回值等 */

1.3 代码复杂度

单个源文件建议最大行数：1024
单个函数建议最大行数：128
嵌套层级建议：3层及以下

1.4 内存管理

malloc/calloc/realloc 必须与 free 配对使用
string_t* 类型不需要手动释放，由内部引用计数管理

1.5 日志记录

统一使用 dreUI_log* 系列函数
禁止使用 printf 直接输出

2. 编译验证

代码修改后，必须按以下方式进行编译验证：

2.1 模拟器版本（推荐用于开发调试）

终端中运行执行工程中AwtkApplication文件夹下的dreame.sh脚本。

2.2 嵌入式版本（完整系统构建）

# 完整构建
cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project && ./dreame.sh clean && ./dreame.sh build

# 仅 audio 核
cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project && ./dreame.sh clean audio && ./dreame.sh build audio

# 清理构建
cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project && ./dreame.sh clean

3. 项目结构

AwtkApplication/
├── src/
│   ├── main.c              # 入口点
│   ├── application.c       # 应用程序逻辑
│   ├── pages/              # 页面实现
│   └── dreame/             # Dreame 品牌功能
│       ├── cardPage/       # 卡片式 UI 组件
│       ├── custom_widgets/ # 自定义控件
│       ├── manager/        # 管理器（设备、网络、屏幕）
│       └── dataServer/     # 通信层
├── res/                    # 资源文件
└── dreame.sh               # 构建脚本（模拟器版本的编译脚本）

4. 开发工作流程

当处理 AWTK 项目时，按以下步骤执行：

代码修改前：确认理解上述规范要求
代码修改时：遵循命名规范、注释要求、内存管理规则
代码修改后：
- 运行模拟器版本编译验证（推荐）
- 如有需要，运行嵌入式版本完整构建
提交前：确保编译通过，无错误无警告

5. 快速编译命令

如果当前工作目录在 AwtkApplication 下，可以直接运行：

./dreame.sh

如果需要在其他位置编译，使用完整路径：

cd /home/xl/dreame/AIcode/projects/awtk_launch/dreame_rtos_4inch_project/WB100-SDK/apps/awtk_launch/AwtkApplication && ./dreame.sh