用途:gbrain-advisor 是 gbrain 的主动“教练”,告诉用户如何更好地使用自己的 brain,而不是修改它。用户询问“如何更充分利用这个 brain”时可按需运行,也可通过 cron 按周运行,空闲的 brain 也会收到改进提示。
主要能力:运行 gbrain advisor --json 得到按严重程度排序的建议列表。退出码表示严重级别:0 表示干净,1 表示警告,2 表示严重。JSON 载荷包含 version、generated_at、worst 和 findings;每条 finding 含 severity(critical/warn/info)、title、fix.command_argv(结构化 argv),以及修复可通过 --apply 安全执行时出现的 fix.dispatch_id。
使用方式:读取 findings,从最高严重级别开始;用用户自己的语气总结最关键的 1-3 条,优先呈现 critical 项(例如待处理迁移);展示 fix.command_argv 并询问是否运行。若用户同意且存在 fix.dispatch_id,可执行 gbrain advisor --apply <dispatch_id>;该命令仅在本地运行、以结构化 argv 执行而非 shell,并会先确认。没有 dispatch_id 的 finding 不会自动执行,需在用户同意后自行运行其 fix.command_argv。
限制与注意事项:该技能按约定是只读的,advisor 从不修改 brain,只根据现有 brain 状态计算排序后的操作列表;只打印、不擅自执行,任何修复都必须先获得用户明确同意。应避免不加询问就运行修复、直接倾倒原始 JSON、每次重复提醒被忽略的低严重级别项,以及把 info 当作 critical。它记录本地运行历史,因此每次运行可只说明自上次运行以来的新变化。通过 MCP 调用时 advisor 只返回 brain 状态信号,未安装技能的 finding 属于本地 CLI 的关注范围。
cron 示例(周检查)使用 cron-scheduler 技能安排每周一个安静时段的任务,提示保持精简:读取本技能并运行 gbrain advisor --json,若有 critical 或新变化,则告知最重要项及确切修复命令,并在修复前询问。由于 advisor 只读,重复触发无副作用。输出时应先给严重级别、保持易扫读,每条 finding 一块并按严重程度排序;没有紧迫事项时用一行说明“brain 状态良好”。