Contentful 管理 API 与 JavaScript SDK

解决什么问题

在无头 CMS 工作流里，内容交付依赖 entry、asset、content model 与环境之间的一致性。一旦发布流程需要自动化，团队要么继续在 Web 界面上手工点选，要么让通用 LLM 凭印象猜 Contentful 的字段结构。结果通常是 schema 漂移、脏数据写进草稿环境、发布到一半失败，而且出问题后很难复现——你甚至说不清是哪一步改坏了。

技能如何工作

核心能力

• 以编程方式操作 Contentful，而不是把它当成一个通用 CMS 来聊天
• 覆盖 entries、assets、content models、environments 的创建、更新、校验与发布
• 给 agent 一条明确的操作路径：每一步做什么、在哪一步停下来校验

关键步骤

1. 拿到访问凭证，确认目标空间与环境
2. 先读现有 content model，确认字段约束和引用关系
3. 构造 entry 或 asset 载荷，在写入前完成校验
4. 校验通过后再发布，失败时保留可回滚的中间状态

这套技能把 Management API 与官方 JavaScript SDK 封装成可执行的流程，agent 可以按步骤定位问题，而不是一次性吐出一大段没人敢跑的脚本。

适用边界

• 只覆盖 Management API 的管理面操作，不负责前端渲染，也不做 Delivery API 的内容查询
• 凭证属于敏感信息，分享任何代码之前都要先删掉
• 上游 SDK 在浏览器和 Node.js（LTS）上运行，选型时要匹配实际部署环境
• 级联删除、跨环境迁移这类重操作，建议先在非生产环境验证