快速为自己项目创建skill技能，让AI快速了解你的项目

sugar1569

897人浏览 · 2026-03-25 20:52:02

sugar1569 · 2026-03-25 20:52:02 发布

陀螺匠 Skills 制作说明与使用指南

📅 最后更新: 2026-03-25
👤 适用版本: 陀螺匠 Skills v1.0.0

📑 目录导航

第一部分：创建 Skill
第二部分：Trae IDE 使用指南
第三部分：项目现有 Skills
- 3.1 tuoluojiang_api
- 3.2 tuoluojiang_admin

第一部分：创建 Skill

1.1 什么是 Skill？

Skill（技能包） 是一种可复用的 AI 助手扩展包，用于为 AI 提供特定项目或领域的专业知识、工作流程和工具支持。

🎯 Skill 的作用

📚 提供项目知识：让 AI 了解项目的技术栈、架构、规范
💻 代码模板：提供可复用的代码模板
🚀 开发工具：集成代码生成、规范化检查等工具
📖 文档导航：快速查阅相关文档
🔧 最佳实践：提供开发建议和最佳实践

💡 什么时候需要创建 Skill？

创建新的项目模块时
积累了一定的开发规范和模板时
希望团队成员快速上手项目时
希望 AI 能够更好地理解项目时

1.2 Skill 目录结构

一个标准的 Skill 目录结构如下：

skill_name/                      # Skill 名称（小写，用下划线分隔）
├── SKILL.md                    # ✅ 必需：技能说明文档
├── README.md                   # ✅ 必需：使用说明
├── assets/                     # 📁 代码模板目录
│   ├── ControllerTemplate.php
│   ├── ModelTemplate.php
│   └── ...
├── references/                # 📁 参考文档目录
│   ├── 01-项目概述.md
│   ├── 02-开发规范.md
│   └── ...
└── scripts/                   # 📁 脚本工具目录
    ├── create_api.php
    └── check_api.php

📁 目录说明

目录	说明	必需
`SKILL.md`	技能主文档，包含触发条件、功能说明	✅ 必需
`README.md`	使用说明、安装方式、快速开始	✅ 必需
`assets/`	代码模板文件	可选
`references/`	参考文档（Markdown 格式）	可选
`scripts/`	可执行脚本工具	可选

1.3 必需文件说明

📝 SKILL.md - 技能主文档

这是最重要的文件，用于告诉 AI 什么时候该使用这个 Skill。

位置: 必须放在 Skill 根目录

作用:

定义触发条件（何时使用此 Skill）
提供文档导航
说明核心功能和工具

📖 README.md - 使用说明

提供人类可读的使用说明。

位置: 必须放在 Skill 根目录

作用:

介绍 Skill 功能
安装说明
快速开始指南
技术栈说明

1.4 SKILL.md 格式规范

# 技能标题

## 1. 技能概述

**技能名称**: skill_name
**技能版本**: 1.0.0
**技能描述**: 简短的技能描述
**适用场景**: 适用的场景说明
**触发条件**:
- 触发条件1
- 触发条件2
- 当用户打开或编辑某些文件时

**触发关键词**:
- 关键词1
- 关键词2
- 关键词3

## 2. 文档导航

| 文档名称 | 描述 | 路径 |
|---------|------|------|
| 文档1 | 描述 | [链接](path/doc.md) |

## 3. 核心功能

详细的功能说明...

## 4. 使用示例

代码示例或使用示例...

📌 关键要素

触发条件：明确说明什么情况下使用此 Skill
触发关键词：列出相关的关键词
文档导航：提供清晰的文档链接
使用示例：提供实际的使用示例

1.5 制作流程

📋 步骤 1：规划 Skill

在开始制作之前，先回答以下问题：

❓ 这个 Skill 的目的是什么？
❓ 目标用户是谁？（AI 助手 / 开发者）
❓ 需要包含哪些内容？（文档 / 模板 / 工具）
❓ 如何组织内容结构？

📋 步骤 2：创建目录结构

# 进入项目的 .trae/skills 目录
cd /你的项目路径/.trae/skills

# 创建 Skill 目录
mkdir -p your_skill_name

# 创建子目录
mkdir -p your_skill_name/{assets,references,scripts}

📋 步骤 3：编写 SKILL.md

参考上文格式，编写技能主文档。

示例：

# 我的项目技能

## 1. 技能概述

**技能名称**: my_project
**技能版本**: 1.0.0
**技能描述**: 我的项目开发技能包
**触发条件**:
- 当用户询问项目相关问题时
- 当用户打开或编辑项目文件时
- 当用户询问开发规范时

**触发关键词**:
- 我的项目
- 项目规范
- 项目结构

## 2. 文档导航

| 文档名称 | 描述 |
|---------|------|
| 项目概述 | 项目简介 |
| 开发规范 | 代码规范 |

## 3. 核心功能

详细的功能说明...

## 4. 使用示例

代码示例或使用示例...

📋 步骤 4：编写 README.md

编写人类可读的使用说明。

示例：

# 我的项目技能

🎯 **让 AI 助手更懂我的项目！**

## 📖 简介

这是我的项目开发技能包...

## ✨ 功能特点

- 📚 详细的项目文档
- 💻 代码模板
- 🚀 开发工具

## 🛠️ 快速开始

### 生成代码

```bash
php .trae/skills/my_project/scripts/create.php

📖 文档导航


### 📋 步骤 5：添加内容（可选）

根据需要添加：

- **代码模板** (`assets/`)：保存可复用的代码模板
- **参考文档** (`references/`)：添加详细的参考文档
- **脚本工具** (`scripts/`)：添加可执行的工具脚本

### 📋 步骤 6：测试 Skill

在 Trae IDE 中测试：

1. 确保 Skill 文件已放置在 `.trae/skills/` 目录
2. 询问相关问题，检查 AI 是否正确触发
3. 检查文档链接是否正确
4. 测试代码模板和工具脚本

---

## 1.6 制作示例

### 示例：创建一个 "商品管理" 技能

#### 1. 创建目录

```bash
cd /你的项目路径/.trae/skills
mkdir -p product_api/{assets,references,scripts}

2. 创建 SKILL.md

# 商品管理 API 技能

## 1. 技能概述

**技能名称**: product_api
**技能描述**: 商品管理模块开发技能
**触发条件**:
- 当用户询问商品相关问题时
- 当用户需要创建商品 API 时
- 当用户打开商品相关文件时

**触发关键词**:
- 商品
- Product
- 商品管理

## 2. 文档导航

| 文档 | 说明 |
|------|------|
| [商品概述](references/01-商品概述.md) | 商品模块简介 |
| [商品接口](references/02-商品接口.md) | API 接口说明 |

## 3. 核心功能

- 商品 CRUD 操作
- 商品分类管理
- 商品库存管理

## 4. 使用示例

```bash
# 生成商品 API
php .trae/skills/product_api/scripts/create.php Product


#### 3. 创建 README.md

```markdown
# 商品管理 API 技能

🎯 **快速开发商品管理模块！**

## 📖 功能

- 商品增删改查
- 商品分类管理
- 库存管理

## 🛠️ 使用

```bash
# 生成商品 API
php .trae/skills/product_api/scripts/create.php Product


#### 4. 添加参考文档

在 `references/` 目录下创建 `01-商品概述.md` 等文档。

#### 5. 添加代码模板

在 `assets/` 目录下创建 `ProductController.php` 等模板。

#### 6. 添加工具脚本

在 `scripts/` 目录下创建 `create.php` 脚本。

---

# 第二部分：Trae IDE 使用指南

## 2.1 Trae IDE 简介

**Trae IDE** 是一个基于 AI 的智能开发环境，支持 Skills 扩展，帮助开发者更高效地工作。

### ✨ 主要特点

- 🤖 **AI 集成**：内置 AI 助手，理解项目上下文
- 📦 **Skills 支持**：可安装项目专属的技能包
- 💡 **智能提示**：根据 Skills 提供相关的知识和建议
- 🔧 **开发工具**：集成多种开发辅助工具

---

## 2.2 安装 Skills

### 📥 安装方式

1. **确保 Skills 目录存在**
   ```bash
   # 在项目根目录下
   mkdir -p .trae/skills

复制 Skill 文件

# 将 Skill 目录复制到 .trae/skills/
cp -r /你的Skill路径/my_skill .trae/skills/

验证安装
- 打开 Trae IDE
- 检查 .trae/skills/ 目录下是否有 Skill 文件

2.3 使用 Skills

🎯 触发 Skill

Skills 会根据以下条件自动触发：

1. 关键词触发

当你的问题包含相关关键词时，AI 会自动使用相应的 Skill。

示例问题：

“陀螺匠项目的技术栈是什么？”
“如何创建一个新的 API 接口？”
“这个 Vue 组件如何使用？”

2. 文件操作触发

当打开或编辑特定类型的文件时，AI 会使用相关的 Skill。

示例：

打开 .php 文件 → 触发 tuoluojiang_api
打开 .vue 文件 → 触发 tuoluojiang_admin
打开 .sql 文件 → 触发 tuoluojiang_api

3. 手动询问

你可以直接询问 AI 相关的项目问题：

请问陀螺匠项目的代码规范是什么？

📚 查阅文档

在 .trae/skills/skill_name/references/ 目录下有详细的参考文档。

查看方式：

在文件管理器中打开对应目录
阅读相应的 Markdown 文档
或询问 AI 助手：“请告诉我关于 XXX 的内容”

🛠️ 使用工具脚本

Skills 包含可执行的工具脚本：

tuoluojiang_api 工具

# 生成 API 代码
php .trae/skills/tuoluojiang_api/scripts/create_api.php User user ent/user

# 检查代码规范
php .trae/skills/tuoluojiang_api/scripts/check_api.php User

tuoluojiang_admin 工具

# 创建 Vue 页面
node .trae/skills/tuoluojiang_admin/scripts/create-page.js UserList

# 创建组件
node .trae/skills/tuoluojiang_admin/scripts/create-component.js UserCard

# 代码检查
node .trae/skills/tuoluojiang_admin/scripts/lint-check.js

2.4 常用技巧

💡 技巧 1：充分利用触发关键词

在提问时使用 Skill 中定义的关键词，可以提高 AI 的响应质量。

示例：

❌ “怎么建表？”
✅ “如何在陀螺匠项目中创建数据库表？”

💡 技巧 2：结合文件操作

打开相关的文件，然后询问问题，AI 会更好地理解上下文。

示例：

打开 UserController.php
询问：“这个控制器遵循什么规范？”

💡 技巧 3：使用代码模板

在 assets/ 目录下有代码模板，可以直接参考使用。

示例：

查看 ControllerTemplate.php 了解控制器规范
复制模板内容作为起点

💡 技巧 4：善用工具脚本

不要手动创建代码，使用提供的工具脚本：

# 创建 API 模块
php .trae/skills/tuoluojiang_api/scripts/create_api.php Product product ent/product

💡 技巧 5：查阅详细文档

对于复杂问题，先查阅详细的参考文档：

.trae/skills/tuoluojiang_api/references/ - 后端 API 文档
.trae/skills/tuoluojiang_admin/references/ - 前端管理后台文档

第三部分：项目现有 Skills

3.1 tuoluojiang_api

后端 API 开发技能包

📁 目录结构

tuoluojiang_api/
├── SKILL.md              # 技能主文档
├── README.md             # 使用说明
├── assets/              # 6个代码模板
│   ├── ControllerTemplate.php
│   ├── DaoTemplate.php
│   ├── ModelTemplate.php
│   ├── RequestTemplate.php
│   ├── ResourceControllerTemplate.php
│   └── ServiceTemplate.php
├── references/          # 10个参考文档
│   ├── 01-项目概述.md
│   ├── 02-开发规范.md
│   ├── 03-数据库说明.md
│   ├── 04-API接口说明.md
│   ├── 05-目录结构.md
│   ├── 06-常用命令.md
│   ├── 07-路由说明.md
│   ├── 08-事件系统.md
│   ├── 09-定时任务.md
│   └── 10-中间件说明.md
└── scripts/             # 2个工具脚本
    ├── create_api.php   # 代码生成器
    └── check_api.php   # 规范检查工具

🎯 主要功能

📚 10 个详细的后端开发参考文档
💻 6 个可直接使用的代码模板
🚀 代码生成器（快速创建 API 模块）
✅ 代码规范检查工具

🛠️ 工具脚本

# 生成 API 代码
php .trae/skills/tuoluojiang_api/scripts/create_api.php ModuleName FunctionName ent/route

# 检查代码规范
php .trae/skills/tuoluojiang_api/scripts/check_api.php ModuleName

3.2 tuoluojiang_admin

前端管理后台开发技能包

📁 目录结构

tuoluojiang_admin/
├── SKILL.md              # 技能主文档
├── README.md             # 使用说明
├── assets/              # 4个代码模板
│   ├── ApiTemplate.js
│   ├── ComponentTemplate.vue
│   ├── PageTemplate.vue
│   └── StoreTemplate.js
├── references/          # 8个参考文档
│   ├── 01-项目概述.md
│   ├── 02-开发规范.md
│   ├── 03-目录结构.md
│   ├── 04-组件说明.md
│   ├── 05-API接口说明.md
│   ├── 06-常用功能.md
│   ├── 07-构建部署.md
│   └── 08-常见问题.md
└── scripts/             # 3个工具脚本
    ├── create-page.js      # 页面生成器
    ├── create-component.js # 组件生成器
    └── lint-check.js       # 代码检查工具

🎯 主要功能

📚 8 个详细的前端开发参考文档
💻 4 个可直接使用的代码模板
🚀 页面生成器（快速创建 Vue 页面）
🚀 组件生成器（快速创建 Vue 组件）
✅ 代码规范检查工具

🛠️ 工具脚本

# 创建 Vue 页面
node .trae/skills/tuoluojiang_admin/scripts/create-page.js UserList

# 创建 Vue 组件
node .trae/skills/tuoluojiang_admin/scripts/create-component.js UserCard

# 代码规范检查
node .trae/skills/tuoluojiang_admin/scripts/lint-check.js