功能

AGENTS.md

项目规则是 Grok 为目录树中的每个 session 加载到 context 的 Markdown 文件。将编码规范、build 和 test 命令以及架构说明写入 repository 根目录的 AGENTS.md,Grok 无需在每个 session 中被重复告知就会遵循它们。

发现规则

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

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

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

在每个目录中,Grok 会读取 AGENTS.mdAgents.mdAGENT.mdCLAUDE.mdClaude.mdCLAUDE.local.md 中的任意文件,以及每个 *.md 文件(这些文件位于 .grok/rules/ 目录中;为兼容性,也会读取 .claude/rules/.cursor/rules/)。.gitignore 忽略的文件会被跳过,因此 CLAUDE.local.md 等个人覆盖不会进入共享 context。

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

Text

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

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

Session 规则

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

Bash

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

验证

Bash

grok inspect

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