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 清单 ​

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

后端开发类（8 个） ​

Skill触发词说明
crud-developmentCRUD、增删改查、Entity、Service、DAO全栈四层架构 CRUD 代码生成
api-developmentAPI、接口、RESTfulAPI 设计规范
database-ops数据库、建表、SQL数据库设计与多库操作
backend-annotationsSerialMap、限流、脱敏后端高级注解使用
error-handler异常处理、ServiceException全局异常处理机制
utils-toolkit工具类、MapstructUtils全栈工具类速查
json-serializationJSON、序列化、BigDecimalJSON 处理规范
test-development单元测试、JUnit5、Mockito测试开发规范

安全与权限类（4 个） ​

Skill触发词说明
security-guardSa-Token、权限、加密认证授权和数据安全
data-permission数据权限、部门隔离行级数据权限控制
multi-tenant多租户、TenantEntity多租户数据隔离
social-loginOAuth2、微信登录、JustAuth第三方社交登录

中间件与集成类（9 个） ​

Skill触发词说明
redis-cacheRedis、缓存、@Cacheable缓存策略和分布式锁
scheduled-jobs定时任务、SnailJob、@Scheduled定时任务开发（3 种方案）
realtime-communicationWebSocket、SSE、实时推送实时通信（双向 + 单向）
file-oss-management文件上传、OSS、MinIO文件存储管理
notification-system短信、邮件、消息推送短信 + 邮件 + 统一消息
message-queueRocketMQ、消息队列消息队列开发
iot-mqttMQTT、物联网、IoTMQTT 设备通信
third-party-api高德地图、Forest、HTTP第三方 API 集成
ai-langchain4jAI、大模型、ChatGPTLangChain4j AI 集成

前端开发类（2 个） ​

Skill触发词说明
ui-pcAForm、AModal、Element PlusPC 端 71 个自定义组件
store-pcPinia、useUserStorePC 端状态管理

移动端开发类（4 个） ​

Skill触发词说明
ui-mobilewd- 组件、WD UI移动端 99+ 组件
ui-design-mobile页面布局、间距、大气移动端设计思维
store-mobileuseAuth、Composable移动端状态管理
uniapp-platform条件编译、ifdef多端条件编译

APP原生类（1 个） ​

Skill触发词说明
app-adapterplus-app、APP端、原生插件、HBuilderXplus-app 原生 APP 适配指南

微信与支付类（2 个） ​

Skill触发词说明
payment-integration微信支付、支付宝、退款多渠道支付集成
wechat-integration小程序登录、订阅消息微信生态集成

质量与排查类（5 个） ​

Skill触发词说明
bug-detectiveBug、报错、异常排查Bug 排查方法论
performance-doctor性能、慢查询、优化性能诊断和优化
code-patterns代码规范、命名全栈编码规范速查
media-processing图片处理、二维码、Excel媒体处理工具
icon-management图标、菜单图标、IconSelectPC 端与移动端图标管理

规划与协作类（12 个） ​

Skill触发词说明
architecture-design架构、模块划分、重构系统架构规划
tech-decision技术选型、方案对比技术决策分析
brainstorm头脑风暴、方案设计创意方案探索
i18n-development国际化、多语言、i18n全栈国际化方案
project-navigator项目结构、文件在哪项目导航和定位
git-workflowGit、提交、分支Git 工作流规范
task-tracker任务跟踪、记录进度开发任务持久化跟踪
add-skill添加技能、创建技能扩展技能系统
project-migration迁移项目、架构迁移、框架迁移项目迁移与重构方法论
collaborating-with-codexCodex、算法分析委托 Codex 处理任务
collaborating-with-geminiGemini、UI 设计委托 Gemini 处理任务
banana-image生成图片、海报、4KAI 图片生成

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，按需逐步积累，定期更新保持与项目同步。