Qoder自定义指令需按五步系统化创建：一、在指令管理页注册命名指令并设作用域；二、嵌入文件路径、依赖版本及上下文代码；三、用##标题结构化角色、任务与输出格式；四、用“增强Prompt”按钮补全约束；五、通过Rules固化命名、API等硬性规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Qoder中频繁执行重复性开发任务，但每次都需要手动输入冗长、结构松散的提示词，则可能是由于未启用自定义指令机制或Prompt缺乏工程级约束。以下是实现Qoder自定义AI指令创建与Prompt高质量编写的系统化操作步骤：
一、创建自定义指令的基础流程
通过Qoder指令管理界面注册可复用的命令，使高频操作固化为“/指令名”一键调用形式，避免每次重复组织语言。该流程不依赖外部插件，全部在Qoder原生环境中完成。
1、打开Qoder设置中的“指令”页面，点击右上角“添加”按钮。
2、在弹出窗口顶部搜索栏中输入唯一指令名称（如gen-android-test），按回车确认。
3、选择指令适用范围：用户级（全局生效）或项目级（仅当前项目可用）。
4、在引导文案区域粘贴完整Prompt内容，确保包含角色、约束、上下文三要素。
5、点击“保存”，返回对话框输入/即可在下拉列表中看到新指令。
二、注入项目级上下文约束
Qoder默认将未标注路径与版本的Prompt视为通用场景处理，导致生成结果脱离实际工程环境。显式绑定项目元信息可强制模型调用匹配的知识路径与依赖栈。
1、在Prompt开头嵌入当前编辑文件的绝对路径，格式为：当前文件:/app/src/test/java/com/example/feature/LoginPresenterTest.java。
2、声明核心依赖版本，例如：本项目使用Retrofit 2.9.0、Kotlin 1.8.20、Gradle插件8.2.2。
3、粘贴不超过15行的关键上下文代码，并标注说明，例如：参考接口定义如下:interface AuthService { suspend fun login(email: String, pwd: String): Result}。
三、结构化指令格式并强制输出规范
Qoder对Markdown三级标题标记的Prompt具有更高解析优先级，能直接触发Rule驱动校验流程，防止输出偏离模板要求。
1、使用## 角色定位标题块定义AI身份，例如：你是一位深耕Android平台5年的资深测试架构师，专精JUnit 4.13.2与Mockito 3.12.4生态。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、使用## 任务目标标题块限定唯一动作，例如：仅生成符合Robolectric 4.9环境的单元测试类，不涉及UI测试或集成测试逻辑。
3、使用## 输出格式要求标题块规定结构，例如：每个测试方法必须以test[Method]_[Scenario]_[Expected]命名，且断言全部基于assertThat()调用。
四、启用内置Prompt增强功能
Qoder提供“增强Prompt”按钮，可自动补全缺失的工程约束项，尤其适用于已有简略描述但尚未结构化的初始Prompt。
1、在Qoder编辑器中输入原始需求描述，例如：“帮我写个登录测试”。
2、选中该文本，点击工具栏中的“增强Prompt”按钮。
3、Qoder将自动生成含角色、技术栈、边界、格式的完整Prompt草案。
4、人工校验后，复制该增强版Prompt至自定义指令的引导文案区域。
五、利用Rules固化Prompt风格
Rules是Qoder中用于长期记忆开发者偏好的机制，可将常用约束条件（如命名规范、禁用API、断言方式）预设为不可绕过的硬性规则，避免每次重复声明。
1、进入Qoder设置 → Rules管理 → 点击“新建Rule”。
2、在Rule名称栏填写标识符（如android-test-rules）。
3、在规则内容中逐条列出约束，例如：禁止调用System.currentTimeMillis();禁止使用@UiThread注解;所有断言必须基于assertThat()。
4、在自定义指令的Prompt末尾添加引用语句：请严格遵循已激活的Rules：android-test-rules。
