article-enrichment

article-enrichment — 从原始转储到有用的 Brain 页面

约定： 引用规则、逐字引文要求及反向链接执行规则，请参阅 conventions/quality.md。

约定： 归档规则请参阅 _brain-filing-rules.md。文章页面原始导入时存放在 media/articles/ 下；个性化的独创性综合输出则使用经批准的例外路径 media/articles/<slug>-personalized.md。

功能说明

将一个由大段原始提取文本组成的文章 brain 页面，改写为结构化页面，包含：

• 执行摘要（Executive Summary）：2-3 句话，概括唯一值得记住的要点
• 为何重要（Why It Matters）：关联用户的具体项目与兴趣（依据 brain 上下文读取，不做假设）
• 可引用语句（Quotable Lines）：3-5 条值得在文章中引用的逐字原文
• 关键洞见（Key Insights）：真正的洞见，而非主题标签
• 出人意料或反直觉之处（Surprising or Counterintuitive）：说明该内容的独特之处
• 延伸阅读（See Also）：指向相关 brain 页面的标准 Markdown 链接

原始源内容保存在可折叠的 <details> 区块中，确保原文永不丢失。

调用时机

• 新文章页面通过 media-ingest 进入 brain，且带有 needs_enrichment: true
• 现有文章页面在 ## Content 标题下只是一堵文字墙，没有任何综合内容
• 用户表示某个 brain 页面没用、无聊或只是堆砌资料
• LLM 评审的 brain 质量评估在文章页面的可引用性或可操作性上未通过

处理流程

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 article's 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).

调用方式

该 Skill 本身是面向 Agent 的 Markdown 指令，在 v0.25.1 中并不提供确定性的命令行命令。Agent 使用 gbrain 现有的操作：

# 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 agent's 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.

质量标准

增强后的页面需同时满足以下条件方可通过：

• ✅ 包含 ## Executive Summary（2-3 句）
• ✅ ## Quotable Lines 包含 ≥3 条逐字引文（字面引用，而非转述）
• ✅ ## Key Insights 包含 ≥3 条要点（是洞见，而非主题标签）
• ✅ ## Why It Matters 与具体的 brain 上下文相关联（而非泛泛而谈）
• ✅ ## See Also 使用标准 Markdown 链接（而非 [[wiki-links]]）
• ✅ <details> 区块保留原始源内容

模型选择

模型	适用场景	引文准确度
Sonnet（默认）	批量增强，大多数文章	良好，偶尔会转述
Opus	高价值内容、原创思考类文章、长篇文章	优秀，严格遵守"逐字"要求

规则：批量增强时，先用 Sonnet 生成草稿，并用 LLM 评审的 brain 质量评估抽查 5 篇。若引文被转述，则对该批次改用 Opus。

链接约定

所有交叉引用均使用标准 Markdown 链接：[Title](relative/path.md)。 切勿使用 [[wiki-links]]，它们在 GitHub 上无法渲染。

故障处理

对于任何 gbrain 错误 code、退出码、[AGENT] 区块或通知区块，请遵循 agent operator protocol。针对本 Skill 的具体情况：

• get_page 返回 page_not_found：原始转储可能已被移动或 slug 有误；在报告文章缺失之前，先按标题进行搜索。
• 改写时返回 revision_conflict：自你读取页面后，他人已对其进行编辑。请重新读取，将增强内容重新应用到新文本上，并以新的 revision 保存；切勿盲目覆盖。
• write_pending（退出码 10）：轮询 gbrain write-request <request_id>；只有在回执提交后，才能报告页面已完成增强。

反模式

• ❌ 转述引文（"作者认为……"）。引文要么是逐字原文，要么就不是引文。
• ❌ 泛泛的"为何重要"（"这很重要，因为创新……"）。要么与具体的 brain 上下文挂钩，要么删除该部分。
• ❌ 编造主题标签并将其当作洞见。洞见是文章中你此前并不知道的内容。
• ❌ 丢弃原始源内容。务必将其包裹在 <details> 中。
• ❌ 非幂等地重复增强：先检查 frontmatter 中的 needs_enrichment 标志；若已为 false 则跳过。

相关技能

• skills/media-ingest/SKILL.md — 创建本技能所丰富的原始文章页面
• skills/idea-ingest/SKILL.md — 链接/文章摄入，并强制执行作者人物页面规范
• skills/conventions/quality.md — 引用与反向链接规则

契约

本技能保证：

• 路由与 frontmatter 中的标准触发条件一致。
• 输出写入 writes_to: 中列出的目录下（如适用）。
• 遵循所引用的约定（quality.md、brain-first.md、_brain-filing-rules.md）。
• 保持隐私契约：不包含真实姓名、不包含分支特定的文件系统路径字面量、不包含上游分支引用。

完整的行为契约记录在上文各正文章节中；本节仅供一致性测试使用。

输出格式

本技能的输出结构已在上文正文章节中内联说明（参见“Output”“Brain page format”或同类章节）。此处的标题仅供一致性测试（test/skills-conformance.test.ts）使用。