SuperAPI AI 工具集

ssot-check

写作与研究

查看项目

更新于 10-15 20:27

技能介绍

用途:文档密集型仓库常重复同一事实(如集数、订阅数、价格),一处更新后其他副本会漂移。ssot-check 找出这些副本,记录权威值所在位置,并在每次运行时比对。它与 /reconcile 互补:后者处理状态文件的多会话漂移,本技能处理跨文档的事实复制漂移。

主要能力:通过仓库根目录的 .ssot.yaml 清单,为每个事实指定一个 canonical 位置和若干 copies,模式为正则且恰好一个捕获组。支持 discover 模式(首次扫描、提出清单草案,需人工批准后才写入)与 check 模式(每次运行只读校验,输出 IN SYNC、DRIFTED、CANONICAL MOVED、STALE ENTRY、UNVERIFIED 等状态)。比较时去除空白与千位分隔符,副本末尾 + 可忽略;副本可声明 rounding(floor-10、floor-100、floor-1000、floor-1000-as-K)做确定性变换后精确比较。支持跨仓库副本,路径如 ../cot-sponsor-page/index.html。

使用方式:调用 /ssot-check;参数为 discover 或 check,否则自动检测 .ssot.yaml 是否存在。修复以 diff 形式提出,从不自动应用;被审计仓库不被修改。唯一写操作是 git fetch 于兄弟克隆,默认关闭,仅当用户在该会话明确要求实时远端比较时执行。

适用场景:首次运行或新增文档面(媒体包、落地页、定价页);提交涉及文档前;批量查找替换后确认无遗漏;仓库有“grep 同数字其他文件”规则却常被遗忘时。

限制:不适用于无重复事实的仓库、按文件合法不同的值(快照系列、目标值、历史记录)、以及工作文件的多会话状态漂移。无法只读确定值时报告 UNVERIFIED,不猜测、不抓取。跨仓库修复需在另一仓库单独提交。具体收费、平台与效果资料暂未提供。