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前端管理端AdminElement Plus组件开发页面开发前端编码Admin编码

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


2.2 niucloud-uniapp-coding-standards

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

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

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


2.3 niucloud-php-coding-standards

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

触发关键词PHP后端apiControllerServiceModel验证器字典

适用场景:开发后端 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 文件