mcpField
G
grok-subagent

grok-subagent

github.com/chuxubankAgent 工作流048 次安装6 天前更新
代码仓库

关于 grok-subagent

grok-subagent 是一项将聚焦的实现任务委派给 Grok 的技能，同时由父 Agent 负责范围、审查、验证和发布。它强调先核实 CLI 用法、限制无交互执行，并独立检查改动。

主要功能

  1. 01核实已安装 CLI 的版本与参数
  2. 02明确任务边界和操作约束
  3. 03以无交互模式运行 Grok
  4. 04检查停止原因和仓库改动
  5. 05独立审查并验证实现
  6. 06进行聚焦的修正轮次

适用场景

  1. 01委派边界明确的代码改动
  2. 02避免混淆不兼容的 Grok CLI 变体
  3. 03确认无交互运行是否真正完成
  4. 04提交前审查委派产生的改动

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/chuxubank/skills --skill grok-subagent

安装后在 Claude Code 中输入/grok-subagent确认已加载。

详细介绍

Grok 子 Agent

将 Grok 用作实现工作者。父 Agent 负责范围、审查、验证、提交和对外发布。

工作流

1. 确认本地 CLI 约定

运行：

grok --version
grok --help
jq --version

优先使用已安装二进制文件报告的标志。Grok Build 1.0.5 使用：

  • -p, --single <PROMPT> 执行一次无头轮次
  • --prompt-file <PATH> 指定提示词文件
  • --cwd <PATH> 指定工作目录
  • --permission-mode auto 用于非交互式实现
  • --output-format json 显示实际停止原因
  • --no-subagents 禁止嵌套委派

其他名为 Grok CLI 的项目使用不兼容的标志，例如 --prompt 和 --directory。未经检查 --help，切勿在不同 CLI 变体之间转换示例。

2. 确立边界

委派之前：

  1. 检查仓库状态和当前分支。
  2. 保留并说明任何预先存在的更改。
  3. 给 Grok 分配一项重点明确的任务，并明确完成标准。
  4. 指明值得检查的文件或本地参考实现。
  5. 指定确切的验证命令。
  6. 除非用户明确委派给 Grok，否则提交、打标签、推送、发布软件包和破坏性 Git 操作均由父 Agent 负责。

对于并行或有风险的工作，请在调用 Grok 之前在其工作区之外创建隔离环境。无头 -p 不会通过 --worktree 创建工作树。

3. 无头调用 Grok

如果宿主支持 shell 子 Agent，请将此调用委派给其中一个，以便父 Agent 能继续协调其他工作。shell 子 Agent 必须实际运行 Grok，而不是代替它实现任务。

使用绝对仓库路径，并通过 heredoc 引用提示词。捕获 JSON，因为即使工具调用被取消，Grok Build 1.0.5 也可能以状态码 0 退出：

grok_result=$(grok -p "$(cat <<'EOF'
Work in /absolute/path/to/repository.

Task:
- <one focused implementation goal>

Requirements:
- <behavior and compatibility constraints>
- Preserve existing public APIs unless explicitly changed.
- Preserve pre-existing uncommitted changes.

Verification:
- Run <exact test/build commands>.
- Run git diff --check.

Do not commit, tag, push, publish, reset, or discard unrelated changes.
Return changed files, design decisions, test results, and unresolved risks.
EOF
)" \
  --cwd "/absolute/path/to/repository" \
  --permission-mode auto \
  --no-subagents \
  --output-format json)

printf '%s\n' "$grok_result"
printf '%s\n' "$grok_result" | jq -e '.stopReason == "end_turn"' >/dev/null

可执行文件路径未知时，使用 command -v grok。对于很长的生成式提示词，使用 --prompt-file。不要在提示词中包含凭据、令牌或私密数据。不要将 auto 替换为 bypassPermissions；应将委派的工作目录和任务边界保持精简。

即使进程以状态码 0 退出，遇到 cancelled、max_turns、输出缺失、JSON 无效或任何其他停止原因，都应视为调用失败。对于修改任务，还必须确认仓库中出现了预期差异；没有请求的文件或行为，即使 end_turn 也不算成功。

4. 集中审查

将 Grok 的报告视为需要核实的声明：

  1. 检查 git status、git diff --stat、git diff --check 以及完整的相关差异。
  2. 阅读每个新增的公共接口和安全敏感路径。
  3. 确认删除和依赖项变更均为有意操作。
  4. 独立运行所需测试和构建。
  5. 如果任务替换了旧 API 或软件包，请搜索过时引用。
  6. 检查是否只有预期文件发生了更改。

只有当父 Agent 能说明最终设计，并有直接证据证明验证已通过时，此步骤才算完成。

5. 进行针对性修正

如果审查发现缺陷，请向 Grok 发送范围明确的修正任务，其中包括：

  • 具体缺陷及其重要性
  • 所需行为
  • 需要修改或添加的测试
  • 相同的 Git 和范围约束

在可行的情况下，继续使用同一个宿主 shell 子 Agent，使其保留实现上下文。在该子 Agent 中再次运行 Grok，然后重复集中审查。

如果 Grok 停滞或退出时没有编辑内容，请检查 .stopReason、输出和仓库状态。工具调用建议发出后出现 cancelled，通常表示权限模式不匹配。只有在更改了有证据支持的原因后，或任务范围缩小且完成标准更明确时，才重试一次。没有新证据时，不要重复相同调用。

提示词清单

  • 仓库绝对路径
  • 单一且明确的目标
  • 需要保留的现有更改
  • 精确的行为要求和非目标
  • 语言和架构约束
  • 相关源文件和参考路径
  • 错误和兼容性预期
  • 必需的测试和构建命令
  • 禁止提交和推送的防护要求
  • 预期的最终报告

完成报告

报告以下内容：

  • Grok 命令格式、CLI 版本和 JSON 停止原因
  • 实现概要
  • 已更改或删除的文件
  • 独立测试和构建结果
  • 父级执行的提交或发布
  • 剩余阻碍，或物理设备／运行时验证情况

评论

支持 Markdown