Skip to content

规则、技能、权限都没生效?先看这个目录被信任了没有 ​

这是「Grok Build 实战」系列:Dato 和他的 Bot 把官方文档和别人的教程对着真实安装的 CLI(1.0.52)验证了一遍。本篇参考了:官方文档:Grok Build 概览。命令输出和截图都是我们自己做的,没有搬运原文;没做到的会写明。

这是我们这次动手里最有价值的发现,所以单独写一篇。

官方的说法很吸引人:你的 AGENTS.md、插件、钩子、技能、MCP 服务器“开箱即用”[^1]。我们去验证的时候,第一次却一个都没看到。

我们搭的测试项目 ​

一个空的 git 仓库,里面放了:

  • AGENTS.md:两条规则(改完跑测试、不改依赖版本)
  • CLAUDE.md:一行(测试兼容读取)
  • .grok/rules/commit.md:提交信息用中文
  • .cursor/rules/style.md:组件用函数式写法
  • .grok/skills/release-note/SKILL.md:一个“生成更新说明”的技能
  • .grok/config.toml:三条权限规则(下一篇详述)

结果:同一个目录,信任前后完全不同 ​

信任前后

  • 第一次 grok inspect:Project trusted: no,项目规则 None、权限 0 条、技能 None。
  • 加上 --trust 再看:规则 4 个(连 .cursor/rules 里的都被读到了,并标注 [cursor])、权限 3 条、技能 1 个。

为什么会这样 ​

官方钩子文档里写得很明确[^2]:项目里的钩子在信任之前会被静默跳过;信任决定会记录在 ~/.grok/trusted_folders.toml(我们实测里面确实多了一条我们的测试目录)。而且一次信任同时覆盖 MCP、LSP、钩子、项目规则、项目技能,同一仓库的子目录也算,但嵌套的另一个 git 仓库不算。这是为了防止恶意仓库一打开就让你的机器执行它带来的脚本。

而且官方文档还写了:用户级 ~/.grok/rules/ 里的规则不受信任影响。所以症状常常是:"我的全局规则有效,项目里的规则怎么没反应?"

怎么做 ​

bash
cd your-project
grok inspect          # 先看:Project trusted 是 yes 还是 no
grok --trust          # 确认这个仓库可信之后再信任

别一律信任

--trust 等于告诉它“这个仓库里的脚本可以跑”。拿到陌生仓库,先自己看一眼 .grok/、钩子、MCP 配置,再决定信不信。陌生仓库建议配合官方的 strict 沙盒(见《权限和沙盒》)。

顺便验证了:它会读别家的规则文件 ​

我们的测试里,AGENTS.md 和 CLAUDE.md 同时被读取,.cursor/rules/*.md 也被读取。官方规则文档说它会读 Agents.md / Claude.md / CLAUDE.md / CLAUDE.local.md / AGENT.md / AGENTS.md 这一族,还扫描 .claude/rules/ 和 .cursor/rules/,并且可以按厂商关闭兼容[^3]。这意味着已有 Cursor 或 Claude 项目的人,不用重写规则就能让 Grok Build 遵守,也意味着:你以为只给另一个工具看的规则文件,它也会读,写规则时别放不想让它看的内容。

复制可用的“规则体检”提示词 ​

等你登录之后,可以对它说:

text
列出你这次会话加载的全部项目规则文件(文件名即可),
再告诉我哪些规则之间互相矛盾。不要改任何文件。

(这条我们没法实测,因为没登录;用 grok inspect 可以先在不登录的情况下看到加载清单。)

常见问题 ​

Q:Project trusted 是 no,但我从来没点过信任?

A:首次进入一个 git 仓库就是未信任状态(我们的实测)。我们没验证交互界面里是否会弹出信任提示,未证实。

Q:全局规则放哪?

A:官方文档:~/.grok/rules/,所有项目都会读,不受目录信任影响[^3]。

Q:怎么撤销信任?

A:文档里提到了 /hooks-untrust 命令[^2],我们没试。信任记录在 ~/.grok/trusted_folders.toml。

想直接开通? ​

需要代充,请联系站长,微信 siuserxiaowei(备注"Grok Bot 教程")。首单报优惠码 xiaowei 立减 20 元。更多免费教程在 grokguide.si。

风险提示

官方定价页写明,订阅只通过官网直接销售,不授权第三方卖家,从其他渠道买的订阅可能被暂停(cursor.com/pricing)。站长提供的是个人代充服务,与 xAI / Grok / Cursor 官方无关,请了解风险后再决定。任何时候都不要把账号密码、验证码交给别人,包括站长。

参考来源 ​

[^1]: https://docs.x.ai/build/overview(核验 2026-10-15) [^2]: grok 1.0.52 自带文档 10-hooks(Trusting a project)(核验 2026-10-15) [^3]: grok 1.0.52 自带文档 12-project-rules(核验 2026-10-15)

非官方教程,内容整理自官方文档和社区讨论,以官方最新说明为准。 · 联系作者 / 加微信交流