Payload CMS 操作技能用于在代码仓库工作流中操作 Payload CMS（基于 Next.js 的无头内容管理系统）。
用途 该技能围绕 Payload 项目的日常开发与维护展开，主要覆盖四类工作：新建或首次集成 Payload 应用；更新集合（collections）与全局配置（globals）的模型结构；排查管理后台或 API 的运行时故障；为生产发布做准备。
主要能力
- 搭建：按仓库所用包管理器安装依赖，生成或初始化 Payload 配置，包含最小必需的集合，并运行本地开发环境。
- 建模：编辑集合、全局、访问控制与字段结构，一次只做一处有边界的模型变更（新增/删除字段、修改字段类型），并记录影响范围（受影响的集合、API 输出、管理后台表单、种子或导入任务）。
- 运行时排错：在本地或预发环境复现具体失败的端点或页面，检查配置、环境变量绑定、访问规则与适配器接线，并以明确的修复前后证据验证。
- 发布准备：确认迁移顺序与停机假设，补充回滚说明（回滚迁移、恢复备份、关闭功能开关），并确保验证清单可在 CI 或预发冒烟测试中执行。
使用方式 技能按步骤执行：先确定操作模式（Bootstrap 搭建、Modeling 建模、Runtime debug 运行时排错、Release prep 发布准备），再做预检（确认运行时与工具链、定位 payload.config.* 与模型文件、确认环境变量与密钥形态、查看既有迁移历史），然后执行最小可行工作流，最后通过验证清单确认：Payload 服务无模式或运行时错误启动；至少一个被修改的集合或全局通过 API 与管理后台验证；迁移步骤确定且可回滚；面向生产的变更附带风险与回滚说明。
适用场景
- 新建 Payload 项目，或将 Payload 加入现有 Next.js 应用。
- 定义或演进集合、全局、访问控制与字段结构。
- 本地运行、开发、测试 Payload，并验证管理后台与 API 行为。
- 规划安全的内容模型迁移与回滚策略。
- 为生产发布准备 Payload 变更并附带明确的验证检查。
限制与不适用场景
- 与 Payload 运行时无关的通用 API 契约工作，应使用 api-design。
- Payload 特定设置之外的认证架构决策，应使用 authentication-setup。
- 不涉及 Payload 模型约束的纯数据库物理模式调优，应使用 database-schema-design。
- 与 Payload 运行时无关的广义部署编排，应使用 deployment-automation。
最佳实践 每个 PR 保持模型变更小而可审计；未经迁移与回滚说明不得合并模式变更；对触及的模型同时验证管理后台与 API；优先使用显式访问规则而非隐式默认值；将环境绑定与适配器配置作为一等检查项。
参考 Payload 仓库：https://github.com/payloadcms/payload Payload 文档：https://payloadcms.com/docs/getting-started/what-is-payload