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

发布时间:2026/5/27 12:58:58

【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命令将常用提示词封装为一键可调用的快捷入口Agent 做无用搜索Commands Skills精确控制工具调用注入领域专业知识复杂任务无法并行Subagents子代理拆分任务为独立子代理并行执行三者的复杂度递进关系Commands5 分钟上手→Skills团队知识资产→Subagents并行执行力。接下来我们从最轻量的 Commands 讲起逐步深入。Qoder IDE 的 Agent 功能体系概览┌──────────────────────────────────────────────────────┐ │ Qoder Agent 体系 │ ├──────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 内置 Agent开箱即用 │ │ │ │ · Plan Agent规划智能体 │ │ │ │ · Browser Agent浏览器智能体 │ │ │ │ · Code Review Agent代码审查智能体 │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 自定义扩展按需配置 │ │ │ │ · Commands → 快捷入口封装提示词 │ │ │ │ · Skills → 知识资产注入专业能力 │ │ │ │ · Subagents → 并行执行力独立上下文 │ │ │ └─────────────────────────────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────┘三大扩展功能的定位对比维度CommandsSkillsSubagents本质一段可复用的提示词包含工作流的知识模块独立上下文的子代理实例触发方式/命令名用户主动调用Agent 自动识别 /技能名主 Agent 自动派发复杂度低中高Commands 详解核心概念Commands 是将常用提示词封装为可复用命令的机制。在 Agent 对话框输入/即可快速调用将重复性操作简化为一键式任务。Commands 与 Skills 是独立的两套机制Commands存储在.qoder/r/c/commands/目录本质是一段提示词文本Skills存储在.qoder/r/s/skills/是包含更完整工作流的知识模块工作机制重点理解「工具屏蔽」Commands 最有价值的能力不是帮你少打几个字而是精确控制 Agent 的工具调用行为。Agent 在执行命令时会根据提示词内容判断是否激活以下工具search_file文件搜索search_web网页搜索memory记忆检索你可以在命令中用Dont search projects files! Dont search web! Dont search memory!等指令主动屏蔽不需要的工具让 Agent 跳过文件扫描、网页搜索等步骤直接调用大语言模型输出答案。两大类用法第一类代码操作类命令 —— 适合快速、重复、单一目标的任务适合场景快速、重复、单一目标领域专业、团队复用可分解、需并行工具调用search_file文件搜索search_web网页搜索memory记忆检索对比实验直接问 “Java 有哪些新特性”Agent 会扫描项目文件、执行网页搜索浪费时间和 Token。使用/j/java命令后Agent 跳过所有工具调用直接从 LLM 知识输出答案快且准。示例命令命令作用/c/code-inspect系统化评估源代码的技术质量、安全合规性/s/security-check检查安全漏洞、认证系统、数据保护/c/create-pr标准化代码提交流程含文档和质量门禁/p/project-test运行测试套件并系统化排查问题/gen-agents-md生成结构化的 agents.md 代理规范文件第二类知识查询类命令 —— 通过屏蔽工具让 Agent 直接调用 LLM 知识回答省时省 Token示例命令指令内容策略作用/j/java屏蔽全部工具直接调用 LLM 知识回答 Java 相关问题/l/llm屏蔽全部工具纯 LLM 直答探测模型知识边界/github屏蔽文件搜索和记忆允许网页搜索GitHub 知识 联网搜索确保信息最新/b/bash屏蔽文件搜索声明环境和工具生成精准的 Bash 命令和脚本/s/sql结合项目数据库上下文生成匹配项目数据库的 SQL 语句/t/translator屏蔽全部工具专注英文翻译快速无干扰/s/spring屏蔽全部工具回答 Spring 全家桶相关问题特性对比特性用户级指令项目级指令作用范围对当前用户的所有项目生效仅在当前项目中生效存储路径~/.qoder/r/c/commands/项目根目录/.qoder/r/c/commands/适用场景通用任务代码审查、翻译项目专属任务检查本项目 API 规范共享方式仅限当前用户可与团队共享配置示例创建入口两种方式方式 1使用/c/create-agent推荐Qoder 内置 create-agent 技能通过交互式引导快速创建。引导完成定义名称和描述 → 选择工具权限 → 自动生成系统提示词模板 → 保存到正确位置。方式 2手动创建文件格式示例## 概述 用于评估源代码的系统化框架以验证技术卓越性、稳健性和安全合规性。 ## 评估领域 ### 技术实现 - [ ] 需求准确实现 - [ ] 算法效率验证 - [ ] 资源管理优化 ### 风险管理 - [ ] 遵循安全最佳实践 - [ ] 数据验证全面 - [ ] 身份验证方法安全示例 1代码操作类/c/code-inspectDont search projects files! Dont search web! Dont search memory! 请根据你了解的 Java(8-25) 相关知识回答用户问题。示例 2屏蔽全部工具/j/javaDont search projects files! Dont search web! Dont 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 字段说明字段必填说明name是自定义智能体的唯一标识名称description是简短描述功能和专长用于模型自动选择tools否允许使用的工具列表用逗号分隔支持的工具列表工具名称说明Bash执行 shell 命令Edit对文件进行有针对性的编辑Write创建或覆盖文件Glob检索文件Grep检索文件内容Read读取文件内容WebFetch从指定 URL 获取内容WebSearch执行带有域过滤的 Web 搜索触发方式自动触发推荐自然语言描述任务模型根据 description 自动识别并调用手动触发输入/a/agent-name显式调用串联调用在一条指令中顺序调度多个智能体示例帮我审查这个接口的实现 → 自动识别并调用 code-review 智能体/code-review先使用 design subagent 完成系统设计再使用 code-review subagent 完成代码 review位置与作用域位置路径作用域用户级~/.qoder/r/a/agents/agentName.md所有项目项目级${project}/.qoder/r/a/agents/agentName.md仅当前项目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 汇总输出决策指南什么场景用什么场景推荐选择理由快速触发某个固定工作流Commands轻量、直接简单知识查询省时省 TokenCommands工具屏蔽机制需要领域专业知识但无需并行Skills知识注入 自动触发任务可分解为独立部分、需要并行Subagents独立上下文 原生并行想复用团队最佳实践Skills通过 Git 共享标准化需要长时间后台运行的任务Subagents上下文隔离不污染主对话七维对比维度CommandsSkillsSubagents触发机制斜杠命令用户主动输入Agent 自动发现 手动触发主 Agent 派发执行范围单一提示词驱动的工作流领域特定知识和工作流完整子任务独立上下文可重用性高用户级/项目级高全局/项目级包中等需协调配置上下文窗口影响低轻量中等动态加载低隔离上下文并行支持无有限通过 Hooks高原生并行配置复杂度低中高适合任务规模小任务中等任务大型/复杂任务最佳实践汇总通用原则先规划再编码中大型任务优先使用/p/plan明确范围和验收标准审查每次变更使用 diff 视图检查 Agent 修改保持人工决策权Commands 专项实践保持单一职责一个命令只做一件事避免过于复杂的链式逻辑命名用名词斜杠指令名称像课代表用名词指代角色或领域如/java、/translator使调用体验接近向某人提问屏蔽无关工具提速省 Token知识查询类命令首行用Dont search projects files! Dont search web! Dont search memory!声明编程语言在命令内声明目标语言如Programming language: Bash确保输出格式正确边界和环境声明提供当前操作系统、已安装工具、目标数据库类型等上下文让生成内容更准确Skills 专项实践模块化设计每个 Skill 专注解决一类问题避免大而全优先将通用知识放用户级全局业务规则放项目级使用/c/create-skill快速生成初始模板再手动优化定期更新 Skill 描述确保模型能准确判断相关性SKILL.md 控制在 100 行以内详细参考拆到子目录一个 Skill 只解决一类问题不做瑞士军刀Subagents 专项实践避免上下文污染每个子代理只处理独立的任务域设置退出检测器防止子代理陷入无限循环从简单两个子代理开始验证协调机制后再扩展核心概念速查工具屏蔽速查目标命令首行写法屏蔽全部工具Dont search projects files! Dont search web! Dont search memory!仅允许网页搜索Dont search projects files! Dont search memory!仅屏蔽文件搜索Dont search projects files!概念对比概念存储位置触发方式核心价值Commands.qoder/r/c/commands//命令名封装提示词省时省 TokenSkills.qoder/r/s/skills/{name}/SKILL.md自动识别/技能名注入专业知识团队复用Subagents.qoder/r/a/agents/{name}.md自动派发/代理名并行执行上下文隔离Plan Agent内置/p/plan先规划再执行Browser Agent内置/b/browser网页自动化Code Review Agent内置/c/code-review代码审查v2.0–

相关新闻