快速开始

使用 Agent Skills CLI 安装：

npx skills add qizong007/shuai-cover-resize

安装内容仅包含 Skill 运行所需的说明、元数据和比例检测脚本，不包含 README 与展示图片。

CLI 会让你选择目标 Agent 和安装范围。安装完成后，上传源封面并调用：

使用 $shuai-cover-resize，把这张封面适配为 3:4、4:3 和 16:9。
保持标题文字、人物身份和品牌色不变。

需要更新时：

npx skills update shuai-cover-resize

它解决什么

同一张封面放进不同平台时，真正的问题通常不是尺寸，而是信息层级：横版标题到了竖版会挤压人物，人物放大后会遮住文字，背景不足又容易被粗暴拉伸。

shuai-cover-resize 把源封面当作唯一母版，为每个比例独立重构：

  • 保持标题原文、主题、人物身份、核心物体和品牌识别不变。
  • 允许扩展背景、移动元素、调整景别、缩放主体和重新换行。
  • 禁止横向或纵向拉伸，也不使用已生成版本继续派生下一版。
  • 每个结果单独验收，只重试失败的比例。

支持的平台

比例 平台 构图重点 最低分辨率
1:1 公众号 方形分享图，主体居中，保证消息列表与分享卡片中的可读性 1080×1080
3:4 小红书 竖版高密度，优先保证人物和标题的手机可读性 1080×1440
4:3 B站 均衡横版，人物与标题形成清楚层级 1200×900
3:4 / 4:3 视频号 同时支持竖版与横版，保证信息流预览中的主体和标题清晰 1080×1440 / 1200×900
16:9 YouTube 强焦点横版，人物与标题尽量左右分区 1280×720
5:2 X 文章 超宽编辑感，尽可能移除真人，用场景、物体或抽象视觉表达主题 1500×600
2.35:1 公众号 超宽编辑感，增加留白，默认弱化或移除人物 900×383

未指定比例时默认生成 4:3、3:4 和 16:9，其中 4:3 与 3:4 均可用于视频号。明确要求公众号版时增加 1:1 方图与 2.35:1 头图；明确要求 X 文章版时增加 5:2；只指定某个比例时，仅生成指定版本。

推荐：在 ChatGPT 中使用 ImageGen

本 Skill 最适合由具备 ChatGPT ImageGen 图像编辑能力的 Agent 执行。

它是一套版式重构与验收工作流，本身不包含图像模型。执行环境必须能够把源封面作为图片输入交给图像编辑模型，而不是只根据文字重新想象一张新图。

其他支持源图编辑的模型也可以尝试，但当前规则优先围绕 ImageGen 的编辑能力设计。不同模型在人物一致性、中文文字和扩图质量上会有明显差异。

工作流程

读取源图 → 锁定原文与身份 → 检测已有比例
         → 从母版独立重构每个目标比例
         → 检查尺寸、文字、人物、构图与画质
         → 只重试失败版本 → 命名交付

仓库中的 detect_ratio.py 只依赖 Python 标准库，可检测 PNG、JPEG 和 GIF：

python3 skills/shuai-cover-resize/scripts/detect_ratio.py cover.png 4:3 3:4 16:9

输出会标记哪些比例可以复用，哪些需要生成。

能力边界

  • 文字必须人工验收。 生成模型不是可靠的排版工具；若反复出现错字，应先生成无字底图，再用专业排版工具叠加原文。
  • 无法承诺像素级复刻。 人脸、手部、字体、Logo 和细小装饰可能漂移；品牌要求严格时，应同时提供原始 Logo、字体或可编辑设计文件。
  • 源图质量决定上限。 模糊、低分辨率、严重遮挡或不可辨认的内容无法稳定恢复；看不清的文字不会被猜测。
  • 比例正确不等于通过验收。 每一版仍需检查人物数量、肢体、文字、Logo、水印、安全区和平台 UI 遮挡。
  • 请确认素材授权。 上传人物照片、品牌资产或未公开内容前，应评估版权与隐私风险。

输出约定

生成文件放在源图所在目录：

<原文件名>__3x4
<原文件名>__4x3
<原文件名>__16x9
<原文件名>__5x2
<原文件名>__1x1
<原文件名>__235x100

文件已存在时追加序号，不覆盖旧结果。源图已经符合某个比例且没有额外编辑要求时，直接标注“复用原图”。

项目结构

shuai-cover-resize/
├── README.md                # 中文文档（默认）
├── README.en.md             # English documentation
├── assets/readme/           # README 视觉素材，不随 Skill 安装
└── skills/shuai-cover-resize/
    ├── SKILL.md                 # 工作流与验收标准
    ├── agents/openai.yaml       # Skill 展示元数据
    └── scripts/detect_ratio.py  # 比例检测脚本

维护与贡献

这是一个长期维护的 Agent Skill。提交变更时请遵守：

  • skills/shuai-cover-resize/SKILL.md 是行为、默认值和验收标准的唯一事实来源。
  • 平台规格或最低分辨率变化时，同步更新中英文文档。
  • 修改脚本后，验证 PNG、JPEG 和 GIF 尺寸检测。
  • 不接受改写源文案、拉伸画面、降低身份一致性或跳过验收的变更。
  • 提交 Issue 时请附上源图尺寸、目标比例、使用环境和失败现象；不要公开上传隐私素材。

README Hero 使用 ImageGen 生成项目专属人物素材，并以 SVG 完成准确文字和比例框排版；生成提示词与可编辑布局保存在 assets/readme/source/。

致谢

本项目 README 的视觉设计与排版基于 oil-oil/beautify-github-readme 完成，感谢 oil-oil 提供这个优秀的 Skill。

关注作者

许可证

本项目采用 MIT License 开源。