用途:为 PHP 后端 REST API 及 Android(Kotlin + Compose)、iOS(SwiftUI)移动客户端实现统一的偏移(offset)分页模式,适用于为任意列表接口添加分页。不适用于与分页无关、或存在更具体配套技能的任务,也不适用于只需简单回答的场景。
主要能力:后端返回固定的 data.items[] + data.pagination{} 结构(含 page、per_page、total、total_pages);移动端在滚动时追加条目,并在 ViewModel 中跟踪 page/totalPages。分页查询需使用 utf8mb4_unicode_ci 排序规则,并在 Windows 开发(MySQL 8.4.7)、Ubuntu 预发与 Debian 生产(MySQL 8.x)环境保持一致。
使用方式:先读 SKILL.md,再按需加载 references/ 深层文档。按技能内的有序指引、检查清单与决策规则执行,输出应面向可执行、简洁,并与仓库既有工程标准与项目约定兼容。
后端关键规则:COUNT 查询后须 closeCursor();LIMIT/OFFSET 以 PDO::PARAM_INT 绑定;per_page 上限 100,列表页默认 30、库存页默认 50;返回体不得为扁平数组。
输入与产出:需收集项目上下文、约束与具体问题,并确认交付物(设计、代码、评审、迁移计划、审计或文档);产出可含实现指引、评审发现、架构决策、模板或生成物,以及假设、权衡与后续动作。正确性产物为分页测试计划(覆盖 offset、limit 及空、末页、超限等边界与稳定排序)。
限制:完整示例与 Android/iOS 客户端模式位于 references/skill-deep-dive.md;平台备注称可选辅助插件在某些环境有帮助但非必需。文档未提供收费、价格或效果信息。