ruoyi-plus-uniapp

主题

Claude Code Skills 开发指南 ​

什么是 Skills？ ​

Skills 是 Claude Code 的预置知识模块，通过触发词按需激活。相比每次对话都要加载的 CLAUDE.md，Skills 只在需要时才加载，实现了知识分片、按需调用。

核心优势 ​

传统方式Skills 方式
每次对话都要解释项目规范规范写一次，永久生效
Token 消耗在"解释"上Token 用在"干活"上
AI 生成的代码需要大量修改一次生成，直接可用
上下文满了就"失忆"知识持久化，不会忘

Token 消耗对比 ​

开发任务无 Skills有 Skills节省
开发一个 CRUD 模块~15,000 tokens~3,500 tokens77%
集成微信支付~12,000 tokens~3,000 tokens75%
排查数据库问题~8,000 tokens~2,000 tokens75%

目录结构 ​

项目根目录/
├── CLAUDE.md                    # 入口文件（每次加载）
└── .claude/
    └── skills/
        ├── crud-development/
        │   └── SKILL.md         # CRUD 开发规范
        ├── payment-integration/
        │   └── SKILL.md         # 支付集成指南
        ├── database-ops/
        │   └── SKILL.md         # 数据库操作
        └── ...

项目已有 Skills 清单 ​

本项目包含 23 个 Skills，按功能分为 5 大类：

核心开发（5个） ​

Skill触发词说明
crud-developmentCRUD、增删改查、Entity、Service全栈 CRUD 代码生成
database-ops数据库、建表、SQL数据库设计与操作
api-developmentAPI、接口、RESTfulAPI 设计规范
backend-annotations注解、权限、限流后端高级注解使用
project-navigator项目结构、文件在哪快速定位代码位置

前端与移动端（4个） ​

Skill触发词说明
component-library组件、Element Plus、WD UIUI 组件使用指南
state-managementStore、Pinia、状态管理状态管理最佳实践
uniapp-platform条件编译、跨平台、小程序UniApp 多端开发
code-patterns编码规范、命名、代码风格代码规范指南

业务集成（5个） ​

Skill触发词说明
payment-integration支付、微信支付、退款支付渠道对接
wechat-integration微信、小程序登录、分享微信生态集成
file-oss-management文件上传、OSS、云存储文件存储方案
ai-langchain4jAI、大模型、ChatGPTAI 能力集成
media-processing图片处理、二维码、Excel媒体文件处理

工程支持（9个） ​

Skill触发词说明
utils-toolkit工具类、StringUtils项目工具类速查
git-workflowGit、提交、分支Git 工作流规范
bug-detectiveBug、报错、异常问题排查指南
error-handler异常处理、日志异常处理规范
performance-doctor性能、优化、慢查询性能优化方案
security-guard安全、加密、XSS安全最佳实践
architecture-design架构、设计、模块架构设计指导
tech-decision技术选型、方案对比技术决策辅助
brainstorm头脑风暴、创意创意思考引导

Skill 编写规范 ​

YAML 头部格式 ​

每个 Skill 必须包含 YAML 头部：

yaml
---
name: crud-development
description: |
  当需要开发 CRUD 功能时自动使用此 Skill。

  触发场景：
  - 创建新的业务模块
  - 编写 Entity、Service、DAO
  - 前端 API 定义

  触发词：CRUD、增删改查、Entity、Service、DAO、Controller
---

# CRUD 全栈开发规范

（正文内容...）

编写技巧 ​

技巧 1：代码模板优于文字说明 ​

markdown
❌ 不好的写法：
Service 层不要继承基类，要直接实现接口。

✅ 好的写法：
## Service 实现类

```java
@Service
@RequiredArgsConstructor
public class XxxServiceImpl implements IXxxService {

    private final IXxxDao xxxDao;  // 只注入 DAO

    @Override
    public XxxVo get(Long id) {
        Xxx entity = xxxDao.getById(id);
        return MapstructUtils.convert(entity, XxxVo.class);
    }
}

#### 技巧 2：对比展示错误和正确做法

```markdown
### 常见错误

```java
// ❌ 错误：Service 继承了基类
public class XxxServiceImpl extends ServiceImpl<XxxMapper, Xxx> {

// ❌ 错误：直接注入 Mapper
private final XxxMapper xxxMapper;

正确做法 ​

java
// ✅ 正确：不继承任何基类
public class XxxServiceImpl implements IXxxService {

// ✅ 正确：注入 DAO
private final IXxxDao xxxDao;

#### 技巧 3：包含完整可运行的示例

不要只给代码片段，要给完整的、可以直接复制使用的代码。

#### 技巧 4：设置清晰的触发词

触发词要覆盖用户可能的表达方式：

```yaml
触发词：支付、付款、微信支付、支付宝、银联、余额支付、退款、回调、notify、PayService

快速开始 ​

第一步：创建目录结构 ​

bash
mkdir -p .claude/skills

第二步：从最常用的场景开始 ​

建议先创建这 3 个 Skills：

  1. 项目规范 Skill：你的代码风格、架构约定
  2. CRUD Skill：最常写的业务代码模板
  3. 工具类 Skill：项目中有哪些工具可以用

第三步：在 CLAUDE.md 中添加索引 ​

markdown
## Skills 索引

| Skill | 触发词 | 说明 |
|-------|--------|------|
| crud-development | CRUD、增删改查 | 业务模块开发 |
| database-ops | 数据库、建表 | 数据库操作 |
| ...

第四步：持续迭代 ​

  • 遇到 AI 不懂的场景 → 写个 Skill
  • 发现代码生成不对 → 补充示例
  • 团队有新规范 → 更新 Skill

实战效果对比 ​

场景：开发一个"优惠券管理"模块 ​

无 Skills 的对话：

我：帮我开发优惠券管理模块

AI：好的，我需要了解一些信息：
    1. 你使用什么后端框架？
    2. Service 层是否继承基类？
    3. 数据库表结构是怎样的？

我：Spring Boot，不继承基类，表名 b_coupon

AI：好的，我来生成代码...
    [生成了继承 ServiceImpl 的代码]

我：不对，我说了不继承基类

[30 分钟后，代码终于对了]

有 Skills 的对话：

我：帮我开发优惠券管理模块的 CRUD

AI：[自动激活 crud-development Skill]

    好的，我会按照项目规范生成优惠券管理模块。

    1. Entity: Coupon.java（继承 BaseEntity）
    2. BO: CouponBo.java（使用 @AutoMappers）
    3. VO: CouponVo.java
    4. Service: ICouponService.java / CouponServiceImpl.java（不继承基类）
    5. DAO: ICouponDao.java / CouponDaoImpl.java（含 buildQueryWrapper）
    6. Controller: CouponController.java
    7. 前端 API: couponApi.ts / couponTypes.ts

    [直接生成 7 个完整文件，代码风格 100% 符合项目规范]

[3 分钟完成，代码直接可用]

效率提升数据 ​

指标无 Skills有 Skills提升
开发时间30 分钟3 分钟10x
Token 消耗15,0003,50077%↓
代码修改次数5+ 次0-1 次显著减少

最佳实践 ​

知识分层策略 ​

CLAUDE.md（248行）      ← 每次必加载：核心禁令、架构要点
    ↓
Skills（10,000+行）     ← 按需加载：详细规范、代码模板
    ↓
Docs（3,800+行）        ← 深度参考：完整指南、复杂场景

Skill 设计原则 ​

  1. 单一职责：每个 Skill 解决一类问题
  2. 自包含：Skill 内容应该完整，不依赖其他 Skill
  3. 实用优先：代码模板 > 文字说明
  4. 持续迭代：根据 AI 表现不断优化

团队协作 ​

  • 将 .claude/ 目录加入版本控制
  • 团队成员共享同一套 Skills
  • 统一代码风格，减少 Review 成本

视频教程 ​

想看实操演示？点击下方视频：

Claude Code Skills 实战教程

总结 ​

Skills 解决的核心问题：让 AI 从"通用助手"变成"专属专家"。

维度收益
效率Token 消耗降低 75%+，开发速度提升 10 倍
质量生成的代码直接符合项目规范，减少返工
一致性团队成员用同一套 Skills，代码风格统一
积累知识写一次，受益终身，还能共享给团队

记住：不要追求一次写完所有 Skills，按需逐步积累，定期更新保持与项目同步。