5.4 创建自定义 Skill:api-crud-generator 重点

本节目标:手把手创建你的第一个自定义 Skill,理解 Skill 的完整结构

演示的 Claude Code 功能:自定义 Skill、Skill 的四层目录结构

5.4.1 为什么要创建 Skill

在电商项目中,你会反复做同样的事情:

商品需要 CRUD → 写 Prisma 查询 + API Route + 管理页面
分类需要 CRUD → 写 Prisma 查询 + API Route + 管理页面
订单需要 CRUD → 写 Prisma 查询 + API Route + 管理页面

每次都是相似的代码结构,只是换了个模型名。如果每次都让 AI 从零写,不仅慢,而且每次的代码风格可能不一致。

Skill 就是解决这个问题的——把重复的模式封装成可复用的”标准操作流程”。

5.4.2 Skill 的目录结构

一个完整的 Skill 是一个目录,推荐放在 .claude/skills/ 下:

.claude/skills/api-crud-generator/
├── SKILL.md           ← 核心:技能描述文件(必选)
├── scripts/           ← 辅助脚本(可选)
├── resources/         ← 模板和配置(可选)
└── references/         ← 参考文档(可选)

对于我们这个项目,只需要 SKILL.md 就够了。

5.4.3 编写 SKILL.md

创建 .claude/skills/api-crud-generator/SKILL.md:

---
name: api-crud-generator
version: 1.0
description: 根据 Prisma 模型生成标准的 Next.js API Route + 前端管理页面
trigger: ["生成CRUD", "生成接口", "生成管理页面"]
---

# API CRUD 生成器

## 功能说明
根据指定的 Prisma 模型,自动生成标准的管理后台 CRUD 代码:
1. API Routes(5 个):GET 列表、GET 详情、POST 创建、PUT 更新、DELETE 删除
2. 前端页面:数据列表页、创建/编辑表单

## 执行步骤

### 第 1 步:确认模型信息
询问用户:
- 要生成的模型名称(如 Product、Category)
- API 路径(如 /api/admin/products)
- 页面路由(如 /admin/products)

### 第 2 步:生成 API Route Handlers
按照标准模板生成以下文件:
1. `route.ts` — GET 列表 + POST 创建
2. `[id]/route.ts` — GET 详情 + PUT 更新 + DELETE 删除

### 第 3 步:生成前端管理页面
生成一个包含以下功能的管理页面:
- 数据表格(列出所有字段)
- "新增"按钮 + 表单
- 每行的"编辑"和"删除"按钮
- TailwindCSS 样式

### 第 4 步:确认并验证
- 列出所有生成的文件
- 提醒用户执行 npx prisma generate(如果模型有变更)
- 给出测试方法

## 注意事项
- 所有 UI 文案使用中文
- 使用 Next.js App Router 的 params 语法
- 创建和更新前做输入验证
- 密码字段永远不通过 API 返回

5.4.4 SKILL.md 的结构解析

每个 Skill 文件包含两部分:

1. Frontmatter(文件头部的 YAML 元数据)

---
name: 技能唯一名称
description: 一句话描述
trigger: 触发关键词列表
---
  • name:技能的唯一标识
  • description:帮助 AI 判断什么时候该用这个技能
  • trigger:当用户消息包含这些关键词时,AI 知道要加载这个 Skill

2. 正文(Markdown 格式的指令)

这是 AI 执行任务时会阅读的”操作手册”。写得好坏直接决定 AI 的输出质量。

提示:写 Skill 时想象你在给一个聪明的实习生写工作说明书——告诉他做什么、用什么工具、注意什么坑。

5.4.5 在开发中使用 Skill

创建好 Skill 后,在 Claude Code 对话中,你只需要这样说:

请用 api-crud-generator Skill 为 Category 模型生成管理后台代码。
API 路径放在 /api/admin/categories,页面放在 /admin/categories。

AI 会:

  1. 自动加载 SKILL.md 中的指令
  2. 按照步骤 1-4 的标准流程执行
  3. 生成符合项目规范的代码

这就是 Skill 的威力——一次编写,反复使用,标准统一。

5.4.6 你学到了什么

概念说明
Skill 的定义封装了特定能力的可复用指令集
FrontmatterSkill 的元数据,AI 用来判断何时加载
SKILL.mdSkill 的核心载体
触发关键词用户说什么话会激活这个 Skill
@ 引用安装官方 Skill 的方式,如 anthropics/skills@frontend-design
© 版权声明
THE END
喜欢就支持一下吧
点赞7 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容