自定义指令(Custom Commands)
自定义指令功能允许您将常用的提示词(Prompts)和工作流封装为可复用的命令。只需在 Agent 对话框中输入/,即可快速调用这些指令,显著提升日常开发效率。
无论您是频繁执行代码审查、生成测试用例,还是需要快速查询项目规范,自定义指令都能将重复性操作简化为”一键式”任务。
指令类型与作用范围
| 特性 | 用户级指令(User Commands) | 项目级指令(Project Commands) |
|---|---|---|
| 作用范围 | 对当前用户的所有项目生效 | 仅在当前项目根目录及其子目录中生效 |
| 存储路径 | - macOS / Linux: /home/<username>/.qoder/commands/ 或 /Users/<username>/.qoder/commands/- Windows: C:\Users\<username>\.qoder\commands\ | <项目根目录>/.qoder/commands/ |
| 适用场景 | 通用开发任务,例如: • 审查代码 • 生成单元测试 | 项目专属任务,例如: • 检查本项目 API 规范 • 校验配置文件格式 |
| 共享方式 | 仅限当前用户使用 | 可通过 Git 等版本控制系统与团队成员共享 |
注意:用户级指令不支持跨设备同步,您可以手动迁移配置文件。
创建自定义指令
-
打开指令管理界面
- 方法一:进入 Qoder 设置中的指令页面,点击 “添加” 按钮
- 方法二:在对话框中输入
/,点击底部的 “添加指令” 快捷入口
-
在顶部搜索栏中输入一个唯一指令名称(如
gen-test),然后按 回车。 -
选择指令类型:
- 用户级:适用于所有项目的通用命令
- 项目级:仅在当前项目中可用
- 在引导文案区域填写完整的提示词内容,保存文件后将自动保存您的指令。
-
返回会话,在对话框内输入
/即可看到新创建的指令。
示例指令
/code-inspect
/code-inspect
/security-check
/security-check
/create-pr
/create-pr
/project-test
/project-test
/gen-agents-md
/gen-agents-md