SuperAPI AI 工具集

citation-fixer

通用与其它

查看项目

更新于 10-15 21:50

技能介绍

用途:审计并修复 brain 页面中的引用格式,确保每条事实都有符合标准格式的内联 [Source: ...] 引用。

主要能力:扫描页面并检查引用合规性;标记缺失引用的具体位置;将格式错误的引用改写为 conventions/quality.md 规定的标准格式;v0.25.1 起可通过 X API 解析无 URL 的推文引用,补全为 https://x.com/<handle>/status/<id> 形式的确定性链接;输出含扫描、修复、剩余数量的报告。

使用方式:可手动调用(如“fix citations on this page”),也可作为批量 cron 每周扫描,或被其他技能在提交前调用以校验输出。批量模式先找出提及推文但无 x.com 链接的页面,按最近更新、高流量页面优先处理,每批约 50 页,每页 1-3 次 API 调用,每 10-20 页提交一次。推文解析流程为:识别无 URL 的推文引用、提取 handle/引文/日期、通过宿主配置的 X API 集成搜索、验证并提取元数据、构造 URL 后修补页面。

限制与注意:不得为无来源事实编造引用,应标记而非删除;不得猜测推文 id 构造 URL,必须经 X API 生成确定性链接;修复前需阅读完整页面上下文,批量前先抽样检查质量;需遵守 X API 速率限制。遇到 revision_conflict 应重读页面后仅重新应用引用修复;page_not_found 的引用标记为不可解析;批量提交中断则从最后已提交页继续。状态可记录于 ~/.gbrain/citation-fixer-state.json。