mcpField
C
cms-assets

cms-assets

github.com/contentstack开发598 次安装2 周前更新
代码仓库

关于 cms-assets

为使用 Contentstack 内容管理系统的开发者提供资源库操作指导，涵盖组织、图像转换、发布和 CDN 交付。该只读技能也说明限制与可能导致引用失效的操作。

主要功能

  1. 01资源文件夹与命名建议
  2. 02Image Delivery API 转换说明
  3. 03发布与 CDN 行为解析
  4. 04上传限制和引用风险提示
  5. 05只读操作指导

适用场景

  1. 01规划资源库文件夹结构
  2. 02配置响应式图像交付
  3. 03排查资源发布或 CDN 问题
  4. 04评估删除资源对内容引用的影响

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/contentstack/contentstack-agent-skills --skill cms-assets

安装后在 Claude Code 中输入/cms-assets确认已加载。

详细介绍

Contentstack 资产

描述

为开发者提供有关在 Contentstack 中组织、交付和转换资产的建议。涵盖文件夹结构、Image Delivery API 转换、发布生命周期、CDN 行为和常见限制。

适用场景

当开发者询问如何在堆栈的资产库中上传、组织、交付、转换、发布或排查图片及其他媒体文件的问题时使用。

对于独立的 Assets DAM 产品（spaces、workspaces、duplicate sets、saved views、visual markups），请改用 asset-management 技能。

此技能不涵盖读取或更新用户定义的字段（自定义元数据）。堆栈资产库不支持这些字段。将此类请求转给 asset-management 技能，该技能会指向 Assets (DAM) API。

用户问题

开发者需要有效地组织资产、提供经过优化的图片，并了解资产发布和 CDN 交付的工作方式。他们还需要避免引用失效和常见的资产管理错误。

成功标准

推荐清晰的文件夹结构和命名模式。 说明 Image Delivery API 转换和响应式图片交付。 正确描述资产发布、取消发布和替换行为。 指出相关限制、注意事项以及会导致引用失效的操作。

预期输入

  • 资产类型和使用场景
  • 图片优化要求
  • 文件夹组织需求
  • 发布或 CDN 问题

预期输出

  • 文件夹结构建议
  • Image Delivery API 转换指导
  • 发布生命周期说明
  • 性能优化建议

用户请求示例

  • 如何通过 Contentstack 提供响应式图片？
  • Contentstack 支持哪些图片转换？
  • 我应该如何将资产整理到文件夹中？
  • 删除资产会导致条目中的引用失效吗？
  • 我可以上传的最大文件大小是多少？

工作流摘要

确定资产类型和使用场景。 如有需要，建议文件夹组织方式。 说明图片的 Image Delivery API 转换。 描述发布和 CDN 行为。 指出限制、注意事项和引用风险。

指示

[{"heading":"文件夹组织","content":"在项目早期就推荐清晰的文件夹结构，例如 /images/heroes、/images/products 和 /documents/legal。在文件夹之间移动资产会保留 UID 和引用。"},{"heading":"Image Delivery API","content":"使用 images.contentstack.io 交付图片，并通过 width、height、quality、format、crop、trim、orient、overlay、pad、fit 和 dpr 等 URL 参数支持按需转换。建议通过 width/height 和 dpr 实现响应式交付，为现代浏览器使用 WebP，并调整 quality 以控制文件大小。可在一个 URL 中串联多个转换。非图片资产通过 assets.contentstack.io 提供。"},{"heading":"发布生命周期","content":"说明资产有独立于条目的发布生命周期。资产必须先发布到某个环境，引用该资产的条目才会在正式网站上显示。取消发布会使其无法在该环境中交付，但不会删除文件。"},{"heading":"替换与删除","content":"说明替换资产会创建新版本，同时保留相同的 UID 和现有引用。删除资产会导致条目中对此资产的所有引用失效。建议在删除前检查引用。"},{"heading":"主要限制","content":"清楚说明主要限制：通过 UI 上传的文件最大为 700 MB，通过 API 上传的文件最大为 100 MB；每批最多上传 10 个资产；每个堆栈默认最多 10,000 个资产，每个组织最多 500,000 个资产；上传后无法更改文件名。请注意，Image Delivery API 转换不适用于直接插入 Rich Text Editor 字段中的图片。"}],

输出格式

内容应简洁实用。适时以内联形式展示 Image Delivery API 参数。列出选项或限制时，优先使用简短的项目符号列表，直接作答。

工具使用说明

只读咨询技能。不要上传、删除、发布或修改资源。仅提供只读指导。

安全

默认规则
  • 切勿泄露令牌或 API 密钥。
  • 交付令牌和资源 URL 可安全用于客户端代码。
  • 示例代码中的凭据应使用环境变量。
破坏性操作

不要执行破坏性资源操作。如果用户要求删除、取消发布或替换资源，请说明相关影响并建议进行安全检查，但不要执行更改。

密钥

切勿泄露管理令牌、API 密钥或其他密钥。如果代码示例需要凭据，只引用环境变量。

环境变量

任何涉及凭据的示例都应使用环境变量。切勿在客户端代码中硬编码堆栈 API 密钥、管理令牌或交付令牌。

产品背景

    • 产品：CMS
    • 描述：Contentstack 无头 CMS：内容类型、条目、资源、环境、发布、工作流、Webhook 和 Content Management API（CMA）。
    • 产品安全规则： - 切勿泄露管理令牌或 API 密钥。
  • 凭据始终使用环境变量。
  • 浏览器应用中的所有 CMA 调用都必须通过服务端代理。
  • 切勿在客户端代码中硬编码堆栈 API 密钥。
    • 默认工具：["CMA API", "Content Types", "Entries", "Assets", "Workflows", "Webhooks", "Environments", "Releases", "Publish Queue"]
    • 默认连接器：["CMA Proxy", "Webhooks"]

评论

支持 Markdown