Grok Build项目规则怎么写？AGENTS.md层级、忽略文件与inspect核对

每次进入项目都重复讲测试命令和目录约定，可以用项目规则文件。Grok Build会按目录层级加载Markdown规则，但兼容文件和忽略规则也会影响结果。本文解释它自己的发现顺序，不能照搬Codex或Claude Code的规则优先级。

第一步：写少而明确的仓库规则

在练习仓库根创建AGENTS.md，先列项目用途、正确测试命令和需要保留的边界。只写已经核实的事实，不凭目录名猜构建方式。编辑已有规则前备份，保留他人有效约定，不用整份新模板覆盖。

官方说明完整加载文件且没有大小上限，但短而具体更易遵循。不要把整份依赖文档或日志堆进规则，也不要放密钥。规则用于持续背景，临时任务细节应留在当前指令。

项目规则示例：先阅读README确认入口；只在本任务指定包内修改；不编辑生成目录；测试命令未确认时先报告，不猜测；完成后列出变更文件、实际检查与未验证项。

第二步：理解发现顺序与嵌套范围

官方说明先加载~/.grok/全局规则，再加载从仓库根到工作目录各级规则，更深文件冲突时优先。Git仓库外只看工作目录对应规则，不能假设自动向上读取任意父目录。

嵌套AGENTS.md只作用于子树，多包仓库可分别声明前端与后端约定。不要为了同一规则复制到每个目录，公共内容放根，差异才放子包；改动深层规则后要重新核对有效范围。

第三步：检查兼容规则与忽略文件

Grok也会读取多种AGENTS大小写变体、CLAUDE文件及.grok/rules中的Markdown，并兼容部分.claude/rules和.cursor/rules。已有项目可能同时有多份来源，不能只读自己刚新增的一份就推断最终规则。

官方说明.gitignore忽略的文件会被跳过，包括用于个人覆盖的文件。文件在磁盘存在不代表被加载；不应为了生效就取消所有忽略项，可能把私人配置加入共享上下文或版本控制。

第四步：用inspect检查实际加载

从真实工作目录运行grok inspect，查看找到的规则路径与近似token量。记录当前目录，换到子包后再检查，确认嵌套范围。检查的是发现结果，不是已经证明每条自然语言指令永不被误解。

grok inspect

验收字段：当前目录；根规则；嵌套规则；兼容来源；被忽略文件；冲突项；实际加载路径。

第五步：用只读任务验证理解

让Grok复述本任务适用规则，说明哪些来自根、哪些来自子包，再进行一个不修改文件的小任务。若复述与inspect不一致，先定位上下文和目录，不马上增加更多重复指令。

请只解释当前练习包的适用规则与入口，区分已加载规则和你的建议。不运行构建、不修改文件、不访问凭据。若规则冲突，列出来源与适用范围，不擅自合并成新的要求。

第六步：谨慎使用会话规则

官方提供–rules为单次运行追加规则；system-prompt-override则替换系统提示，作用不同，不应为一个小偏好使用整体替换。项目规则也不会自动授予工具权限，仍需独立检查权限和沙箱。

完成后保留实际加载清单、规则版本与练习结果，清理无用重复内容。跨工具共享同名文件时尤其注意兼容影响，不能因为Grok加载成功就声称其他代理按相同优先级工作。

官方资料

资料核对日期：2026年11月15日。

• xAI：Project rules—AGENTS.md