跳转到主要内容
Skills 是 Qoder 中将专业知识打包成可复用功能的机制。每个 Skill 包含一个 SKILL.md 文件，定义技能的描述、指令和可选的辅助文件。无论是在 Qoder IDE 还是 CLI 中，Skills 的使用方式完全一致。 核心特点：
  • 智能调用：模型根据用户请求和 Skill 描述自主决定何时使用
  • 模块化设计：每个 Skill 专注解决特定类型的任务
  • 灵活扩展：支持用户级和项目级的自定义 Skill

​
创建技能(Skills)

你可以通过以下三种方式创建或获取自定义 Skills:

​
1. 通过内置技能自动创建

create-skill 是 Qoder 内置的技能创建助手。它通过交互式对话,引导你逐步创建符合规范的 SKILL.md 文件。 使用方式: 
/create-skill <技能描述,例如:将 Word 文档转换为 PDF>
如果你不熟悉 SKILL.md 文件的编写规范,建议优先使用 /create-skill 来生成初始模板,然后根据实际需求进行调整优化。
适用场景: 快速创建自定义技能,无需了解技能文件的详细格式。

​
2. 通过 Skills CLI 安装

使用 skills CLI 可以一键安装来自 skills.sh 市场或 GitHub 的第三方 Skills。 在 Qoder IDE 的终端内执行以下命令: 
# 从 skills.sh 市场安装
npx skills add vercel-labs/agent-browser -a qoder

# 从 GitHub 仓库安装指定技能
npx skills add https://github.com/anthropics/skills --skill skill-creator -a qoder
更多用法详见 skills CLI 文档。
适用场景: 安装社区共享的成熟技能,快速获得开箱即用的功能。

​
3. 手动创建

如果你希望完全自定义技能,可以手动创建 SKILL.md 文件并放置到指定目录。 步骤:
  1. 创建技能目录和 SKILL.md 文件
  2. 将文件放置到以下路径之一:
位置路径作用域
用户级~/.qoder/skills/{skill-name}/SKILL.md当前用户的所有项目
项目级.qoder/skills/{skill-name}/SKILL.md仅当前项目
  1. 重启 Qoder IDE,在对话框内输入 / 即可查看已加载的 Skills 列表
提示: 当用户级和项目级存在同名 Skill 时,项目级 Skill 优先级更高。
适用场景: 需要完全自定义技能内容,或将现有技能文件直接导入。

​
如何使用

可以有以下两种触发方式：
  1. 自动触发：直接描述需求，模型会自动判断是否使用合适的 Skill：
分析这个日志文件中的错误
模型将自动识别并调用 log-analyzer Skill。
  1. 手动触发：输入 /skill-name 手动触发：
/log-analyzer

​
使用场景

适合使用 Skill 的场景：
  • 复杂专业任务：需要领域知识的工作流（代码审查、PDF 处理、API 设计）
  • 标准化流程：按固定步骤执行的任务（提交规范、部署流程）
  • 团队知识共享：打包最佳实践供团队使用
  • 重复性工作：频繁执行且需要专业指导的任务

​
场景示例

​
日志分析

创建一个 log-analyzer Skill，当你说”分析这个日志”时自动激活，帮助识别错误、性能问题和异常模式。

​
API 文档生成

创建一个 api-doc-generator Skill，自动识别 API 端点并生成标准文档和 OpenAPI 规范。

​
代码审查

创建一个 code-reviewer Skill，按照团队规范自动审查代码，检查潜在问题和最佳实践。

​
详细文档

关于 Skills 的完整指南，包括如何创建、编写 SKILL.md、最佳实践和故障排查，请参阅 Skills 完整文档。