用途：帮助排查 Notion 同步（sync）任务失败或产生错误结果的原因，按系统化步骤定位问题并给出修复建议。
主要能力与用法：先用 ntn workers sync status 查看同步状态、上次运行时间和下次计划运行，识别卡住、失败或长期未运行的同步；再用 ntn workers runs list 找出退出码非零的运行并记录运行 ID；随后用命令拉取日志，例如对最近一次运行执行 ntn workers runs list --plain | head -n1 | cut -f1 | xargs -I{} ntn workers runs logs {}，或针对特定 sync 用 grep <syncKey> 过滤后再取日志。阅读日志中的错误信息、堆栈和 console.log 输出，再阅读 src/index.ts 及相关模块，把日志错误与代码逻辑对照。
常见故障与修复方向：401/403 检查 OAuth 配置（ntn workers oauth token <oauthKey>）、环境变量（ntn workers env list，缺失时 ntn workers env push），令牌过期用 ntn workers oauth start <key> 重新认证；429 降低批大小或增加调用间隔；超时则减少每页记录数、简化单条处理；游标/状态错误可通过 ntn workers sync state reset <key> 清空状态并重新回填；schema 不匹配需核对 changes 的 properties 键与 schema.properties，并正确使用 Builder.title()、Builder.richText() 等；死循环检查 hasMore、nextState 是否推进及终止条件；空结果则直接测试 API 调用、核对端点和权限范围；网络/瞬时错误可观察后续运行或触发重试（ntn workers sync trigger <key>）。
修复与验证：应用修改后运行 npm run check 验证类型；若状态结构变化，需提醒可能执行 ntn workers sync state reset <key>（会触发全量重新回填）；部署验证可用 ntn workers deploy && ntn workers sync trigger <key> --preview，确认后运行 ntn workers sync trigger <key> 恢复同步。
限制：以上为资料中给出的排查步骤与命令，未提供该技能的收费、价格、适用平台或其他未列出的能力信息。