运行时依赖
安装命令
点击复制技能文档
内容管理系统 在用户处理内容管理系统或表现类似的软件时使用此技能。该技能关注CMS工作中重要的方面:主题和模板;插件、应用、模块和扩展;管理员和编辑接口;媒体和上传处理;内容模型、分类法和元数据;渲染管道和静态导出流程。
何时使用此技能 用户提到CMS平台,如WordPress、Shopify、Drupal、Joomla、Webflow、Squarespace、Wix、WooCommerce、HubSpot CMS Hub或Adobe Experience Manager。 任务涉及主题开发、模板更改或设计系统工作。 任务涉及插件、模块、应用或扩展点。 任务涉及编辑器UX、预览、分类法、slug、SEO字段或发布行为。 任务涉及上传、媒体库、授权资产、markdown渲染或静态导出。
首次通过 确定平台类别:自托管CMS、SaaS站点生成器、商务平台或混合/无头系统。 在编辑之前找到所有权实现接缝:主题或模板层;插件、应用、模块或扩展层;管理员或编辑表面;内容模型或存储层;媒体管道;导出、部署或渲染管道。 在选择方法之前检查平台约束:什么可以在本地编辑;什么是授权内容与代码;媒体属于哪里;最终站点是服务器渲染、静态导出还是远程托管。
CMS规则 遵循平台的命名和文件夹约定,用于主题、模块、模板部分或部分。 将主题资产与用户上传的媒体分开,除非平台明确将它们合并。 更喜欢结构化内容字段而不是在演示标记中存储重要元数据。 将预览、slug、分类法、摘录、元字段和发布状态视为CMS的主要问题。 更喜欢安全的默认值和优雅的回退行为,当配置、主题选择或内容输入无效时。 在更改编辑器或管理员行为时,跟踪存储字段、验证规则、预览路径和最终渲染路径。
常见工作流程 主题和模板 从模板加载器或主题运行时开始,而不是从下游包含开始。 保留平台的模板层次结构和部分命名约定。 将演示更改保留在模板和共享主题助手附近。 插件、应用和模块 在平台的扩展接缝处添加行为,而不是将逻辑分散到模板中。 保留迁移、种子数据和配置更新的明确和版本化。 记录扩展的设置假设,当平台需要激活或注册时。 管理员和编辑UX 将表单与存储的内容模型对齐。 更喜欢作者面向的预览,当内容转换是非平凡的。 将验证、CSRF或等效的安全措施和权限与周围的管理员代码保持一致。 媒体和上传 为授权媒体使用专用的上传路径。 将装饰或主题拥有的图像保留在活动主题文件夹中。 默认为约定的位置,如uploads/用于授权媒体和img/用于主题资产,除非平台指定了更强的约定。 当CMS支持可配置的媒体目录时,使用安全的回退来暴露设置。 内容模型和迁移 清晰地区分内容实体:页面、帖子、产品、条目、集合、分类法和设置。 更喜欢迁移文件或可导出的模式定义而不是ad hoc运行时突变。 将slug、发布日期、摘录、规范元数据和分类法关系结构化。 Markdown、HTML和静态导出 在更改渲染器之前,确定markdown是授权输入、中间内容还是构建输出。 将渲染器更改与预览或验证配对,当可行时。 对于静态导出的CMS系统,在构建更改后验证重写的永久链接和资产路径。
确定所有权接缝 无论平台如何,通过将代码库映射到这些CMS角色来定位所有权接缝:运行时引导和请求路由;管理员或编辑控制器及其视图模板;主题加载、模板层次结构和共享模板助手;存储库、模型或模式/迁移文件,用于内容、分类法和设置;Markdown或内容转换实用程序;静态导出、部署或渲染管道入口点。 先到达所有权接缝,然后进行最小的更改以保留CMS结构。
平台说明 请参阅references/cms-platform-workflows.md以获取常见CMS平台、扩展表面和媒体约定的紧凑映射。