content-management-systems

内容管理系统

当用户正在处理内容管理系统或行为类似内容管理系统的软件时，使用此技能。

此技能聚焦于 CMS 工作中真正关键的衔接点：

• 主题和模板
• 插件、应用、模块和扩展
• 管理和编辑器界面
• 媒体和上传处理
• 内容模型、分类法和元数据
• 渲染管线和静态导出流程

何时使用此技能

• 用户提到 CMS 平台，例如 WordPress、Shopify、Drupal、Joomla、Webflow、Squarespace、Wix、WooCommerce、HubSpot CMS Hub 或 Adobe Experience Manager。
• 任务涉及 CMS 内的主题开发、模板变更或设计系统工作。
• 任务涉及插件、模块、应用或扩展点。
• 任务触及编辑器 UX、预览、分类法、slug、SEO 字段或发布行为。
• 任务涉及上传、媒体库、创作资产、markdown 渲染或静态导出。

第一遍处理

1. 确定平台类别：可自托管 CMS、SaaS 建站工具、商务平台或混合/无头系统。
2. 在编辑前找到负责的实现衔接点：
   • 主题或模板层
   • 插件、应用、模块或扩展层
   • 管理或编辑器界面
   • 内容模型或存储层
   • 媒体管线
   • 导出、部署或渲染管线
3. 在选择方案前检查平台约束：
   • 哪些内容可在本地编辑
   • 哪些是创作内容，哪些是代码
   • 媒体应放在哪里
   • 最终站点是服务端渲染、静态导出还是远程托管

CMS 规则

• 遵循平台对主题、模块、模板部件或区块的命名和文件夹约定。
• 将主题资产与用户上传的媒体分开，除非平台明确将它们合并。
• 优先使用结构化内容字段，而不是将重要元数据存储在展示标记中。
• 将预览、slug、分类法、摘要、元字段和发布状态视为 CMS 的一等关注点。
• 当配置、主题选择或内容输入无效时，优先采用安全默认值和优雅回退行为。
• 更改编辑器或管理行为时，一并追踪存储字段、验证规则、预览路径和最终渲染路径。

常见工作流

主题和模板

• 从模板加载器或主题运行时开始，而不是从下游 include 开始。
• 保留平台的模板层级和局部命名约定。
• 将展示变更保持靠近模板和共享主题辅助函数。

插件、应用和模块

• 在平台的扩展衔接点添加行为，而不是将逻辑分散到模板中。
• 保持迁移、种子数据和配置更新显式且带版本。
• 当平台要求激活或注册时，记录扩展的设置假设。

管理和编辑器 UX

• 保持表单与存储的内容模型一致。
• 当内容转换较复杂时，优先提供面向作者的预览。
• 保持验证、CSRF 或等效防护以及权限与周围管理代码一致。

媒体和上传

• 为创作媒体使用专用上传路径。
• 将装饰性或主题拥有的图像保留在活动主题文件夹中。
• 默认使用常规位置，例如创作媒体使用 uploads/，主题资产使用 img/，除非平台规定了更强的约定。
• 当 CMS 支持可配置媒体目录时，暴露该设置并提供安全回退。

内容模型和迁移

• 清楚区分内容实体：页面、文章、产品、条目、集合、分类法和设置。
• 优先使用迁移文件或可导出的 schema 定义，而不是临时运行时变更。
• 保持 slug、发布日期、摘要、规范元数据和分类法关系结构化。

Markdown、HTML 与静态导出

• 在更改渲染器之前，先确定 markdown 是创作输入、中间内容，还是构建输出。
• 在可行的情况下，将渲染器更改与预览或验证配对进行。
• 对于静态导出的 CMS 系统，在构建更改后验证重写的永久链接和资源路径。

识别所属接缝

无论平台如何，在编辑之前，通过将代码库映射到以下 CMS 角色来定位所属接缝：

• 运行时引导和请求路由
• 管理或编辑器控制器及其视图模板
• 主题加载、模板层级和共享模板助手
• 用于内容、分类法和设置的仓库、模型或架构/迁移文件
• Markdown 或内容转换实用程序
• 静态导出、部署或渲染管道入口点

首先转到所属接缝，然后进行保持 CMS 结构的最小更改。

平台说明

请参阅 references/cms-platform-workflows.md，了解常见 CMS 平台、扩展表面和媒体约定的紧凑映射。