跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
使用场景

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

​
内置 Skills

在 IDE 会话或 Quest 中输入 / 可调用内置功能（示例）：
名称用途
/create-skill引导创建新的 Skill
/create-skill-ui为 Skill 生成交互式 HTML Widget
/vercel-deploy一键 Vercel 部署（OAuth 与构建）
/create-subagent脚手架自定义子智能体
/canvas在 Canvas 预览中创建或编辑 .canvas.tsx 视觉产物

​
Skill UI

Skill UI 支持 Agent 在执行过程中直接渲染可交互的 HTML 组件，例如表单、图表、配置面板等。生成的组件内嵌在对话流中，你可以直接在会话内完成交互操作，无需跳转到外部页面。首次使用时需要让 Agent 为对应 Skill 创建界面。 在 Quest 的 Agent 模式中使用 /create-skill-ui 命令。Agent 会为指定 Skill 创建 HTML Widget 界面，你可以通过实时预览迭代设计后保存为模板文件。

​
Vercel Deploy

/vercel-deploy 是 Quest 下的一键部署能力。通过自动化工作流，将你的 Web 项目部署到 Vercel，覆盖 CLI 安装、OAuth 授权、项目构建到正式上线的完整流程。 在 Quest 的对话中使用 /vercel-deploy 命令，Qoder 将自动启动部署工作流。首次部署时，Qoder 会引导你完成 Vercel OAuth 登录授权。按照提示在浏览器中完成账号关联即可。授权完成后，Qoder 将自动执行项目构建并部署到 Vercel 生产环境。部署成功后，你会获得一个可访问的线上链接。
  • 需要 Vercel 账号：部署前需确保你已注册 Vercel 账号。若尚未注册，可在授权流程中完成创建。
  • 项目需为可构建的 Web 应用：Vercel 支持 Next.js、React、Vue、Svelte 等主流框架。如果项目缺少有效的构建配置，部署可能会失败。建议在部署前确认项目可在本地正常构建。

​
Canvas

Canvas 能够将文本、数据或分析结果渲染为带布局的面板，支持统计卡片、表格和图表等多种展示形式。产物为标准 .canvas.tsx 文件，Agent 会在 Canvas 预览面板中实时渲染。如果需要调整展示内容或样式，你可以在对话中继续向 Agent 发出指令，由 Agent 自动更新源码并重新渲染。 只需在对话中使用 /canvas 命令，Agent 即可生成或修改对应的 .canvas.tsx 文件，并在 Canvas 预览中实时渲染。

​
适用场景

  • 数据看板： 让 Agent 分析日志或指标数据后，直接在 Canvas 中生成带统计值和趋势图的数据看板，一目了然。
  • 结构化报告： 将复杂分析结果（如性能剖析、依赖分析）以分块面板呈现，代替冗长的文本输出。
  • 架构与流程可视化： 在梳理系统逻辑或编写文档时，将状态流转、模块依赖或抽象架构渲染为结构图，方便团队沟通对齐。

​
如何使用

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

​
创建技能(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 优先级更高。
适用场景: 需要完全自定义技能内容,或将现有技能文件直接导入。

​
场景示例

​
日志分析

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

​
API 文档生成

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

​
代码审查

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

​
详细文档

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