技能(Skills)是将专业知识打包成可复用功能的机制。每个 Skill 包含一个 SKILL.md 文件,定义技能的描述、指令和可选的辅助文件。
核心特点
智能调用:模型根据用户请求和 Skill 描述自主决定何时使用
模块化设计:每个 Skill 专注解决特定类型的任务
灵活扩展:支持用户级和项目级的自定义 Skill
创建技能(Skills)
提供了不同的创建技能(Skills)的方式:
同名时,项目级 Skill 覆盖用户级 Skill。
方式1:手动创建
手动将目标 Skill 文件拷贝到下述路径后,重启 IDE,即可在对话框内通过 / 查看已加载的 Skills 列表。
位置 | 路径 | 作用域 |
用户级 |
| 当前用户的所有项目 |
项目级 |
| 仅当前项目 |
方式2:通过内置技能自动创建
create-skill 是 Qoder 内置的技能创建助手。它通过交互式对话,引导你逐步创建符合规范的 SKILL.md 文件。使用方式:
/create-skill <技能描述,例如:将 Word 文档转换为 PDF>如果你不熟悉 SKILL.md 文件的编写规范,建议优先使用 /create-skill 来生成初始模板,然后根据实际需求进行调整优化。
适用场景: 快速创建自定义技能,无需了解技能文件的详细格式。
如何使用
自动触发:直接描述需求,模型会自动判断是否使用合适的 Skill:
分析这个日志文件中的错误模型将自动识别并调用 log-analyzer Skill。
手动触发:输入
/skill-name手动触发:
/log-analyzer使用场景
适合使用 Skill 的场景
复杂专业任务:需要领域知识的工作流(代码审查、PDF 处理、API 设计)
标准化流程:按固定步骤执行的任务(提交规范、部署流程)
团队知识共享:打包最佳实践供团队使用
重复性工作:频繁执行且需要专业指导的任务
场景示例
日志分析
创建一个 log-analyzer Skill,当你说”分析这个日志”时自动激活,帮助识别错误、性能问题和异常模式。
API 文档生成
创建一个 api-doc-generator Skill,自动识别 API 端点并生成标准文档和 OpenAPI 规范。
代码审查
创建一个 code-reviewer Skill,按照团队规范自动审查代码,检查潜在问题和最佳实践。