用途:审计并修复 brain 页面中的引用格式,确保每条事实都有符合标准格式的内联 [Source: ...] 引用。
主要能力:扫描页面查找引用合规性;标记缺少引用的具体位置;将格式错误的引用改写为 conventions/quality.md 规定的标准格式;报告扫描、修复与剩余缺口数量。v0.25.1 起可处理无 URL 的推文/帖子引用,通过宿主的 X API 集成解析并补上确定性的 https://x.com/<handle>/status/<id> 链接。
工作阶段:扫描页面并读取检查引用;识别问题(无引用、缺日期、缺来源类型、格式错误、无 x.com URL 的推文引用);修复格式;解析推文引用;输出审计报告。推文解析流程为识别损坏引用、提取句柄/引文/大致日期、用 from:<handle> "<引文片段>" 等模式搜索、验证并提取元数据、补丁页面。
使用方式:可手动调用(“fix citations on this page”)、作为批量定时任务每周扫描,或由其他技能在提交前调用验证。批量模式示例: for f in $(find . -name ".md" -not -path "./node_modules/"); do refs=$(grep -ci "tweet|posted|x post|RT|retweet|said on X" "$f") links=$(grep -c "x.com/.*/status/" "$f") if [ "$refs" -gt 2 ] && [ "$links" -eq 0 ]; then echo "$f" fi done
适用场景:维护含大量事实引用的知识库页面,需要统一引用格式或补全推文链接时。
限制与反模式:不得为无来源事实编造引用,应标记而非删除;不得在未读全文的情况下修复;批量修复前应先抽样检查质量。推文 URL 必须经 X API 生成,禁止猜测推文 id。需遵守宿主 X API 速率限制,建议每批约 50 页、每页 1-3 次 API 调用、每 10-20 页提交一次。其他细节(如具体定价、平台支持)暂未提供。