确认分页数据已全部读取
Prove paginated retrieval is complete
按接口规则读取后续页,明确区分完整结果和只取到部分数据。
以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。
使用场景
你要对声明筛选范围内的全部订阅者聚合,首页成功不说明完整。教学响应页1含50条和meta.next_cursor=c2,页2含20条并返回null;过滤条件与访问范围固定。游标只按服务返回原样续接。
具体做法
核对接口分页和终止契约,记录输入范围、每页数与续接值。顺序读后续页并按稳定身份累计,只有规定终止且所有页成功才称范围内完整。页失败、权限错误、重复游标或预算上限保留部分状态和下一位置;不能用总数未知或首页成功推断完成。
反例
用第一页50条计算全部订阅者指标,看到200就报告完整,不看c2或后续页失败。
改进写法
按教学meta.next_cursor契约读取页1→c2→页2→null,保持同一筛选/账号范围,累计70条并核对身份。只有两页成功和null终止才报告范围内完整;失败或到上限列页数、实际条数、未决游标与部分状态,不猜未读数据或绕过配额。
为什么这样改
单页传输成功只覆盖该页,明确终止条件提供未读范围已经处理的依据。范围与游标保持一致,也避免一次聚合混入不同过滤结果。
如何验证
教学成功结果是两页70条且终止null;第二页失败则只有50条部分结果。故意重复c2要被识别为异常,不无限循环。
检查终止证据、页数和身份映射,而不仅比条数;本篇不查询真实订阅者。
适用边界
完整性仅针对声明过滤和权限,动态数据可能需要快照语义。不同端点的page/offset/cursor终止规则不相同;冻结字段是实例,不是所有分页都返回null。
原文与版本
- ComposioHQ/awesome-claude-skills · Known Pitfalls
查看此版本的文件be2a406907db - ComposioHQ/awesome-claude-skills · Known Pitfalls
查看此版本的文件be2a406907db