用途
grok-agents 是一套“变更上线前的独立审查关卡”。核心机制是审查者与构建者分离：写出代码的会话不能自己放行，必须由一个从未接触过本次构建的全新审查者读取变更，指出会导致阻塞或故障的问题。这种分离不随变更规模缩小：哪怕一行修复，也要走一轮审查，不能跳过。
工具本身是可选的，审查不是可选的。
主要能力
- 自动选择审查者：技能 scripts/ 目录中的封装脚本按环境挑选审查者。安装 Grok CLI 时使用 Grok，否则使用全新的无头 Claude Code 会话（只读工具，不加载设置、hooks、插件、MCP 服务器、自动记忆或已保存会话），从仓库和任务说明开始。
- 按 git 计算审查对象：第一轮覆盖上次发布到 HEAD 的全部提交以及工作区；提交可用
git log --oneline $RELEASED..HEAD、git diff $RELEASED...HEAD --stat、git status --porcelain -uall查看。尚无发布时第一轮覆盖项目起点以来的全部内容（--subject HEAD）。 - 范围可拆分但不可缩短：范围过大时按提交阶段拆分，或按产品表面（公开界面；数据、权限与资金；成员使用的屏幕）拆分并行审查，各区域合起来覆盖全部变更文件。后续轮次只把上一轮之后的提交作为主题，其余未发布范围作为上下文。
- 只读执行边界：通过
--tools read_file,grep,list_dir允许列表限制为只读工具，并用--disallowed-tools search_tool,use_tool、--deny MCPTool --deny Bash --deny Edit --deny Write、--disable-web-search关闭 MCP、shell 与写入能力。 - 失败可识别：封装脚本在轮次输出过短时以非零码失败（exit=2 表示轮次过短，按失败处理）；要求空轮次必须论述读过什么、预期发现什么以及为何如此判断。
使用方式
- 修复后自行运行项目测试关卡，提交并冻结快照（
git add -A && git commit -F -，SNAP=$(git rev-parse HEAD)）。 - 为该提交创建独立工作树：
git worktree add ../<repo>-review-<stage> "$SNAP"。 - 在独立工作树中运行封装脚本：
S="<a scratch directory>"
python <skill dir>/scripts/grok_review.py \
--brief "$S/review-NNN-brief.md" --cwd <repo> \
--subject "<range>" --out "$S/review-NNN.md" < /dev/null
echo "exit=$?" # 2 means the round was too short: treat it as failed
- 逐条对照代码核实发现（发现是主张而非结论，包括其严重级别标签），修复后重跑测试并再次审查，循环直到一轮没有高于 Low 的 INTRODUCED 发现、也没有任意时间产生的高危或严重问题，再推送该轮审查过的快照。
适用场景
- 每次发布前，无论测试多绿。
- 每次推送到会触发部署的分支前。
- 修复上一轮发现后再次审查。
- 长时间工作的阶段边界处可选审查，让发现在代码尚热时到达。
限制与注意事项
- 仓库自身的 agent 说明或发布文档优先；它们未规定时采用默认值，涉及只有所有者才知道的事实（发布哪个分支、上次发布是什么）时应询问。
- 审查者不得是构建线程的续接、分叉或子代理。同模型审查者与构建者共享更多盲区，这种代价被接受，因为跑起来的轮次胜过被跳过的轮次。
- 未跟踪文件少于 200 KB 的内容会被内联，目录中的小生成文件会整体进入审查；不属于变更的内容应先加入 .gitignore 或删除。
- 轮次在高推理强度下耗时数分钟，应在后台运行；轮次可能因上下文耗尽而以短输出失败，需读日志区分。
- 两个 CLI 都不在 PATH 时，可用
--subject-only写出主题文件与提示词，手动交给全新的只读会话执行。 - 上述仅为资料中明确描述的机制与操作，未提及收费、价格或平台支持范围，这些事实暂未提供。