用途:为 gbrain 安装生成一份 Agent 可读的健康检查报告。它封装 gbrain doctor --fast --json(文件系统等检查)与 gbrain apply-migrations --list(迁移状态),把两者汇总成一个 JSON。
主要能力:报告包含 healthy(布尔,true 表示无需处理)、summary(可用于简报的一句话摘要)、actions(需要执行的修复命令数组,非空时应按顺序执行)、doctor(gbrain doctor 的完整 JSON)、migrations(applied/pending/partial 计数)。退出码分三档:0 表示健康、无需操作;1 表示需要处理,应读取 actions[] 并执行;2 表示无法判断(二进制崩溃或子命令缺失),应视为紧急并排查。常见 actions 包括 gbrain apply-migrations --yes(存在待处理或半完成的迁移,幂等;若返回 partial,主机有非内置 cron 处理器需插件注册,见 skills/migrations/v0.11.0.md)、gbrain embed --stale(嵌入过期)、gbrain check-backlinks fix(死链或缺失反向链接);无 Run: 前缀的自由文本动作需由 Agent 判断并转述给用户。
使用方式:日常 cron(如 OpenClaw 的晨间简报)建议用 gbrain skillpack-check --quiet,仅凭退出码判断是否异常,非 0 时在简报里给出一行提示;按需调试时直接运行 gbrain skillpack-check 获取完整 JSON;CI 管线同样以退出码为门禁、JSON 作为证据。执行 actions 时可循环调用:for cmd in $(echo "$REPORT" | jq -r '.actions[]'); do eval "$cmd"; done。遇到退出码 2 需检查 which gbrain 是否返回路径、gbrain --version 是否退出 0、~/.gbrain/ 是否可访问。
适用场景:日常巡检、简报生成、CI 门禁与故障排查。
限制与注意事项:cron 中不加 --quiet 会把完整 JSON 刷进每封邮件;不要忽略退出码 2;不必每个对话轮次都运行,每小时一次或用户请求时即可;只有 fail 状态需要处理,warn 仅供信息参考。该技能本身不写文件,只逐字报告 CLI 输出。相关资料未提供安装命令与收费信息。