DatoCMS Setup 是 DatoCMS 官方 agent-skills 仓库中的引导式配置技能,负责整个配置对话的流程:目标、提问、计划、顺序、用户同意与后续交接。具体实现由同仓库的其它 DatoCMS 技能承担,本技能只引用对应文件与章节,要求加载这些文件而非凭记忆发挥;缺少同级技能时,会请用户安装完整的 datocms/agent-skills 技能包。
主要能力与用法:先做只读检查,读取 package.json(框架与 DatoCMS 包、CLI)、锁定文件判断包管理器、源码布局、环境变量文件名(不打印值)、datocms.config.json 与迁移目录、已有的 DatoCMS 代码。仓库能回答的问题不再询问。目标不明确时(如仅说“设置 DatoCMS”),会给出 2–4 个符合当前仓库的结果选项供选择,目标未答则不继续。之后选择对应的 play(如连接站点、预览与可视化编辑、发布内容刷新、内容渲染、SEO 与抓取、站点搜索、连接仓库、类型化 CMA 代码、模式迁移、发布迁移、多项目管理、Webhook 与构建触发、导入等),仅阅读所需章节,列出计划:按顺序的 play、需新增或修改的文件、依赖包、环境变量、对 DatoCMS 或外部服务的每一项变更,以及保留为占位符的内容,然后停下等待用户确认。
关键限制:开始配置的那一轮不做任何编辑,即使指令很具体,也需用户明确用原话豁免计划(如“跳过计划”)才可在同一轮构建;构建范围锁定在已同意的计划内,出现新需求须停下询问。对 DatoCMS 项目或外部服务的实时变更(插件、Webhook、构建触发、角色、令牌、搜索索引、迁移运行、环境 fork/promote/destroy、维护模式、导入、部署、抓取等)必须获得用户对该操作与目标的明确批准,否则保留为可审查的代码或仪表盘步骤。新站点部分提供 Next.js、Nuxt、SvelteKit、Astro 的官方 starter(GitHub 仓库与 Marketplace 页面),已有自有 schema 的项目需注意 starter 查询不匹配。交付时只有在真实值与端到端验证完成后才标记生产就绪,否则为已搭建状态,并列出未解决的占位符与测试步骤。