后台 CRUD 强制默认规范

问题从哪来

需求里往往只写「做一个列表页」，但生产环境里的后台列表几乎总会牵涉分页、排序白名单、关键字检索、加载与空态、删除审计、多表写入事务、接口层权限复核、幂等与并发更新等问题。若每次靠口头追问补齐，容易漏项；若实现时悄悄省略，又会在联调或上线后集中暴露。

技能如何约束实现

本技能把后台 list / table / query 相关能力定义为强制默认，在未与用户规则冲突时直接落地，不必先问「要不要分页」。核心约定包括：

• 分页：接口接受 page（默认 1）与 pageSize（默认 20，上限 100），返回 { list, total, page, pageSize }；在数据库层做 LIMIT/OFFSET 或游标，禁止先全量拉取再切片；sortBy 字段白名单；默认排序列建索引。前端提供页码、总页数、总数与 pageSize 选择（10/20/50/100），并将 page、pageSize 同步到 URL；筛选或关键字变化时回到第 1 页。
• 交付说明：实现完成后，回复摘要必须逐项列出已应用的默认项（分页、关键字搜索、删除审计、行级归属校验、创建用户与档案的事务等），方便你在边界场景里主动关掉某条默认。
• 冲突处理：若需求与某条规则直接矛盾，只确认一次；用户坚持偏离时，在代码中用注释说明为何跳过该默认。

文档中还列举了典型反模式：未分页数组、前端有搜索框但 API 无 keyword、无确定性的 ORDER BY、前端全量过滤、空 catch、明文记录敏感信息、无审计的删除、仅路由级权限、多表写入无事务、创建无幂等、更新无版本校验等。

适用边界

仅当同时满足「数据集有界且很小、只读、无敏感字段、单用户本地工具」等条件时，才可整体跳过分页等默认；技能原文对「Skip only if ALL true」的完整条件需对照 SKILL 正文。其余场景应默认按规范实现，并在摘要里标明已启用项，避免静默省略。