idea-ingest

Idea Ingest 技能

归档规则： 在创建任何新页面之前，请先阅读 skills/_brain-filing-rules.md。

约定

本技能保证：

• 每条摄入的内容都有一个包含真实分析（而非仅仅摘要）的 brain 页面
• 作者始终被署名：通过现有 people/ 页面的反向链接（更新时间线），或在没有页面时直接在摄入页面中署名（**Author:** {Author}, {role}）。只有当作者通过知名度门槛（notability gate），并且除了这一条内容之外，你还掌握至少两条独立且持久的关于他的事实时，才会创建新的 people/ 页面，绝不创建占位页（stub）（skills/_brain-filing-rules.md §Notability Gate）
• 双向创建交叉链接（来源 ↔ 作者，来源 ↔ 被提及的实体）
• 通过 gbrain files upload-raw 保存原始来源以备溯源
• 每个事实都带有行内 [Source: ...] 引用
• 归档遵循主要主题规则（而非按格式划分）

返回值（当被其他技能或子 Agent 调用时）：

• page_path：被摄入内容的 brain 页面路径（例如 concepts/flywheel-effects）
• author_path：作者的 brain 页面路径（例如 people/alice-example），如果跳过了知名度门槛而改为行内署名，则为 null
• cross_links：所有已创建交叉链接的列表
• status：ingested | updated | fetch_failed

约定： 关于 Iron Law 反向链接，参见 skills/conventions/quality.md。

每一次提及拥有 brain 页面的人物或公司，都必须创建反向链接。 格式：- **YYYY-MM-DD** | Referenced in [page title](path) — brief context

阶段

1. 获取内容。 针对内容类型使用合适的工具（文章使用网页抓取，推文使用 API，文档使用 PDF 阅读器）。

2. 上传原始来源。 保存获取到的内容以备溯源：gbrain files upload-raw <file> --page <slug>

3. 识别作者——受知名度门槛约束。 首先在 brain 中搜索现有的作者页面。

   • 如果页面存在 → 用这篇新发表的内容更新时间线，然后双向创建交叉链接
   • 如果页面不存在 → 仅当作者通过知名度门槛（skills/_brain-filing-rules.md §Notability Gate、skills/conventions/quality.md），并且除这一条内容之外至少存在两条独立且持久的事实时，才创建页面。页面应基于补充信息创建为完整页面（而非占位页）。单条摄入内容不足以构成值得单独建页的实体。
   • 否则，在摄入页面中直接署名作者（**Author:** {Author}, {role}），并在回复中说明这一缺口。存疑时不要创建。缺失的页面日后可以再创建。

4. 保存到 brain。 按主要主题归档（阅读 skills/_brain-filing-rules.md）：

   • 关于某个人 → people/
   • 关于某家公司 → companies/
   • 可复用的框架 → concepts/
   • 原始数据转储 → sources/

5. 为用户做分析。 回复时给出将内容与 brain 已有知识相连接的分析。请思考：

   • 活跃项目——这与之相关吗？
   • 矛盾——它是否挑战了 brain 中已有的知识？
   • 关联——它是否涉及已知的人物或公司？
   • 不要只做摘要。告诉用户那些他们可能没有注意到的事情。

6. 同步。 运行 gbrain sync 以更新索引。

输出格式

# {Title} — {Author}

**Source:** {URL}
**Author:** {Author}, {role}
**Published:** {date}
**Ingested:** {date}

## Context
{Why this matters now, connected to brain knowledge}

## Summary
{3-5 bullet core arguments}

## Key Data / Claims
{Specific facts, numbers, quotes}

## Analysis
{How this connects to existing brain knowledge. What's new. What contradicts.}

边界情况

• 抓取失败（付费墙、404、超时）： 保存一个占位页面，记录 URL、元数据和失败原因。告知用户无法抓取内容，并询问其能否粘贴内容。
• URL 重复： 在摄入前，先在 brain 中搜索该 URL。若已存在，则更新现有页面，而不是新建。告知用户该内容已被摄入过。
• 无法识别作者： 归档到 sources/。跳过人物页面，但注明该信息缺失。
• 推文串与单条推文： 抓取整个推文串，将其视为一个整体。
• 视频/播客链接： 说明除非有文字稿，否则只能摄入元数据。向用户索要文字稿。
• 原始文件上传： 作为 Agent 操作时，使用 file_upload 工具（而非命令行的 gbrain files upload-raw）。

失败处理

对于任何 gbrain 错误 code、退出码、[AGENT] 块或提示块，均遵循 Agent 操作协议。本技能的具体情况如下：

• 抓取失败（付费墙、404、超时）：保存一个占位页面，记录 URL、元数据和失败原因（status: fetch_failed），并请用户粘贴内容。
• gbrain files upload-raw / file_upload 被拒绝（路径超出允许的根目录、载荷过大）：告知用户该限制，并提供链接或摘录作为替代。
• 写入页面时返回 write_pending（退出码 10）：在报告 ingested 之前，轮询 gbrain write-request <request_id>。

反模式

• 仅做摘要，而不与 brain 中的知识建立联系
• 把所有内容都归档到 sources/（sources 仅用于原始数据转储）
• 完全丢弃作者署名——既不在已有作者页面上添加反向链接，也不在摄入的页面中添加行内 **Author:** 行
• 创建未通过 skills/_brain-filing-rules.md 中的显著性门槛的 people/ 页面，或仅基于这一条内容构建的存根页面
• 未与提及的实体建立交叉链接
• 摄入前未先检查 brain 中是否已有相关内容
• 覆盖已有的 brain 页面，而不是将新内容合并进去
• 凭空编造与 brain 知识的联系——只引用通过搜索/查询验证过的联系
• 使用过于笼统的 slug，如 concepts/strategy——应具体明确，例如 concepts/flywheel-effects
• 未核实内容是否真正抓取成功，就假定抓取已成功