用途:审查代码中的同步能力(sync),按检查清单排查常见缺陷,并按严重程度分组输出发现。开始前需阅读 .agents/skills/sync-guide/SKILL.md 获取完整同步概念参考,并阅读 src/index.ts 及其导入模块中的同步实现。
主要检查项:严重问题包括分页无法终止(hasMore 是否能最终变为 false)、游标不推进(nextState 是否在迭代间变化)、缺少首次运行处理(state 为 undefined 时的处理)、批次过大(建议约100条)、API 支持变更追踪时仍用 replace 模式、以及状态持久化理解错误(增量模式下游标不会在周期之间重置)。结构问题关注双模态正确性:增量同步是否混用单一游标策略、缺少回填到增量的切换、切换时缺少重叠窗口。警告项包括缺少一致性缓冲(游标应滞后当前时间10-60秒)、时间戳游标无平局打破(建议 (timestamp, id) 的 keyset 模式)、缺少删除处理、硬编码密钥、以及 fetch 缺少错误处理。
输出方式:对每个问题说明是什么(指出具体代码位置)、为何重要(生产环境后果)、以及修复方式(给出具体代码片段)。若无问题则如实说明,不编造问题。
限制:未提供该技能的具体运行命令、安装方式、依赖环境、收费或平台信息。