GBrain article-enrichment 技能解析：把文章原始转储变成可引用、可行动的大脑页面

GBrain article-enrichment 技能解析把文章原始转储变成可引用、可行动的大脑页面【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain本篇技术指南围绕 gbrain 技能体系中的article-enrichment文章富化技能展开它解决的是「大脑里躺着一整面未经加工的原文转储墙」这一经典问题把media/articles/下的原始文章页面重写为包含执行摘要、逐字引用、关键洞察、为何重要与交叉引用的结构化页面。读完本文你将掌握该技能的定义、触发路由、六步流水线、质量标准与模型选型策略并能用gbrain query/gbrain get/put_page等既有操作完整跑一遍富化流程。技能定位从原始转储到有用的大脑页面在 gbrain 的知识管理流程中文章类内容最初经由media-ingest等摄入技能落地为「原文转储」形态的页面带needs_enrichment: true标记。article-enrichment技能的作用就是把这些「墙式文本」walls of text重写为结构化、可引用、可行动的大脑页面。依据 skills/article-enrichment/SKILL.md 的定义富化后的页面必须包含以下六个结构化要素Executive Summary执行摘要——23 句话提炼「唯一值得记住的那件事」Why It Matters为何重要——必须连接到用户的具体项目与兴趣从大脑上下文读取而非凭空假设Quotable Lines可引用金句——35 条**逐字VERBATIM**引用供日后写文章时直接引用Key Insights关键洞察——真正的洞见而不是话题标签Surprising or Counterintuitive反直觉之处——让该内容与众不同的部分See Also参见——指向相关大脑页面的标准 Markdown 链接。同时原始源内容必须保留在一个可折叠的details区块中确保原文永不丢失。Frontmatter 与路由契约该技能的 frontmatter 声明了其行为边界与触发方式见 skills/article-enrichment/SKILL.md--- name: article-enrichment version: 0.1.0 description: Transform raw article text dumps in the brain into structured pages with executive summary, verbatim quotes, key insights, why-it-matters, and cross-references. triggers: - enrich this article - enrich the article - enriching the article - enrich brain pages - batch enrich - enrich pass - make brain pages useful mutating: true writes_pages: true writes_to: - media/articles/ ---几个关键字段的含义可以从 gbrain 的技能路由机制中进一步确认triggers:是权威路由信号。按 skills/_AGENT_README.md 的约定Agent 在每次收到用户消息时会把消息与每个技能的triggers:数组做子串匹配命中即读取该 SKILL.md 全文并遵循其中的工作流执行skills/RESOLVER.md 则是同一路由的人类可读调度图该技能在「Uncategorized」区段登记了enrich this article、enrich brain pages、batch enrich、make brain pages useful等触发短语。若两者不一致以 frontmatter 为准。mutating: true与writes_pages: true表示该技能会修改大脑页面writes_to: [media/articles/]声明其写入面与_brain-filing-rules.md的归档约定配合使用见下文「归档规则」。技能本身是给 Agent 的 Markdown 指令不附带确定性 CLI 命令文档明确说明 v0.25.1 中不含 CLI富化动作由 Agent 借助 gbrain 既有操作完成。此外该技能附带路由评估夹具 skills/article-enrichment/routing-eval.jsonl覆盖了「这是一面原文墙请用金句与洞察富化这篇文章」「批量富化大脑中无结构的文章」「富化有原文但无执行摘要的页面」等 5 条意图用于验证触发路由夹具同时注明它与父级enrich技能会自然协同触发技能本就可链式调用。何时调用四个典型触发场景根据 SKILL.md 的「When to invoke」章节以下场景应调用本技能新文章页面经由 media-ingest 落入大脑且带有needs_enrichment: true标记已有文章页面是## Content标题下的一整面文本墙没有任何综合提炼用户抱怨某个大脑页面没用、无聊或就是一堆转储LLM 判官LLM-judge脑质量评估在某篇文章页面的可引用性quotability或可行动性actionability维度上判为不通过。这里需要说明的是needs_enrichment标记的含义它是摄入阶段写入 frontmatter 的状态旗标富化完成后必须清除。SKILL.md 反模式清单中明确要求「检查 frontmatter 中的needs_enrichment旗标若已为false则跳过」以保证富化操作是幂等的。六步流水线从读取到交叉引用SKILL.md 给出了完整的处理流水线1. READ → Open the article brain page; parse frontmatter body. 2. SCAN → Look for ## Content (raw dump) and absence of ## Executive Summary. 3. CONTEXT → gbrain query the articles key entities to ground Why It Matters. 4. ENRICH → Sonnet (default) or Opus (for high-value content) restructures. 5. WRITE → Replace ## Content with the structured sections; preserve raw source in details; clear needs_enrichment in frontmatter. 6. CROSS-LINK→ Add back-links from referenced people/companies pages (Iron Law per conventions/quality.md).六步逐一拆解READ打开文章大脑页面解析 frontmatter 与正文。页面以media/articles/slug形式定位slug 遵循小写字母、数字、连字符的命名规范见 skills/_brain-filing-rules.md。SCAN判断是否满足富化条件——存在## Content原始转储、且缺少## Executive Summary。CONTEXT用gbrain query检索文章的关键实体为「Why It Matters」提供大脑上下文的锚点——这一步决定了「为何重要」是具体连接而非空泛套话。ENRICH由 Agent 的 LLM 完成重构默认 Sonnet高价值内容用 Opus详见下文模型选择。WRITE用结构化小节替换## Content原文保留在details中并清除 frontmatter 中的needs_enrichment。CROSS-LINK依据 skills/conventions/quality.md 的 Iron Law为文中提到的每个人物/公司页面添加反向链接。实际操作用 gbrain 既有命令跑富化该技能本身不提供确定性 CLIAgent 通过 gbrain 的既有操作完成整个流程。SKILL.md 给出了可直接复制的命令序列# 1. Find candidate pages gbrain query needs_enrichment: true type:article --limit 50 # 2. For each candidate, read the page gbrain get media/articles/slug # 3. Enrich via the agents LLM (Sonnet by default; Opus for high-value) # The agent reads the raw content brain context writes the structured page. # 4. Write the enriched page # Use the put_page operation with the new structured markdown body. # 5. Cross-link entities # For every person/company mentioned, add a timeline back-link.操作要点说明候选发现gbrain query needs_enrichment: true type:article --limit 50用 frontmatter 字段过滤出待富化页面--limit 50控制批量规模页面读取gbrain get media/articles/slug读取指定 slug 的文章页页面写入通过put_page操作写入新的结构化 Markdown 正文实体回链对文中提到的每个人物/公司在其页面追加时间线反向链接见下文 Iron Law。质量标准通过检查清单一个富化合格的页面必须同时满足以下条件SKILL.md「Quality bar」章节✅## Executive Summary23 句话✅## Quotable Lines含 ≥3 条逐字引用字面引用不允许改写转述✅## Key Insights含 ≥3 条 bullet是真洞察不是话题标签✅## Why It Matters连接到具体的大脑上下文非空泛套话✅## See Also使用标准 Markdown 链接禁止[[wiki-links]]✅details区块完整保留原始源内容这些标准与 skills/conventions/quality.md 的强制引用规则是一脉相承的写入大脑页面的每个事实都必须携带行内[Source: ...]引用并按「用户直接陈述 大脑综合认知 时间线原始证据 外部来源」的优先级排序来源冲突时要并列注明两个引用不得静默二选一。模型选择Sonnet 与 Opus 的分工SKILL.md 给出了明确的模型选择表模型使用时机引用准确性Sonnet默认批量富化、大多数文章良好——偶尔会转述Opus高价值内容、原创思考类长文优秀——严格遵守「逐字」指令配套规则批量富化时先用 Sonnet 出一版草稿再抽 5 篇交给 LLM 判官脑质量评估做抽查若发现引用被转述paraphrase该批次改用 Opus。这条「先 Sonnet 批量、以判官抽查决定是否升级 Opus」的策略在引用保真度与成本之间做了务实取舍。链接约定与反向链接 Iron Law所有交叉引用一律使用标准 Markdown 链接Title严禁使用[[wiki-links]]——后者在 GitHub 上无法渲染。反向链接方面skills/conventions/quality.md 规定了强制性的 Iron Law每个提到某人/某公司大脑页面的页面必须在其实体页面上建立反向链接- **YYYY-MM-DD** | Referenced in page title -- context格式。未被链接的提及就是「坏掉的大脑」图结构本身就是智能所在。富化流程的第 6 步CROSS-LINK正是对这一规则的落地执行。归档规则媒体文章的存放位置依据 skills/_brain-filing-rules.md 的强制归档规则页面位置由主要主题决定而不是格式、来源或运行中的技能。「文章页面放在media/articles/下做原始摄入」正是该规则与 sanctioned exception许可例外结合的结果原始摄入文章原文转储放在media/articles/目录即本技能writes_to:声明的写入面个性化综合输出针对单一来源、单一读者的「一对一」综合产物如长文个性化阅读使用media/articles/slug-personalized.md这一许可例外路径。需要强调的反模式是为原始摄入而使用media/format/前缀路径属于误归档例如把所有视频丢进media/videos/该例外只适用于 sui generis 的合成输出。反模式清单哪些做法必须避免SKILL.md 明确列出了五类反模式写作与执行时都应规避❌转述引用如「作者认为……」——引用必须是逐字的否则就不是引用❌空泛的「Why It Matters」如「这很重要因为创新」——必须连接到具体的大脑上下文否则删除该小节❌把编造的话题标签当作洞察——洞察是文章里那些「你原本不知道」的内容❌丢弃原始源内容——永远用details包裹保留❌非幂等地重复富化——先检查 frontmatter 的needs_enrichment旗标已为false就跳过。生态协同与上下游技能的关系本技能不是孤岛它与以下技能构成完整链路skills/media-ingest/SKILL.md——上游摄入技能负责创建本技能要富化的原始文章页面其 Phase 4 明确提到「create/enrich if needed (delegate to enrich skill)」即实体富化可委托给 enrich 类技能媒体页面模板包含## Summary、## Key Segments / Highlights、## People Mentioned、## Companies Mentioned等小节skills/idea-ingest/SKILL.md——链接/文章摄入带作者人物页强制约束skills/conventions/quality.md——引用 反向链接规则skills/_brain-filing-rules.md——归档规则与media/articles/slug-personalized.md例外skills/RESOLVER.md 与 skills/_AGENT_README.md——路由与执行契约。契约保障与一致性该技能在「Contract」章节承诺路由与 frontmatter 中的规范触发短语一致输出写入writes_to:声明的目录遵循所引用的各项约定quality.md、brain-first.md、_brain-filing-rules.md并保留隐私契约——不写真实姓名、不写 fork 专属的文件系统路径字面量、不引用上游 fork。其输出格式约定以「Output Format」节在行内文档化供一致性测试test/skills-conformance.test.ts校验。这些约束确保富化产物在结构上可被机器校验、在内容上符合大脑全局的质量与隐私标准。综上article-enrichment是 gbrain「摄入—富化—引用」知识流水线的关键一环它以明确的触发词路由、六步流水线、可机器校验的质量清单和「逐字引用优先」的模型选型策略把静态的原文转储转化为可引用、可行动、相互链接的知识节点。无论你是要批量清理积压的原始文章页还是让某篇高价值长文真正「有用」都可以按本文的流水线与质量门禁直接落地执行。【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考