Qoder必须通过项目级.qoder/rules目录配置规则，路径须严格为.qoder/rules且位于项目根目录；支持Markdown全局规则和JSON模块规则，启用需重载并验证提示效果，团队共享需提交至Git，本地调试规则应忽略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Qoder在特定项目里自动执行统一的代码规范、安全检查或风格约束，而不是依赖全局设置或手动触发——这必须通过项目级Rules配置实现，否则每次切换项目都要重设，团队协作时规则还容易错位。
创建项目专属规则目录结构
第一步是建立符合Qoder识别逻辑的物理路径。Qoder只扫描项目根目录下.qoder/rules子目录中的规则文件，其他位置一律忽略。
在终端中进入你的项目根目录，执行：mkdir -p .qoder/rules。
这一步不能跳过，也不能写成.qoder/rule或qoder/rules——【路径名必须严格为.qoder/rules，且开头的点号不可省略】，否则Qoder启动时根本不会加载任何规则。
写入核心规则文件
规则文件必须用明确的语义格式声明行为边界，否则Qoder无法解析触发条件。
方法一：用Markdown定义全局硬性约束
在.qoder/rules/global.md中写入：
```markdown
trigger: always-active
severity: error
description: 所有SQL查询必须使用参数化占位符，禁止字符串拼接
pattern: /'.*\+.*'/
fix: 使用PreparedStatement或QueryDSL替代
```
方法二：用JSON定义模块级边界校验
新建.qoder/rules/boundary-validation.rule.json，内容为：
```json
{"trigger":"file-specific","files":["src/**/service/*.java"],"rules":[{"id":"null-return","message":"Service方法禁止返回null","pattern":"return\s+null;","severity":"error"}]}
```
注意：JSON文件必须是合法语法，字段名大小写敏感——files不能写成Files，severity值只能是error或warning。
启用并验证规则生效
第一步：强制重载规则引擎
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
在Qoder IDE中按下⌘⇧,（macOS）或Ctrl+Shift+,（Windows），打开设置→规则→点击右上角“Reload Rules”按钮。
第二步：确认规则已注入当前会话
打开任意Java文件，在空白处输入return null;，若该行立刻出现红色波浪线并提示“Service方法禁止返回null”，说明File-Specific规则已激活。
第三步：检查Always Active规则是否后台运行
新建一个test.sql文件，写入SELECT * FROM user WHERE id = '1' + @input;，如果整行被标红并显示“SQL禁止字符串拼接”，则global.md中的always-active规则正在持续扫描。
这一步操作起来很简单，直接把文件拖进去就行。但若没看到预期提示，请检查.qoder/rules是否在Git仓库根目录下——【Qoder只认项目根目录下的.qoder/rules，子模块或嵌套目录里的规则不会被加载】。
绑定团队共享规则（可选）
如果你在团队中工作，需要所有人加载完全一致的规则集，必须将.qoder/rules目录提交进Git主干分支。
执行以下命令：
① git add .qoder/rules/
② git commit -m "chore(rules): sync team coding standards"
③ git push origin main
所有协作者克隆仓库后，Qoder会自动识别并加载这些规则——无需手动导入或复制粘贴配置文件。
本地调试专用规则要隔离，避免污染团队配置。在项目根目录的.gitignore中添加一行：.qoder/rules/local-*.rule，再把local-debug.rule放进去，它就不会被提交。
