Citation Fixer

• 你的大脑页面正在积累带有缺失或格式不一致的 [Source: ...] 引用的事实，你希望进行系统性审查而非手动检查。
• 你有一些页面引用了推文、X 帖子或转发，通过引用文本或提及互动数据来呈现，但没有真实的 x.com URL —— Citation Fixer 可以通过宿主的 X API 集成自动查找并补全这些链接。
• 你希望设置每周定期扫描（cron 模式），以便在 enrich 或 media-ingest 等其他技能添加内容时，及时发现新的引用缺口。
• 另一个技能需要在提交前验证自身输出 —— Citation Fixer 可以以编程方式作为预提交检查被调用。

• 您的大脑没有设置引用规范——该技能会将引用与 conventions/quality.md 进行匹配，因此如果没有该标准，修复操作就没有目标格式可以应用。
• 您需要解析推文引用，但主机未配置 X/Twitter API 集成——推文解析流程完全依赖于主机端的配方，不会自行生成 URL。
• 您正在寻找一种能够删除或自动清除未引用事实的技能——Citation Fixer 会标记缺口，但从不删除内容。

列出并读取每一个脑页面，检查每个页面中的行内 [Source: ...] 引用。生成结构化摘要报告：已扫描页面数、已找到引用数、已修复问题数以及仍存在的缺口。

重写缺少日期、缺少来源类型或不符合 conventions/quality.md 中定义格式的引用。仅修复格式——绝不凭空捏造不存在的来源。

检测损坏的推文引用——引用文本、互动数据，或缺少 x.com/status/ URL 的 [Source: X/Twitter ...] 条目——然后通过宿主的 X API 集成搜索真实推文。自动补全确定性的 https://x.com/<handle>/status/<tweet_id> 链接，并附带经过验证的互动元数据。

所有 URL 均由 X API 返回的数据构建而成；该技能从不猜测或自行拼凑推文 ID。这一规则作为强制性输出约束执行，以防止幻觉链接进入知识库。

每次批量运行目标处理约 50 个页面，每处理 10–20 个页面提交一次，以避免因部分失败而丢失进度，同时遵守宿主的 X API 层级限制。优先级顺序：最近更新的页面优先，其次是高流量页面，最后是批量清理。

当作为周期性批处理运行时，Citation Fixer 会将进度存储在 ~/.gbrain/citation-fixer-state.json 中，跨多次运行持续追踪已扫描的页面、已修复的引用、已解析的推文链接以及无法解析的缺口。

按定时计划运行 Citation Fixer，以捕捉由其他技能或手动编辑引入的新引用缺口。审计报告会清晰地统计剩余未引用事实的数量，确保问题不会悄然积累。

如果您的知识库是通过社交媒体摘要或媒体采集方式构建的，许多页面可能引用了推文但缺少真实的 URL。Citation Fixer 的批处理模式可自动识别候选页面，并通过 X API 为其补全经过验证的 x.com 链接。

enrich 或 media-ingest 等技能可以在将页面写入知识库之前调用 Citation Fixer，从而确保每个新页面在提交之前都符合引用规范。

通过手动触发"修复此页面上的引用"，对某一特定页面进行审核和修复，而无需运行完整的全库扫描——在审查或发布高曝光条目时尤为实用。