关于 experience-content-media-image-generate
这项 skill 用于生成、下载和预览图像资源。它先检查 `media-management` MCP 服务的 `create_image` 工具;若不可用,则提供固定的占位图 URL。
主要功能
- 01检查图像生成工具是否可用
- 02使用 `create_image` 生成图像
- 03配置输出格式与质量
- 04下载并预览生成的图像
- 05使用固定占位图作为后备
适用场景
- 01根据自然语言提示生成图像
- 02保存并预览生成的资源
- 03生成不可用时提供图像源
MCP 相关
若可用,则调用 `media-management` MCP 服务的 `create_image` 工具;否则指定占位图 URL 作为后备。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ forcedotcom/ sf-skills --skill experience-content-media-image-generate安装后在 Claude Code 中输入/experience-content-media-image-generate确认已加载。
附带文件scripts/download-image.sh
详细介绍
生成图像
目标
以编程方式生成、下载并预览用户请求的视觉素材,确保符合指定的格式和质量标准,同时提供可靠的备用方案。
工作流
- 检查是否已配置
media-managementMCP 服务,以及其create_image工具是否可用。 - 如果可用,使用
create_image生成图像。 - 如果不可用,使用下面的占位图备用方案。
MCP:media-management
工具: create_image
检查可用工具。如果存在 create_image,请将其作为主要图像生成方式,并传入自然语言提示词和下表中适用的参数。(此处的 media-management 指 MCP 服务名称,而非此技能。)
如果工具列表中没有 create_image,则表示未配置 media-management MCP,请使用下面的占位图备用方案。
图像生成参数
除非用户另有指定,否则使用以下默认值:
| 参数 | 默认值 | 选项 |
|---|---|---|
model | Standard | Standard、Premium |
size | auto | auto、1024x1024、1536x1024、1024x1536(选择最接近用户要求尺寸的选项) |
quality | medium | low、medium、high |
outputCompression | 75 | 0–100(仅适用于 webp/jpeg) |
outputFormat | webp | webp、jpeg、png |
background | auto | auto、transparent、opaque |
**格式规则:**如果 outputFormat 为 png,请将 outputCompression 设为 100。
成功生成后
运行此技能 scripts/ 目录中的 download-image.sh,下载并预览图像:
bash scripts/download-image.sh \
--url "<image_url_from_response>" \
--id "<responseId>" \
--format "<outputFormat>" \
--preview
此脚本会处理凭据获取、下载和 VS Code 预览。传入 --output-dir <dir> 可覆盖默认的 generatedimages/ 目录。
**切勿使用外部工具调整生成图像的尺寸或进行后期处理。**要控制显示尺寸,请在使用图像的位置通过 CSS 属性(例如 width、height、object-fit)进行设置。
备用方案:使用占位 URL
如果图像生成失败或未启用,请返回以下 URL 作为图像源;不要下载,也不要在本地保存:
https://cdn.scs.static.lightning.force.com/content/assets/d5222d4a11e6c2b735152d7eea824ce4/placeholder.svg
在代码中引用图像时直接使用此 URL(例如作为 src 属性或 CSS url())。
占位图政策
只有一个占位 URL。不要下载或修改它,也不要使用 Python、ImageMagick 或任何其他工具生成替代占位图。
如果用户要求特定尺寸或格式的占位图,请告知他们只有此占位 URL 可用,并引导他们在使用图像的位置通过 CSS 属性(例如 width、height、object-fit)进行缩放。