AGENTS.md

发现规则

Grok 按以下顺序加载规则，发生冲突时更深层文件优先：

1. ~/.grok/ 中的全局规则

2. 从 repository 根目录到工作目录的每个目录（在 git repository 外则只检查工作目录）

在每个目录中，Grok 会读取 AGENTS.md、Agents.md、AGENT.md、CLAUDE.md、Claude.md 和 CLAUDE.local.md 中的任意文件，以及每个 *.md 文件（这些文件位于 .grok/rules/ 目录中；为兼容性，也会读取 .claude/rules/ 和 .cursor/rules/）。.gitignore 忽略的文件会被跳过，因此 CLAUDE.local.md 等个人覆盖不会进入共享 context。

嵌套的 AGENTS.md 仅作用于其 subtree，因此 monorepo 可以为每个 package 提供不同规范：

my-monorepo/
  AGENTS.md                # repo-wide rules
  packages/
    frontend/AGENTS.md     # "Use React. Prefer CSS modules."
    backend/AGENTS.md      # "Use Express. Follow REST conventions."

文件会完整加载，没有大小上限；简短、具体的指令比冗长指令更容易被可靠遵循。

Session 规则

如需为单次运行添加规则而不编辑文件，请传递 --rules（Grok 会将文本追加到 system prompt），或使用 --system-prompt-override 完全替换 system prompt：

grok --rules "Always use TypeScript. Prefer functional components."

验证

grok inspect

该命令会列出 Grok 找到的每个规则文件，包括其路径和大致 token 数量。