Skip to content

AI 技能(Skills)使用指南 ​

本指南介绍如何在 Trae 或 Consor 中配置和使用 NiuCloud 系统的 AI 技能,提高开发效率。

一、技能配置 ​

1.1 安装技能 ​

将 doc 目录下的 skills 文件夹复制到项目的 .trae 或 .consor 目录下:

bash
# 复制 skills 到 .trae 目录(适用于 Trae)
cp -r doc/skills .trae/

# 或复制到 .consor 目录(适用于 Consor)
cp -r doc/skills .consor/

1.2 激活技能 ​

  1. 打开 Trae 或 Consor 设置
  2. 进入「规则和技能」选项卡
  3. 可以看到已导入的技能列表
  4. 根据需要启用相关技能

二、可用技能说明 ​

2.1 niucloud-admin-vue-coding-standards ​

功能:提供 NiuCloud 系统管理端 Vue3 编码规范

触发关键词:Vue3、前端、管理端、Admin、Element Plus、组件开发、页面开发、前端编码、Admin编码

适用场景:开发 Admin 端 Vue 功能时调用此技能


2.2 niucloud-uniapp-coding-standards ​

功能:提供 NiuCloud 手机端 uni-app 编码规范

触发关键词:uni-app、手机端、移动端、小程序、H5、APP、uniapp、跨平台、移动端编码、小程序开发、H5开发

适用场景:开发移动端功能时调用此技能


2.3 niucloud-php-coding-standards ​

功能:提供 NiuCloud PHP 后端编码规范

触发关键词:PHP、后端、api、Controller、Service、Model、验证器、字典

适用场景:开发后端 API 和业务逻辑时调用此技能


2.4 niucloud-code-generator ​

功能:提供 NiuCloud 系统一键生成增删改查代码功能

触发关键词:代码生成、CRUD、增删改查、生成器、快速开发、代码模板、生成代码

适用场景:需要快速生成业务代码时调用此技能


2.5 niucloud-module ​

功能:通用模块开发框架,包含后台管理、API 接口、数据库表、前端页面等完整功能

触发关键词:模块开发、模块、通用模块、后台开发、API开发

适用场景:开发和集成各种业务模块时调用此技能

三、使用方式 ​

3.1 自动触发 ​

在配置好技能后,当开发内容匹配到技能的触发关键词时,AI 会自动调用相应的技能规范进行代码生成和审查。

3.2 手动指定 ​

在开发过程中,可以通过明确指定来调用技能:

请使用 niucloud-admin-vue-coding-standards 技能帮我开发这个列表页面

或

使用 niucloud-code-generator 帮我生成角色的增删改查代码

3.3 整体开发触发 ​

在进行整体项目开发时,AI 会根据上下文自动识别并应用相关技能规范,确保代码符合 NiuCloud 系统的开发标准。

四、技能文件结构 ​

skills/
├── niucloud-admin-vue-coding-standards/
│   └── SKILL.md                    # Admin Vue3 编码规范
├── niucloud-uniapp-coding-standards/
│   └── SKILL.md                    # Uni-app 编码规范
├── niucloud-php-coding-standards/
│   └── SKILL.md                    # PHP 编码规范
├── niucloud-code-generator/
│   └── SKILL.md                    # 代码生成器规范
└── niucloud-module/
    ├── SKILL.md                    # 模块开发框架
    ├── README.md                   # 模块说明文档
    ├── backend/
    │   └── controller/             # 后端控制器模板
    ├── frontend/
    │   ├── admin/                  # Admin 端页面模板
    │   └── uni-app/               # Uni-app 端页面模板
    └── sql/
        └── tables.md              # 数据库表结构规范

五、注意事项 ​

  1. 技能更新:随着系统迭代,技能规范可能会有更新,请定期同步 doc/skills 目录
  2. 关键词匹配:确保开发描述中包含足够的触发关键词,以便 AI 准确识别
  3. 规范遵守:建议优先遵循技能规范执行开发,以保持代码风格一致性
  4. 自定义扩展:如需扩展或修改技能规范,可直接编辑对应目录下的 SKILL.md 文件