SuperAPI AI 工具集

gbrain-advisor

智能体与模型

查看项目

更新于 10-15 21:50

技能介绍

用途:gbrain-advisor 是 gbrain 的主动式教练技能,负责告诉大脑所有者如何更好地运行它。它从现有大脑状态计算出一份按优先级排序的动作清单,并在固定节奏上向用户提示。

主要能力:只读,gbrain advisor 从不修改数据;只打印不执行,向用户展示发现并在运行任何修复前询问;有节制的提醒,只呈现变化或关键项,不重复已忽略的低严重度项。每周节奏运行,即使闲置大脑也会收到改进提示;每月还会呈现备份覆盖结论(gbrain backup status,即哪些知识仓库没有 git remote),并转达任何警告。

使用方式:运行 gbrain advisor --json。退出码是严重度门控:0 干净,1 警告,2 严重。JSON 载荷为 { version, generated_at, worst, findings: [...] }。每个 finding 含 severity(critical | warn | info)、title、fix.command_argv(修复命令的结构化 argv)、fix.dispatch_id(当修复可通过 --apply 安全运行时存在)。读取发现,按严重度从高到低,向用户总结前 1-3 项,展示 fix.command_argv 并询问是否运行。若用户同意且 finding 有 fix.dispatch_id,可用显式确认在本地运行:gbrain advisor --apply <dispatch_id>。--apply 仅限本地,以结构化 argv 运行修复(不经 shell),并先确认。没有 dispatch_id 的 finding 不能自动运行,需用户同意后自行运行其 fix.command_argv。绝不运行用户未批准的修复。

每周检查的 cron 配方:通过 cron-scheduler 技能安装每周任务,保持提示精简,任务只读取本技能并运行 advisor。计划为每周一个尊重安静时段的槽位(如周一 09:00 本地)。任务提示:Read skills/gbrain-advisor/SKILL.md and run gbrain advisor --json. If anything is critical or new since last run, ping me with the top items and the exact fix commands. Ask before fixing. 该 advisor 幂等,重复触发无害;它记录本地运行历史,因此每次触发可告知用户自上次运行以来的新变化。

输出格式:向用户呈现发现时,以严重度开头并保持可扫读,每个 finding 一个块,最高严重度在前,始终展示确切修复命令并在运行前询问。若无紧迫事项,用一行说明(“brain looks healthy”),不要制造工作。

失败处理:对任何 gbrain 错误码、退出码、[AGENT] 块或通知块,遵循 agent operator 协议。严重发现(待执行迁移)带有如 gbrain apply-migrations --yes 的修复:运行前询问用户;没有 dispatch_id 的 finding 不能自动运行。若 gbrain advisor 无法访问大脑(GBRAIN_DB_ACCESS 标记),应转至 db-repair 技能,而不是报告“无发现”。

限制与反模式:未经询问就运行修复;向用户倾倒原始 JSON;每次运行都重复提醒已忽略的低严重度项;把 info 当作 critical;通过 MCP 调用 advisor 操作来获取工作区安装状态(MCP 下 advisor 只返回大脑状态信号,未安装技能发现属于本地 CLI 关注点)。