跳转到主要内容

自定义指令(Custom Commands)

自定义指令功能允许您将常用的提示词(Prompts)、固定流程和项目约定封装为可复用的命令。在 Agent 对话框中输入 / 后,您可以浏览、筛选并调用当前可用的指令,用更少的输入完成重复任务。 无论您是频繁执行代码审查、生成测试用例,还是需要快速查询项目规范、整理提交说明或发起标准化任务,自定义指令都能把高频操作沉淀为稳定、可复用的工作入口。

指令类型与作用范围

注意:用户级指令不支持跨设备同步,您可以手动迁移配置文件。 注意:创建项目级指令前,请先打开目标项目;若同时存在同名的用户级指令和项目级指令,列表中会附带作用范围标识,便于区分。

创建自定义指令

  1. 打开指令管理界面
    • 方法一:进入 Qoder 设置中的指令页面,点击 “添加” 按钮
    • 方法二:在对话框中输入 /,点击底部的 “添加指令” 快捷入口(如界面显示该入口)
  2. 在顶部搜索栏中输入一个唯一指令名称(如 gen-test),然后按 回车
    • 建议使用简短、清晰、便于记忆的名称
    • 建议避免与已有指令重名,减少检索和选择时的混淆
  3. 指令名称需遵循以下规则:
    • 仅支持小写字母、数字、连字符(-)和下划线(_
    • 名称不能为空
    • 名称长度建议控制在 100 个字符以内
    • 同一作用范围下不能与现有指令重名
  4. 选择指令类型:
    • 用户级:适用于所有项目的通用命令
    • 项目级:仅在当前项目中可用;若未打开项目,则无法创建
  5. 在编辑区域填写指令说明和正文内容。建议在开头用简短描述说明用途,正文中写入完整提示词或操作步骤。
  6. 保存后,返回会话,在对话框内输入 / 即可看到新创建的指令。
注意:若指令正文为空,或仅保留默认占位内容,该指令不会出现在可用列表中。

指令更新与列表刷新

当您新增、修改或删除指令文件后,指令列表会按最新状态刷新,方便您继续在会话中使用最新版本。 常见刷新场景包括:
  • 新增指令后,列表中会出现新的可选项
  • 修改指令内容后,后续选择时会使用更新后的内容
  • 删除指令后,列表中对应项目会消失
如果您会同时维护较多指令,建议:
  • 按用途将指令放入不同子目录,便于整理
  • 为指令填写清晰描述,方便在列表中搜索和识别
  • 定期清理不再使用的旧指令,减少重复和混淆

示例指令

→ 立即体验
→ 立即体验
→ 立即体验
→ 立即体验
→ 立即体验