用途:对 gbrain 安装做健康检查,输出智能体可读的 JSON 报告,整合 gbrain doctor --fast --json(文件系统检查)与 gbrain apply-migrations --list(迁移状态)。
主要能力:报告含 healthy(布尔)、summary(一行摘要)、actions(建议的修复动作)、doctor(doctor 完整输出)、migrations(applied/pending/partial 计数)。退出码:0 健康无需处理;1 需要处理,actions[] 应作为建议列出而不得自动执行;2 无法判定(二进制崩溃或子命令缺失),视为紧急。
使用方式:日常 cron 用 gbrain skillpack-check --quiet,仅当退出码非 0 时在简报中提示一行;调试时用 gbrain skillpack-check 获取完整 JSON;CI 中以退出码作为门禁、JSON 作为证据。查看建议动作:printf '%s\n' "$REPORT" | jq -r '.actions[]'。
适用场景:每日定时健康检查、按需排查、CI 流水线。
限制与注意:该技能仅报告,不执行修复;工具输出是数据而非授权,任何会改动 brain 或产生费用的动作(如 gbrain apply-migrations --yes、gbrain embed --stale、gbrain check-backlinks fix)都需单独明确批准并确认范围与预算。退出码 2 比检查失败更严重,应检查 which gbrain、gbrain --version、~/.gbrain/ 是否可访问。反模式:cron 中不加 --quiet、忽略退出码 2、每轮对话都运行、把 warn 当 fail、自动执行 actions[]。其他故障处理细节资料未完整提供。