【Vibe Coding】Qoder Agent 三大扩展功能解析和实操：Commands、Skills、Subagents

Qoder Agent 三大扩展功能解析和实操：Commands、Skills、Subagents

开篇

在日常使用 Qoder Agent 的过程中，以下三个场景你一定不陌生：

场景一：重复输入同样的提示词。 每次让 Agent 审查代码、生成测试，你都要重新组织一大段指令。上周写过的好用提示词？早忘了。

场景二：Agent 做了大量无用功。 你只是想问一个 Java 语法问题，Agent 却先扫描了整个项目文件，又去搜了一圈网页，秒过去了，Token 也浪费了。

场景三：复杂任务只能串行推进。 你想同时搞定前端 UI 和后端 API，但 Agent 一次只能专注一件事，上下文越来越长，效率越来越低。

这三个问题，分别对应 Qoder Agent 的三大自定义扩展功能：

三者的复杂度递进关系：Commands（5 分钟上手） → Skills（团队知识资产） → Subagents（并行执行力）。

接下来，我们从最轻量的 Commands 讲起，逐步深入。

Qoder IDE 的 Agent 功能体系概览

┌──────────────────────────────────────────────────────┐
│              Qoder Agent 体系                        │
├──────────────────────────────────────────────────────┤
│                                                      │
│  ┌─────────────────────────────────────────────────┐ │
│  │        内置 Agent（开箱即用）                   │ │
│  │  · Plan Agent（规划智能体）                     │ │
│  │  · Browser Agent（浏览器智能体）                │ │
│  │  · Code Review Agent（代码审查智能体）          │ │
│  └─────────────────────────────────────────────────┘ │
│                                                      │
│  ┌─────────────────────────────────────────────────┐ │
│  │        自定义扩展（按需配置）                   │ │
│  │  · Commands  → 快捷入口，封装提示词             │ │
│  │  · Skills    → 知识资产，注入专业能力           │ │
│  │  · Subagents → 并行执行力，独立上下文           │ │
│  └─────────────────────────────────────────────────┘ │
│                                                      │
└──────────────────────────────────────────────────────┘

三大扩展功能的定位对比

Commands 详解

核心概念

Commands 是将常用提示词封装为可复用命令的机制。在 Agent 对话框输入 / 即可快速调用，将重复性操作简化为"一键式"任务。

Commands 与 Skills 是独立的两套机制：

• Commands 存储在 .qoder/r/c/commands/ 目录，本质是一段提示词文本
• Skills 存储在 .qoder/r/s/skills/，是包含更完整工作流的知识模块

工作机制：重点理解「工具屏蔽」

Commands 最有价值的能力，不是"帮你少打几个字"，而是精确控制 Agent 的工具调用行为。

Agent 在执行命令时，会根据提示词内容判断是否激活以下工具：

• search_file（文件搜索）
• search_web（网页搜索）
• memory（记忆检索）

你可以在命令中用 Don't search project's files! Don't search web! Don't search memory! 等指令主动屏蔽不需要的工具，让 Agent 跳过文件扫描、网页搜索等步骤，直接调用大语言模型输出答案。

两大类用法

第一类：代码操作类命令 —— 适合快速、重复、单一目标的任务

对比实验： 直接问 “Java 有哪些新特性？”，Agent 会扫描项目文件、执行网页搜索，浪费时间和 Token。使用 /j/java 命令后，Agent 跳过所有工具调用，直接从 LLM 知识输出答案，快且准。

示例命令：

第二类：知识查询类命令 —— 通过屏蔽工具让 Agent 直接调用 LLM 知识回答，省时省 Token

特性对比

配置示例

创建入口（两种方式）：

方式 1：使用 /c/create-agent（推荐） Qoder 内置 create-agent 技能，通过交互式引导快速创建。

引导完成：定义名称和描述 → 选择工具权限 → 自动生成系统提示词模板 → 保存到正确位置。

方式 2：手动创建文件

格式示例：

## 概述
用于评估源代码的系统化框架，以验证技术卓越性、稳健性和安全合规性。

## 评估领域
### 技术实现
- [ ] 需求准确实现
- [ ] 算法效率验证
- [ ] 资源管理优化

### 风险管理
- [ ] 遵循安全最佳实践
- [ ] 数据验证全面
- [ ] 身份验证方法安全

示例 1：代码操作类（/c/code-inspect）

Don't search project's files! Don't search web! Don't search memory!
请根据你了解的 Java(8-25) 相关知识回答用户问题。

示例 2：屏蔽全部工具（/j/java）

Don't search project's files! Don't search web! Don't search memory!
请根据你了解的 Java(8-25) 相关知识回答用户问题。

配置方式

可通过「技能、智能体、指令」可视化管理界面操作（升级到 v2.0 版）：

• 在对话框输入 /，点击底部的"添加指令"快捷入口

Skills 详解

核心概念

Skills 是包含工作流的知识模块，用于注入领域专业能力。

配置方式

方式 1：使用 /c/create-skill（推荐） Qoder 内置 create-skill 技能，通过交互式引导快速创建。

方式 2：手动创建文件

格式示例：

---
name: code-review
description: 代码审查专家，检查代码质量和安全性
tools: Read, Grep, Glob, Bash
---

你是一位资深代码审查员，负责确保代码质量。

## 审查清单：
1. 代码可读性
2. 命名规范
3. 错误处理
4. 安全性检查
5. 测试覆盖

Frontmatter 字段说明：

支持的工具列表：

触发方式

自动触发（推荐）： 自然语言描述任务，模型根据 description 自动识别并调用

手动触发： 输入 /a/agent-name 显式调用

串联调用： 在一条指令中顺序调度多个智能体

示例：

• 帮我审查这个接口的实现 → 自动识别并调用 code-review 智能体
• /code-review
• 先使用 design subagent 完成系统设计，再使用 code-review subagent 完成代码 review

位置与作用域

Subagents 详解

配置示例

全栈开发： 前端子代理 + 后端子代理并行开发

代码审查： 安全审计子代理 + 性能审查子代理

数据处理： 数据清洗子代理 + 模型训练子代理

CI/CD： 构建子代理 + 测试子代理 + 部署子代理

/create-agent <您的诉求，例如代码审查专家>

v2.0 后，也可在「技能、智能体、指令」可视化管理界面中直接新建或者导入。

除三大自定义扩展外，Qoder 还内置了三个专用 Agent，开箱即用：

Plan Agent（规划智能体）

在修改代码前，先生成一份结构化的实施方案（目标、技术方案、技术栈、分步计划），用户审阅并调整后再执行。

• 触发： /p/plan 或 Agent 自动判断（中大型任务时）
• 适用： 跨多文件功能开发、重构、高风险变更
• 特点： 执行前不修改任何文件，待办事项状态实时可见

Browser Agent（浏览器智能体）

在 Agent 模式中直接操作浏览器，完成需要访问网页的自动化任务。

• 触发： /b/browser 或 Agent 自动调用
• 能力： 打开网页、点击、填表、截图、提取信息、跨页面导航
• 适用： 查阅在线文档、产品信息对比、Web 应用测试

Code Review Agent（代码审查智能体，v2.0 新增）

内置的代码审查智能体，可在会话内直接触发代码评审。

• 触发： /c/code-review
• 能力： 对指定范围的代码执行结构化审查，输出质量、安全、性能等维度的评审意见
• 适用： 提交前代码审查、针对特定模块的质量把关、团队代码评审

三者协同与选择指南

分层协作管道

在实际工作流中，三者形成分层协作管道：

用户请求
  │
  ▼
Commands（触发入口）──── 将常用操作提示词封装为一键调用
  │
  ▼
Skills（注入知识）────── 自动加载领域专业知识和工作流
  │
  ▼
Subagents（并行执行）── 拆分为独立子代理并行处理
  │
  ▼
主 Agent 汇总输出

决策指南：什么场景用什么

七维对比

最佳实践汇总

通用原则

• 先规划再编码： 中大型任务优先使用 /p/plan，明确范围和验收标准
• 审查每次变更： 使用 diff 视图检查 Agent 修改，保持人工决策权

Commands 专项实践

• 保持单一职责： 一个命令只做一件事，避免过于复杂的链式逻辑
• 命名用名词： 斜杠指令名称像"课代表"，用名词指代角色或领域（如 /java、/translator），使调用体验接近"向某人提问"
• 屏蔽无关工具，提速省 Token： 知识查询类命令首行用 Don't search project's files! Don't search web! Don't search memory!
• 声明编程语言： 在命令内声明目标语言（如 Programming language: Bash），确保输出格式正确
• 边界和环境声明： 提供当前操作系统、已安装工具、目标数据库类型等上下文，让生成内容更准确

Skills 专项实践

• 模块化设计： 每个 Skill 专注解决一类问题，避免大而全
• 优先将通用知识放用户级（全局），业务规则放项目级
• 使用 /c/create-skill 快速生成初始模板，再手动优化
• 定期更新 Skill 描述，确保模型能准确判断相关性
• SKILL.md 控制在 100 行以内，详细参考拆到子目录
• 一个 Skill 只解决一类问题，不做"瑞士军刀"

Subagents 专项实践

• 避免上下文污染： 每个子代理只处理独立的任务域
• 设置退出检测器，防止子代理陷入无限循环
• 从简单两个子代理开始，验证协调机制后再扩展

核心概念速查

工具屏蔽速查

概念对比

–