用途:在提交 PR 前或审查他人改动时使用,提供一套核对清单与可选的严重程度标签。
检查清单:本地运行 npm run lint 和 npm run build(CI 不会自动运行这两项)。预览模式需确认 components/Preview.tsx 与 initLivePreview 行为正常;生产路径需确认服务端 getPage 与 Page 对 / 的渲染正确。新增或重命名环境变量时,更新 .env.example 及必要的用户文档。仓库中不得出现密钥,需扫描 diff 排查误提交的令牌。富文本路径在交给 dangerouslySetInnerHTML 前仍须经 isomorphic-dompurify 消毒。若新增图片主机或 CDN,需更新 next.config.mjs 的 remotePatterns(以及如使用的 env 驱动主机名)。内容或 schema 变更应同步反映到 lib/types.ts 及组件中的 Live Preview $ 绑定。依赖变更需考虑对 Snyk / SCA 工作流的影响(见 .github/workflows)。
严重程度(可选标签):Blocker——安全回归(XSS、令牌泄露)、预览或生产首页路由损坏、构建或 lint 失败;Major——Contentstack 行为不正确、缺少环境变量文档、类型/schema 漂移可能破坏预览编辑;Minor——样式、文案、非面向用户的重构、小的 UX 细节。