人工智能RAGAgent 记忆MCP 服务知识管理【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址https://gitcode.com/gh_mirrors/gb/gbrain点击查看免费下载本文是 gbrain 开源仓库中 Reports 技能 的完整技术指南。Reports Skill 是 gbrain 大脑中负责「保存与加载带时间戳报告」的标准化技能cron 任务把输出落盘为报告Agent 与用户通过关键词快速检索同时它内置了Actionability Gate可执行性门禁——在晨间简报、会议纪要、研究报告等任何报告交付给用户之前对报告里的每一条链接执行 Broken / Dead / Indirect / Missing 四类失败模式检查确保用户点击即可行动。读完本文你将掌握报告文件的落盘规范、关键词路由配置方法以及一套可粘贴进任意报告生成 prompt 的链接质检规则与 Agent 自检重试循环。Reports Skill 是什么一份技能契约Reports Skill 位于 plugin/skills/reports/SKILL.md其 frontmatter 定义如下--- name: reports version: 1.1.0 description: | Save and load timestamped reports. Keyword routing for fast lookup. Cron jobs save output as reports; the agent or user queries them by keyword. Includes the Actionability Gate: delivery-time link checks (Broken/Dead/Indirect/ Missing) for briefings, meeting digests, and research reports. triggers: - save report - load latest report - whats the latest briefing - show me the pulse - report quality - link quality check - validate report links tools: - get_page - put_page - search mutating: true upstream: report-quality-gatefc834ee ---几个值得注意的元信息触发词triggerstriggers数组是技能路由的权威信号harness 会拿入站消息与它匹配见 skills/RESOLVER.md 中Routing contract的说明。save reportload latest reportwhats the latest briefingshow me the pulse 等短语都会把请求路由到本技能而 report qualitylink quality checkvalidate report links 则明确指向 Actionability Gate 的链接质检场景。工具集toolsget_page、put_page、search对应 gbrain 的页面读写与检索能力——这正是报告可存取、可搜索的技术底座。mutating: true与只读的 Briefing 技能mutating: false不同Reports Skill 会写入大脑页面保存报告文件因此标记为会产生变更。upstreamreport-quality-gatefc834ee表明 Actionability Gate 合并自上游 report-quality-gate 提交便于溯源。该技能对外保证的**契约Contract**共五条报告以带时间戳的文件名 frontmatter保存关键词路由查询 → 报告类别映射按类别名可加载最新报告报告可被 gbrain 的 search/query检索到对外交付的报告在送达前必须通过Actionability Gate。报告保存与加载时间戳文件 frontmatter 规范Phase 1保存报告Save report报告统一写入reports/{category}/{YYYY-MM-DD-HHMM}.md文件名由日期与小时分钟构成天然支持按时间找最新的排序。文件头必须携带标准 frontmatter--- title: {report title} type: report category: {category name} date: {YYYY-MM-DD} time: {HH:MM PT} ---字段含义字段含义说明title报告标题应简洁可扫描参考 skills/_output-rules.md 的 Title Quality 规范少于 60 字符、不是完整句子type固定为report类型标记供 gbrain 按类型检索过滤category报告类别名与reports/{category}/目录名一致是关键词路由的目标键date报告日期YYYY-MM-DD供按日期检索time生成时刻HH:MM PT采用太平洋时间PT用于区分同一天内的多份报告为什么 frontmatter 如此重要技能的反模式清单第一条就是保存报告时不带 frontmatter会导致报告无法被检索。gbrain 的搜索能力依赖页面元数据缺失 frontmatter 的报告文件在检索中是不可见的。Phase 2加载最新报告Load latest给定一个类别名找出该类别下时间戳最新的报告文件并读取完整内容。输出格式约定为保存reports/{category}/{YYYY-MM-DD-HHMM}.md加载完整报告内容 元数据frontmatter 中的 title/category/date/time反模式中与之对应的提醒是只加载最新一份即可不要一次性加载全部报告——按需读取而非全量扫描既省 token 又避免混淆新旧信息。与 Cron Scheduler 的联动定时任务的报告落盘Reports Skill 的定位与 Cron Scheduler 技能 形成闭环。cron-scheduler 的契约中明确写着Results saved as reports:reports/{job-name}/{YYYY-MM-DD-HHMM}.md即定时任务如每日晨间简报、每周社交提及汇总运行完毕后输出自动落盘为 Reports 格式的报告文件随后用户只需说一句 load latest report 或 whats the latest briefingReports Skill 就能按类别取回最新一份。这解释了 reports 技能触发词中 show me the pulse查看大脑脉搏这类短语的来源——定时任务与按需取用的组合构成了大脑的周期性报告流水线。关键词路由query → category 映射Reports Skill 默认提供一组查询短语到报告类别的映射避免用户必须记住确切的类别名用户查询报告类别email / inboxea-inbox-sweepsocial / mentionssocial-mentionsbriefing / morningmorning-briefingmeetingmeeting-sync自定义映射可配置你可以按自己的报告体系扩展映射表让更多自然语言查询命中对应类别。路由的意义在于用户不用记住类别名——反模式清单里不按关键词路由强制用户使用确切类别名正与此对应。这套查询意图 → 技能/类别的匹配思想在仓库中还有一处独立验证skills/reports/routing-eval.jsonl同时在 plugin 侧 有一份记录了 Actionability Gate 合并后新增的路由评测用例例如{intent:Run a link quality check on this morning briefing before it goes out,expected_skill:reports,ambiguous_with:[briefing]} {intent:Validate report links in the meeting digest — no profile links standing in for posts,expected_skill:reports} {intent:Fix broken citations on this brain page,expected_skill:citation-fixer} {intent:File my quarterly expense report with the accounting team,expected_skill:null}从中可以读出两层信息歧义消解ambiguous_with: [briefing]表明对晨间简报做链接质检同时匹配 briefing 与 reports 两个技能路由评测显式记录这种边界配合 skills/RESOLVER.md 的消歧规则优先最具体技能、必要时链式调用解决职责边界修复脑内页面引用的请求路由到citation-fixer而报告交付时的链接质检才归reports——两者分工明确给财务部提交季度报销单这类会计杂务则期望null不路由到本技能因为它不是大脑生成的报告。Actionability Gate交付前链接质量门禁这是 Reports Skill 的核心机制。在任何报告送达用户之前——无论是晨间简报、会议纪要还是研究报告——每一条链接都必须回答一个问题用户能否点击它并立即行动can the user click this and immediately act?链接的规范基础来自 skills/_output-rules.md 的Deterministic Links确定性链接章节所有链接必须由真实数据构建slug、commit hash、API 响应禁止 LLM 猜测或拼凑 URL脑内页面链接用相对 markdown 链接page title聊天交付中的链接用可验证的绝对链接。Actionability Gate 在这个确定性链接规范之上补充了交付时刻的失败分类学与重试循环。四种失败模式Four failure modes模式含义示例Broken破损链接是假的或占位符https://example.com、TODO-find-linkDead失效指向一个未提交/未推送的脑内页面页面写好了但没推送——链接 404Indirect间接链接能打开但指向的不是正确位置x.com/alice-example主页代替x.com/alice-example/status/id具体帖子Missing缺失提到了可执行项但完全没有链接一个在流传的片段约 80 万播放却没有给出 URL判定原则的核心一句Broken、Dead、Indirect 会阻断交付block。Missing 只是警告warning——标记它但不要阻断。缺失的链接是诚实的行为间接的链接才是违背承诺。这条原则区分了错误与遗憾承认自己没找到链接是可信的而拿一个似是而非的链接糊弄用户是失职。Blocked阻断vs Warning警告判定表模式状态失败原因x.com/handle阻断主页 ≠ 帖子。应链到x.com/handle/status/id裸的出版物域名阻断首页 ≠ 文章。需补上文章路径youtube.com/channel阻断频道 ≠ 视频。应链到youtube.com/watch?v...脑内页面链接、文件未提交阻断未提交推送前链接一直 404example.com/TODO占位符阻断不是真实链接google.com/search?q...警告搜索结果 ≠ 来源。应链到实际结果页可执行条目无 URL警告指向哪里补上链接或说明如何找到它规律很清晰一切拿主页/频道/档案页代替具体内容的链接一律阻断——它指向的 URL 与其声称的内容不符而有行动项但没贴链接只警告因为它至少没有误导用户。重试循环Retry loopAgent 自行执行需要特别说明仓库没有为这道门禁提供强制执行的脚本它是 Agent 在交付任何带链接的报告前自行运行的检查流程。共 5 步撰写报告。逐条对照失败模式扫描所有链接脑内页面链接在 brain 仓库里运行git status——链接背后的页面未提交即 Dead 链接需先 commit push用gbrain get slug确认页面确实存在。外部链接用主页/首页/频道 URL 代替具体内容即 Indirect。检查失败则修复链接手上有直接 URL帖子 ID、文章路径、归档页直接用没有回到来源搜索具体条目找不到删掉链接、改用文字描述内容片段在 alice-example 的时间线上约 80 万播放——去那边搜。绝不允许用主页链接充当内容链接。复查。最多重试 2 次若仍有 Missing 类警告则带着明确警告标记交付Broken、Dead、Indirect 三类链接永不对外发出。这套循环与 brain-link-discipline 技能 的push BEFORE link纪律同源brain-link-discipline 规定任何提到脑内页面的对外消息链接必须机械地从 git 数据推导git ls-files --full-name、git remote get-url origin、先推送再链入、并对托管远程做存在性校验Reports 的 Actionability Gate 则把这条纪律固化为报告交付前的标准检查项。两者的 Dedup 边界在 brain-link-discipline 文档中写得很清楚reports 技能负责保存/加载报告页面当报告交付消息引用脑内页面时该消息遵循 link-disciplinereports 技能本身不携带链接规则。LLM-prompt 门禁片段可直接粘贴复用Actionability Gate 设计成一段可移植的 prompt 片段可粘贴进任何报告生成 prompt——子代理摘要、研究总结、cron 报告任务均适用ACTIONABILITY GATE: Before finishing, verify every link answers can the user click this and act immediately? - Every X link → https://x.com/{user}/status/{post_id} — NEVER a profile link - Every article → full URL with path — NEVER a bare domain - Every brain-page link → committed pushed, or dont link it - If you dont have the direct URL → describe the content WITHOUT a link - A missing link is better than an indirect link这五条正是上文四种失败模式的可执行压缩版X 链接必须落到帖子、文章必须带完整路径、脑内链接必须先推送、没有直接 URL 就纯文字描述、缺失优于间接。Consumers哪些报告面会经过这道门Actionability Gate 的覆盖面由harness-routing 约定resolver 应用的路由规则而非机械保证决定包括晨间简报morning briefing对应 Briefing 技能其输出格式中包含会议链接、deal 页面、人员页面等大量引用是链接质检的最主要消费方会议纪要meeting digests涉及参与者页面、议题时间线等链接研究报告research reports外部来源链接密集最容易出现主页/频道冒充内容链接任何携带外部链接的已保存报告。实践中这意味着当用户说 validate report links 或 run a link quality check on this morning briefingresolver 会路由到 reports 技能执行门禁而 Briefing 技能本身负责生成简报内容——两者按 skills/RESOLVER.md 的约定衔接必要时链式调用。反模式清单Anti-Patterns技能明确列出以下行为为反模式供 Agent 自查、也供读者理解设计意图不带 frontmatter 保存报告——导致报告无法被检索跨次运行使用不一致的类别名——破坏关键词路由与目录组织只需要最新报告时加载全部报告——浪费检索与上下文不按关键词路由强迫用户输入确切类别名——违背设计初衷用主页/首页/频道链接充当具体内容链接交付报告Indirect 链接阻断交付——这是最常见的交付事故链接了未提交未推送的脑内页面Dead 链接——链接必然 404。实战总结一条完整报告流水线把本文内容串起来一条符合 Reports Skill 规范的完整流水线是定时任务产出cron-scheduler 将任务输出落盘为reports/{job-name}/{YYYY-MM-DD-HHMM}.md见 plugin/skills/cron-scheduler/SKILL.md交付前质检Agent 对该报告运行 Actionability Gate——逐链接对照四种失败模式脑内链接先git statusgit push再用gbrain get slug确认外部链接确认指向具体内容而非主页/频道Missing 类警告标记但不阻断Broken/Dead/Indirect 一律修复或删除检索复用用户通过 email、briefing、meeting 等关键词路由到对应类别按需加载最新报告报告本身可被 gbrain search/query 全文检索持续改进路由边界由 skills/reports/routing-eval.jsonl 评测用例守护避免 链接质检 与 引用修复 等相邻技能职责混淆。这套机制的核心理念可以浓缩为一句报告的价值在于用户能否基于它立即行动而链接是行动的第一步——宁缺毋滥绝不拿一个能打开却指向错误位置的链接冒充有效链接。赞分享人工智能RAGAgent 记忆MCP 服务知识管理【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址https://gitcode.com/gh_mirrors/gb/gbrain点击查看免费下载相关推荐免费AI视频放大神器3步将模糊视频升级到4K超清画质免费AI视频放大神器3步将模糊视频升级到4K超清画质 你是否曾为手机拍摄的视频画质模糊而烦恼是否想将珍藏的家庭录像从低分辨率变成高清画质Video2X正是人工智能RAGAgent 记忆MCP 服务知识管理Telegram中文群组安全指南Jqs7Bot教你避免广告骚扰与恶意链接Telegram中文群组安全指南Jqs7Bot教你避免广告骚扰与恶意链接 在Telegram中文群组中畅游时你是否曾遭遇过广告轰炸、恶意链接或不明身份的用户终极音频切片工具5分钟掌握时间戳提取与智能分割技术终极音频切片工具5分钟掌握时间戳提取与智能分割技术 音频切片和时间戳提取技术是音频处理领域的重要工具能够自动识别音频中的静音部分并进行智能分割。audio音频处理桌面应用上一篇Source SDK 2013网络协议压缩减少数据包大小下一篇Awesome-Dify-WorkflowCharts图表渲染技术创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考