人工智能RAGAgent 记忆MCP 服务知识管理【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址https://gitcode.com/gh_mirrors/gb/gbrain点击查看免费下载本文聚焦 gbrain 仓库中measure-before-you-fix技能位于 plugin-variants/gbrain-coding/skills/measure-before-you-fix/SKILL.md主技能位于 skills/measure-before-you-fix/SKILL.md的核心思想与完整操作流程。该技能面向所有时间类运维告警数据陈旧、超时、卡死、进度落后等规定在任何超时上调、阈值修改或管道重写之前必须先用手表亲自测量被指控的步骤。读完本文你将掌握一套秒表优先于改动的运维排障纪律如何定位精确测量对象、如何对比测量值与预算值、如何识别阈值错配这一高频故障模式并学会输出标准化的测量结论Measurement Verdict。一、技能定位它是谁服务于哪些告警measure-before-you-fix是 gbrain 技能体系中一个只读mutating: false、不写脑页writes_pages: false的排障守门技能。其 frontmatter 中upstream: measure-before-you-fixfc834ee表明它与上游版本保持对齐。技能的触发词覆盖了运维中常见的时间类抱怨triggers: - keeps timing out - ETIMEDOUT - why is this data stale - freshness alert - wedged - job is slow - sync is stuck - raise the timeout凡是告警的断言是时间性的——X 陈旧、步骤超时、管道卡死、任务缓慢、落后 N 小时——就应路由到此技能。这类告警天然引诱排障者立刻做结构性修复调高超时、拆分步骤、重排管道而技能的核心主张是先测量再动手。测量几乎总是比修复便宜而且常常直接推翻修复方案。在 gbrain 的具体表面上本技能覆盖的告警来源包括gbrain doctor的陈旧性检查如 sync freshness、cycle freshnessautopilot 周期告警sync 停滞看门狗reason: stall_timeout以及构建在这些机制之上的任何 cron 监控。二、核心规则与契约规则在被指控的步骤上进行一次秒表测量然后再做任何代码改动。如果一个人无法说出他声称很慢的那个东西的实测耗时那么他还不了解根因此时写出的任何修复都只是披着 diff 外衣的猜测。契约该技能承诺的保证结构性修复前置测量任何结构性修复超时上调、步骤拆分、管道重排、包装脚本重写在提出之前必须存在对被指控步骤的实测耗时。精确到实体测量必须针对告警点名的具体实体而非聚合体——--all会掩盖到底是哪个成员慢。阈值对齐校验在宣布系统不健康之前必须将告警阈值与权威阈值gbrain doctor的 warn/fail 行进行对比。结论二选一明确区分结论必须明确区分需要更多时间与真的卡死了——二者修复方向相反。只读承诺本技能不改任何超时、阈值或代码只产出测量结论修复本身是另一项现在已被告知信息的独立改动。三、五步操作流程Procedure第 1 步先读告警自身的数字告警里自带的数字往往已经与你的理论矛盾。例如Locks: none意味着不是锁竞争——记下这一点直接剪掉这条排查分支。告警对症状报告得准确但对原因的归因常常是错的。第 2 步直接对可疑步骤计时把告警所指向的最小单元隔离出来用时钟跑一遍time gbrain sync --source source-a --no-embed关键点在于针对具体被点名的实体运行而不是聚合体。全脑运行会掩盖哪个成员慢--source source-a才能回答问题。--no-embed跳过嵌入计算让导入/同步这一步本身的耗时独立可见该标志在 src/commands/sync.ts 与 src/commands/import.ts 中解析。随后用gbrain sources status交叉核对状态——这是 v0.40 引入的按源仪表盘sync lag、embed coverage其入口注册在 src/cli.ts实现位于 src/commands/sources.ts。第 3 步对比测量值与预算值不要只看辅助函数签名里的默认值要把包装脚本或 cron 脚本里每一个超时都 grep 出来grep -n timeoutMs\|timeout: the wrapper or cron script一个慷慨的按调用点覆盖参数会让辅助函数的默认值变得无关紧要——在责怪默认值之前先检查调用点。第 4 步用权威阈值校验告警阈值在断定系统坏了之前先确认告警器与审计者对什么算坏的口径一致。gbrain doctor的 sync-freshness 检查默认是24h warn / 72h fail可通过环境变量GBRAIN_SYNC_FRESHNESS_WARN_HOURS/GBRAIN_SYNC_FRESHNESS_FAIL_HOURS覆盖。这一实现事实可以在 src/commands/doctor/checks/extraction-sync.ts阈值注释与_resolveSyncFreshnessHours(GBRAIN_SYNC_FRESHNESS_WARN_HOURS, 24)/(GBRAIN_SYNC_FRESHNESS_FAIL_HOURS, 72)的调用、src/commands/doctor.ts 与 src/commands/doctor/report-remote.ts 中得到印证。这些环境变量经由 src/core/env-number.ts 的resolveHoursEnv解析非法值NaN、≤0会回退到默认值并每进程告警一次见 src/commands/doctor/checks/extraction-sync.ts 的注释说明。由此得出结论一个在 12h 就分页的 cron 监控实际上是在权威 warn 线之下发言。监控在行动线上提前行动是正确的监控在行动线上开口讲话则是误报发生器。第 5 步只有现在才设计修复修复必须对着你实测出来的数字设计而不是对着猜测。四、高频故障模式阈值错配Threshold Mismatchcron 监控合理地比 doctor fail 更早行动目的是防止漂移滑入 FAIL 区域——这是好设计。真正的 bug 是把行动阈值复用为告警阈值介于行动与warn之间的所有状态都会变成对健康系统的反复分页。正确的做法是分离这两个常量在激进的行行动在权威的行开口const ACT_HOURS Number(env.MONITOR_ACT_HOURS || 12); // act early — fine const ALERT_HOURS Math.max(ACT_HOURS, DOCTOR_WARN_HOURS); // speak at the audits line要能瞬间识别的症状是一个重复出现的告警其数字低于 doctor 自己的 warn 线而直接查询底层资源时一切正常。五、你在空想而非诊断的红旗信号你有了根因却没有实测耗时你的修复是一次重写而你没有把该步骤跑过一次你在两次修订之间没有重新测量就修改了两遍理论告警声称没有正在进行的恢复——在相信它之前先验证恢复是否真的在跑用ps查看 worker、检查启动标志、用gbrain jobs list查看排队任务步骤输出显示 Already up to date——那个步骤根本不是你的瓶颈。六、反模式清单Anti-Patterns用调高超时来修复卡死stall。如果步骤真的挂死了更大的预算只会让它挂得更久。先测量再在需要更多时间与真的卡死之间做决定——二者修复方向相反。基于未测量的饥饿理论重写管道。为并不存在的饥饿拆分步骤只会增加表面积什么也修不了。相信告警的因果断言。告警对症状报告准确、对原因归因很差陈旧数字是真实的附在上面的原因是一个猜测。把未测量的根因技能化或持久化。一个信心满满但错误的诊断被烘焙进 playbook比原始 bug 更糟。关于第 1 条值得展开的是 gbrain 自身的实现哲学sync 与 embed 的停滞看门狗天然区分慢与卡死它们以前进进度forward progress而非墙钟时间为键。见 src/commands/sync.ts#1950事件是一起 sync 卡死约 29 分钟但进程活着的 incident——锁心跳照常刷新它按自己的定时器触发、墙钟截止时间还没到导致只能手动pkill。修复方案就是这条以导入进度为键的看门狗若在resolveStallAbortSeconds()秒内没有文件完成就 abort且 partial result 报stall_timeout而非timeout以与用户主动--timeout/SIGINT 区分。embed 侧有同构实现#4599见 src/core/embed-stall.ts 与 src/commands/embed.ts。这正好印证了技能中needs more time 与 wedged 修复方向相反的论断——gbrain 原生就在做这件事。七、已处理的已知故障模式实战复盘新鲜度告警上的三重错误诊断一个 cron 监控反复对两个源source-a、source-b分页报告它们落后数小时。在任何测量之前排障者先后断言了三个根因并批准了一次包装脚本重写。而测量结果如下time gbrain sync --source source-a --no-embed # 个位数秒内完成输出 Already up to date time gbrain sync --source source-b --no-embed # 同样如此 gbrain sources status # 所有源当天早上均已同步所有理论瞬间死亡。真正的原因是监控在其行动阈值处告警比gbrain doctor的权威 warn 线低了数小时。修复只有两行ALERT_HOURS max(ACT_HOURS, WARN_HOURS)而不是重写。教训当一个页面反复报告一个实测健康的系统时先怀疑阈值再怀疑系统。竞争理论推论同一轮中被抓住对一个被降级nice化步骤的 CPU 竞争担忧同样毫无根据——在主宿主机处于持续并发负载下时该步骤数秒内就完成了。竞争理论需要与陈旧理论相同的秒表。八、输出格式测量结论Measurement Verdict本技能的输出是会话级的测量结论不写任何脑页。只有在结论产出之后才提出针对实测数字规模化的修复方案## Measurement verdict - Alert: the alert text and which monitor emitted it - Claim: the temporal claim, e.g. source-a 14h stale - Measured: exact command → duration (key output, e.g. Already up to date) - Budgeted: timeout constant any call-site override, file:line - Thresholds: monitor act-line Xh vs doctor warn-line Yh → match | MISMATCH - Verdict: false page on healthy system | needs more time | wedged | genuine regression - Fix: the change, justified by the measured number — or none; adjust the alert line这份模板的价值在于它强制排障者交代测量命令、测量结果、预算值与阈值口径任何一环缺失都意味着结论尚未成立。九、技能边界与去重Dedup为避免与其他技能职责重叠本技能划定了清晰的边界相邻技能职责与本技能的边界GStackinvestigate代码 bug 的系统化调试为什么坏了、500 错误、输出错误investigate根因定位代码行为本技能是时间类运维告警stale/timeout/freshness/wedged在动任何超时或阈值之前的测量门。若秒表确认了真实缓慢或回归带上实测数字移交给investigateskills/maintain/SKILL.md运行脑健康检查与修复doctor、extraction、dream cyclemaintain产出并作用于健康输出本技能规定当其中某项检查分页时、在改预算或包装脚本之前应如何响应smoke-test宿主机侧二进制重启后的健康检查与自动修复smoke-test 回答重启后是否存活本技能回答这条慢/陈旧断言是否为真skills/cron-scheduler/SKILL.md调度监控与任务cron-scheduler 决定监控何时运行本技能提供其阈值必须编码的 act-line 与 alert-line 规则skills/conventions/test-before-bulk.md批量写入前的试运行同一精神先证据后行动不同对象该约定门控批量写入本技能门控超时/阈值/管道变更此外技能的 frontmatter 中引用了 conventions/brain-first.md同名副本存在于 plugin-variants/gbrain-coding/skills/conventions/brain-first.md、plugin/skills/conventions/brain-first.md 与 plugin-variants/gbrain-daily/skills/conventions/brain-first.md在重新推导诊断之前先在脑中search同一告警的历史事件——重复出现的告警通常已有记录的结论。十、为什么这条纪律在 gbrain 上成立把技能与实现对照可以看到 gbrain 为测量优先提供了完整的基础设施权威阈值明确gbrain doctor的 freshness 检查把 warn/fail 线作为单一事实来源src/commands/doctor/checks/extraction-sync.ts并刻意设计为纯 SQL 陈旧性检查只读sources.last_sync_at不碰文件系统让阈值可以被可靠引用停滞 vs 缓慢的原生区分sync 的#1950与 embed 的#4599看门狗都以前进进度为键与技能needs more time 与 wedged 修复相反的告诫同构精确到源的测量入口gbrain sync --source id与gbrain sources status提供点名具体实体的测量能力告警输出的复制即修复doctor 的失败消息内嵌source.id让gbrain sync --source id与用户复制粘贴的内容精确对应src/commands/doctor/checks/extraction-sync.ts。综上measure-before-you-fix不是一条空泛的先测试再修复口号而是一套可执行的排障协议五步流程、阈值分离常量、结构化结论模板、明确的边界去重。当你的 cron 监控第 N 次对一条陈旧告警分页时请先拿出秒表而不是 diff。赞分享人工智能RAGAgent 记忆MCP 服务知识管理【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址https://gitcode.com/gh_mirrors/gb/gbrain点击查看免费下载相关推荐Claude Code Game Studios 快速上手用 49 个 AI Agent 构建完整的游戏开发工作室Claude Code Game Studios 快速上手用 49 个 AI Agent 构建完整的游戏开发工作室 本篇技术指南讲解 Claude Code人工智能RAGAgent 记忆MCP 服务知识管理gbrain-codingBrain-first 编码 Agent 技能包变体gbrain-coding全解析gbrain codingBrain first 编码 Agent 技能包变体gbrain coding全解析 gbrain coding 是 gbrai人工智能RAGAgent 记忆MCP 服务知识管理终极指南如何用QtScrcpy轻松实现Android设备投屏控制终极指南如何用QtScrcpy轻松实现Android设备投屏控制 QtScrcpy是一款免费开源的Android投屏控制软件让你在电脑上实时显示和操作And桌面应用音视频上一篇微信聊天记录导出教程三步导出 HTML、Word、CSV 永久保存下一篇5 步搭好 Sunshine你的免费自托管游戏串流服务器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
