一文读懂 Skills：什么是 Skills？如何使用？以及如何用 Skill 生成一个 Java 方法

一、什么是 Skills？

在 AI 与智能编程工具中，Skill（技能） 可以理解为：

对某一类任务的“能力封装”或“可复用指令单元”

它不是一次性的 Prompt，而是经过抽象、总结、可以**反复使用 **的能力描述。

用一句话解释 Skill

• Prompt：一次性提问
• Skill：可以反复调用的“能力模板”

例如：

• 生成一个 Java Getter 方法
• 根据接口文档生成 Controller 代码
• 把自然语言需求转换成 SQL
• 为已有方法补充 Javadoc 注释

这些都可以被定义为一个 Skill。

二、为什么要使用 Skills？

在实际开发中，常见问题包括：

• 每次都要重新描述需求
• AI 输出风格不统一
• Prompt 越写越复杂
• 团队成员使用方式不一致

Skill 的核心价值：标准化 + 复用 + 稳定输出。

使用 Skills 的好处

1. 提高效率：一次编写，多次使用
2. 降低心智负担：不用反复组织 Prompt
3. 输出更稳定：有明确规则约束
4. 方便团队协作：可共享、可沉淀

三、Skills 一般怎么使用？

不论在哪个平台，Skill 的基本流程都是一致的：

1. 选择一个 Skill
2. 填写必要参数
3. 调用 Skill
4. 获得结果

示例（概念层面）

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 编码将更加稳定、高效、可控。