一文读懂 Skills：什么是 Skills？如何使用？以及如何用 Skill 生成一个 Java 方法
一、什么是 Skills？
在 AI 与智能编程工具中，Skill（技能） 可以理解为：
对某一类任务的“能力封装”或“可复用指令单元”
它不是一次性的 Prompt，而是经过抽象、总结、可以**反复使用 **的能力描述。
用一句话解释 Skill
- Prompt：一次性提问
- Skill：可以反复调用的“能力模板”
例如：
- 生成一个 Java Getter 方法
- 根据接口文档生成 Controller 代码
- 把自然语言需求转换成 SQL
- 为已有方法补充 Javadoc 注释
这些都可以被定义为一个 Skill。
二、为什么要使用 Skills？
在实际开发中，常见问题包括：
- 每次都要重新描述需求
- AI 输出风格不统一
- Prompt 越写越复杂
- 团队成员使用方式不一致
Skill 的核心价值：标准化 + 复用 + 稳定输出。
使用 Skills 的好处
- 提高效率：一次编写，多次使用
- 降低心智负担：不用反复组织 Prompt
- 输出更稳定：有明确规则约束
- 方便团队协作：可共享、可沉淀
三、Skills 一般怎么使用？
不论在哪个平台，Skill 的基本流程都是一致的：
- 选择一个 Skill
- 填写必要参数
- 调用 Skill
- 获得结果
示例（概念层面）
Skill：生成 Java 方法 输入：方法名、参数、返回值、业务描述 输出：标准 Java 方法代码 四、如何编写一个 Skill？
一个好的 Skill，本质是把隐性经验变成显性规则。
1. Skill 的基本结构
- Skill 名称
- Skill 目标
- 输入参数
- 约束规则
- 输出格式
输出格式里面可以把你自己的代码风格放这里。 比如我喜欢在每个方法的开始加上log日志，我给的例子就会在每个方法开始加上添加日志，格式是log.xxx。用来记录入参。 2. Skill 通用模板
Skill 名称：XXX 目标： 用于完成 XXX 类型任务 输入参数： - 参数1 - 参数2 规则： - 遵循编码规范 - 不生成无关内容 输出： - 指定格式结果 - 你的例子 五、实战示例：用 Skill 生成一个 Java 方法
Skill：生成标准 Java 方法
Skill 描述
根据给定信息生成符合 Java 编码规范的业务方法。
输入参数
- 方法名（methodName）
- 返回类型（returnType）
- 参数列表（parameters）
- 业务描述（description）
- 每行加上log日志，格式是log.xxx 打印入参
约束规则
- 使用 Java 命名规范
- 包含方法注释
- 逻辑清晰、可读
示例输入
方法名：calculateTotalPrice 返回类型：BigDecimal 参数：BigDecimal unitPrice, int quantity 业务描述：根据单价和数量计算总价 输出结果
/** * 根据单价和数量计算总价 * * @param unitPrice 商品单价 * @param quantity 商品数量 * @return 总价 */publicBigDecimalcalculateTotalPrice(BigDecimal unitPrice,int quantity){ log.info("入参是 商品单价：{} 商品数量：{}",unitPrice,quantity)if(unitPrice ==null|| quantity <=0){returnBigDecimal.ZERO;}return unitPrice.multiply(BigDecimal.valueOf(quantity));}六、Skill 的进阶用法
- 拆分原子 Skill
- Skill 组合成工作流
- 固定输出格式（JSON / 代码块）
- 沉淀为团队规范
例如：
- Controller Skill
- Service Skill
- DTO Skill
- 单元测试 Skill
七、总结
Skill 不是普通 Prompt，而是一种工程化使用 AI 的方式。
它就像代码中的：
- 方法封装
- 设计模式
- 编码规范
当你用 Skill 的方式思考，AI 编码将更加稳定、高效、可控。
