用途
idea-ingest 是 gbrain 知识库体系中的一个采集技能，目标是把外部的链接、文章、推文和想法「摄入」到大脑知识库中。它不是简单的收藏或摘要工具，而是要求对每条内容进行真实分析，并与知识库中已有信息建立关联。
主要能力
该技能承诺保证以下结果：
- 每个被摄入的条目都会生成一个大脑页面，且包含真实分析，而不仅仅是摘要。
- 作者始终会被署名：要么从已有的 people/ 页面反向链接（更新时间线），要么在摄入页面上以内联形式标注（Author: {Author}, {role}）。只有当作者通过「知名度门槛」（notability gate）且除本条内容外至少还有两条独立、持久的事实时，才会新建 people/ 页面，绝不创建占位页。
- 创建双向交叉链接（来源 ↔ 作者，来源 ↔ 被提及的实体）。
- 通过
gbrain files upload-raw保留原始来源以便溯源。 - 每条事实都带有内联的 [Source: ...] 引用。
- 归档遵循「主要主题」规则，而非基于格式。
当被其他技能或子代理调用时，它会返回：page_path（摄入条目的大脑页面路径）、author_path（作者的大脑页面路径，若跳过知名度门槛并改为内联署名则为 null）、cross_links（创建的所有交叉链接列表）、status（ingested | updated | fetch_failed）。
使用方式
技能按以下阶段执行：
- 抓取内容：根据内容类型使用合适工具（文章用网页抓取、推文用 API、文档用 PDF 阅读器）。
- 上传原始来源：保存抓取内容以便溯源，命令为
gbrain files upload-raw <file> --page <slug>。 - 识别作者（受知名度门槛约束）：先在知识库中搜索已有作者页面。若存在，则用本次新发布更新时间线，并建立双向交叉链接；若不存在，则仅当作者通过知名度门槛且除本条外至少还有两条独立持久事实时才创建完整页面（非占位页），否则在摄入页面上内联署名并说明缺口。存疑时不创建，缺失页面可日后补建。
- 保存到大脑：按主要主题归档——关于人 → people/；关于公司 → companies/；可复用框架 → concepts/；原始数据转储 → sources/。
- 为用户分析：回复分析内容，将内容与大脑已知信息连接，思考是否与活跃项目相关、是否与现有知识矛盾、是否涉及已知的人或公司。不要只做摘要，要告诉用户他们可能没注意到的东西。
- 同步：运行
gbrain sync更新索引。
输出格式包含标题与作者、来源 URL、作者与角色、发布日期、摄入日期，以及 Context、Summary、Key Data / Claims、Analysis 等分段。
适用场景
适合需要将外部信息沉淀为可检索、可关联知识资产的个人或团队，尤其是希望每条内容都经过分析并与已有知识网络建立联系、且重视来源溯源与作者署名的知识管理流程。
限制与边界情况
- 抓取失败（付费墙、404、超时）：保存带 URL、元数据和失败原因的占位页（status: fetch_failed），并请用户粘贴内容。
- 重复 URL：摄入前先搜索知识库，若已存在则更新现有页面而非新建，并告知用户已摄入过。
- 无法识别作者：使用 sources/ 归档，跳过 people 页面但记录缺口。
- 推文串与单条推文：抓取整个推文串，将其视为一个单元。
- 视频/播客链接：除非有转录文本，否则只能摄入元数据，需向用户索取转录。
- 原始上传：作为代理运行时使用 file_upload 工具，而非 CLI 的
gbrain files upload-raw。 - 写入失败：页面写入出现 write_pending（exit 10）时，需轮询
gbrain write-request <request_id>后再报告已摄入。 - 上传被拒（路径超出允许根目录、负载过大）：告知用户限制，并提供链接或摘录替代。
反模式
技能明确列出应避免的做法：只摘要而不连接大脑知识；把所有内容都归入 sources/（sources 仅用于原始数据转储）；完全丢弃作者署名；创建未通过知名度门槛或仅由本条内容构成的占位 people/ 页面；不交叉链接被提及实体；摄入前不检查已有覆盖；覆盖现有页面而非合并新内容；臆造与大脑知识的连接（只引用经搜索/查询验证的连接）；创建 concepts/strategy 这类泛化 slug（应具体如 concepts/flywheel-effects）；未验证内容确实抓取成功就假定成功。