contentful-guide

Contentful 指南

将此技能用作 Contentful 任务的路由和词汇层。

Contentful 是一个无头、API 优先的 CMS（可组合内容平台），团队可以在其中对内容建模一次，并将其交付到多个渠道。

此技能的用途

1. 澄清核心术语（空间、环境、环境别名、内容模型、内容类型、条目、资源、区域设置）。
2. 将用户意图映射到正确的 API（CDA、CPA、CMA、GraphQL、Images API）。
3. 将实现请求路由到相应的技能和文档。
4. 识别超出此技能范围的请求，避免错误配置。

路由规则

• 如果用户要求将 Contentful 添加到 Next.js 项目，请使用 contentful-nextjs 技能。
• 如果用户询问优化／个性化／分析设置或调试，请路由到 contentful-personalization 技能。
• 如果用户要求编写内容类型迁移或架构变更，请路由到 contentful-migration 技能。
• 如果用户要求提供具体的 REST／GraphQL 请求（curl 示例、标头、查询参数、CMA／CDA／CPA／Images／GraphQL 的负载结构），请路由到 contentful-api 技能。
• 如果用户要求概念指导、架构权衡或文档阅读路径，请留在此技能中。
• 如果用户询问环境别名和部署工作流，请留在此技能中，除非用户同时要求框架实现。

API 选择

• 对网站／应用中已发布的内容，使用 CDA。
• 对尚未发布的预览内容，使用 CPA。
• 对写入操作（创建／更新／管理内容和模型），使用 CMA。
• 如果更倾向于控制查询结构，而非使用 REST 负载，则使用 GraphQL Content API。
• 对图像转换，使用 Images API。

Contentful MCP 说明

• Contentful MCP 服务通常是让 Agent 与 Contentful 交互的最简单方式。
• 如果用户希望通过对话访问空间、条目和内容模型上下文，而不想先接入 SDK 代码，请使用它。
• 权威文档：https://www.contentful.com/developers/docs/tools/mcp-server/

操作模式

使用此技能回答时：

1. 使用 references/lexicon.md 中的通用词汇定义术语。
2. 从 references/docs-map.md 中选择合适的文档路径。
3. 如果用户要求实现，请依据 references/skill-routing.md 转交。
4. 保持回答简洁，并引用权威文档路径。

注意事项

• 不要虚构产品功能、API 行为或限制。
• 除非路由到专门的实现技能，否则不要提供框架代码。
• 如果细节可能因版本而异，请优先参考官方文档，而非依赖记忆。

参考资料

• 词汇表
• 文档索引
• 技能路由