一、什么是 Skills?
在 AI 辅助编程的语境下,Skill(技能) 可以被理解为对某一类任务的'能力封装'或'可复用指令单元'。它不同于一次性的 Prompt,而是经过抽象和总结、能够反复调用的能力描述。
一句话解释 Skill
- Prompt:针对单次提问的临时指令
- Skill:可复用的'能力模板'
比如以下场景都可以被定义为 Skill:
- 生成一个标准的 Java Getter 方法
- 根据接口文档自动生成 Controller 代码
- 将自然语言需求转换为 SQL 查询
- 为已有方法补充 Javadoc 注释
二、为什么要使用 Skills?
实际开发中,我们常遇到这些问题:每次都要重新描述需求、AI 输出风格不统一、Prompt 越来越复杂、团队成员使用方式不一致。
Skill 的核心价值在于:标准化、复用性与稳定输出。
使用 Skills 的好处
- 提高效率:一次编写,多次调用
- 降低心智负担:无需反复组织复杂的 Prompt
- 输出更稳定:有明确的规则约束,减少幻觉
- 方便团队协作:技能可共享、可沉淀为团队规范
三、Skills 一般怎么使用?
不论在哪个平台,Skill 的基本交互流程通常是一致的:
- 选择一个已定义的 Skill
- 填写必要的输入参数
- 触发调用
- 获取结果
概念示例
Skill:生成 Java 方法
输入:方法名、参数、返回值、业务描述
输出:标准 Java 方法代码
四、如何编写一个 Skill?
一个好的 Skill,本质是将隐性经验转化为显性规则。
1. Skill 的基本结构
一个完整的 Skill 通常包含以下要素:
- 名称:清晰标识功能
- 目标:明确要完成的任务类型
- 输入参数:定义必要的数据项
- 约束规则:编码规范、逻辑限制等
- 输出格式:期望的代码或文本样式
在输出格式部分,你可以植入团队的代码风格偏好。例如,如果你要求每个方法开头必须添加日志记录入参,格式为
log.xxx,那么就在规则里明确这一点,AI 就会自动遵循。
2. Skill 通用模板
Skill 名称:XXX
目标:用于完成 XXX 类型任务
输入参数:
- 参数 1
- 参数 2
规则:
- 遵循编码规范
- 不生成无关内容
输出:
- 指定格式结果
- 参考示例


