前言¶

读完一本书、看完一部片子，往往只留下几句台词和一段感受。自己用通用作图工具拼排版，要么像广告传单，要么字压在杂乱的背景上读不清。若希望 Agent 按固定流程收齐信息、先出氛围底图再叠排版，并把结果做成适合朋友圈或笔记的竖版卡片，就需要一套写进 Skill 的两段式生成流程。下面介绍 SkillHub 社区技能「金句打卡海报」的定位、能力与安装用法。

这是什么¶

「金句打卡海报」是 SkillHub 上的社区 Skill，坐标为 @user_36bd3ef4/quote-checkin-poster，当前版本 1.0.0，分类为 design-media，由发布者 user_36bd3ef4 维护。

一句话定位：通过官方 Mew API，把书籍、电影、播客等作品中的标题、金句、观后感与情绪，生成兼具氛围感与可读性的打卡海报。

技能页标注 requires_api_key=true：运行时需要用户提供并校验 mew.design 的 API Key，再调用 image-process 与 design-generate 两个接口完成生成。

核心功能¶

技能采用 SKILL.md 约定的两阶段工作流，事实均来自官方技能包说明。

两阶段生成¶

1. 背景阶段：调用 Mew 官方 image-process API。若用户提供封面、海报或剧照等公网图片 URL，作为 sourceImageUrls 做情绪向处理；若无参考图，则仅凭 prompt 按气质生成背景。此阶段不叠加标题或金句文字。
2. 成图阶段：调用 Mew 官方 design-generate API，将上一阶段的背景作为 assetImages 主素材，排版标题、金句、短评、可选打卡标签与个人署名水印，输出竖版分享图（示例参数为 1080×1600）。

输入与编排规则¶

Agent 会按技能说明收集或推断：

• 作品类型（书、电影、纪录片、动漫、剧集等）、标题、可选作者/导演/出处行
• 一条核心金句或短引文、一段核心感受
• 情绪方向（如治愈、孤独、浪漫、哲思、复古等）与视觉风格预设
• 可选打卡文案（如「读书打卡」「今日观影」）、日期、昵称水印
• 可选参考图公网 URL

若用户未给日期或打卡标签，使用当前本地日期或「今日读书」「今日观影」等现时点表述，不虚构观影/阅读时间。文字过多时会压缩为「短标题 + 一条金句 + 一条短评」，优先保证金句可读。

气质与风格预设¶

技能区分 mood（情绪/氛围） 与 style（视觉风格）：

• 气质示例：healing、lonely、romantic、philosophical、retro
• 风格示例：minimalist（极致极简风）、vintage-film（复古胶片风）、japanese-salt（日式盐系）、editorial-magazine（杂志画报风）、collage-art（拼贴风格）

用户未指定风格时，技能内含按作品类型与关键词自动匹配的规则；背景或成图不达标时，各阶段允许按说明重试一次并加强构图、留白与排版提示。

密钥与图片 URL¶

• 同一会话中已验证通过的 mew.design API Key 会复用，仅在缺失、校验失败或用户更换时再索取。
• 下游接口需要 公网可访问 的图片 URL。仅本地路径或聊天附件时，技能要求先说明隐私前提，征得同意后才可建议经第三方图床临时上传；用户也可自行上传到 OSS 等可信地址后提供 URL。

安装与启用¶

通过 SkillHub CLI 安装¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行完整安装（含 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装技能时 必须 用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。在 Cursor 中常用目录为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/（完整列表见 SkillHub 安装文档）。

skillhub install @user_36bd3ef4/quote-checkin-poster --dir ~/.cursor/skills/

SkillHub 技能页亦支持将下列说明发给 Agent，由其按 skillhub.md 完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_36bd3ef4/quote-checkin-poster`。

安装后重启或刷新 Agent，使技能目录生效。

mew.design API Key¶

技能包提供的引导文案要点如下：

1. 访问 https://mew.design/login 注册或登录（新用户注册送积分，可用于免费创作）。
2. 进入「账户设置」→「API 密钥」，创建新密钥。
3. 将 Key 粘贴到对话中，由 Agent 校验后再开始生成。

请求头使用 x-api-key 传递用户提供的密钥。

典型用法¶

在对话中触发¶

OpenAI 兼容配置中的默认提示示例为：

Use $quote-checkin-poster to turn my book or movie takeaway into a shareable quote poster.

中文场景下，可直接描述作品类型、标题、金句、一句感受，以及想要的气质或五种风格之一；若有封面或剧照，优先提供 HTTPS 公网 URL。

API 调用示例（技能包摘录）¶

阶段一：背景图（POST https://api.mew.design/open/api/image/process）

curl -sS -X POST "https://api.mew.design/open/api/image/process" \
  -H "Content-Type: application/json" \
  -H "x-api-key: USER_PROVIDED_KEY" \
  -d '{
    "prompt": "Create a healing cinematic background image for a reading check-in poster. Use cloud light, quiet water reflections, soft paper textures, and enough negative space for a quote. No text.",
    "sourceImageUrls": ["https://example.com/book-cover.jpg"],
    "aspect_ratio": "3:4",
    "image_size": "2K"
  }'

阶段二：成稿海报（POST https://api.mew.design/open/api/design/generate）

curl -sS -X POST "https://api.mew.design/open/api/design/generate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: USER_PROVIDED_KEY" \
  -d '{
    "userQuery": "Create a quote check-in poster for the film title Before Sunrise. Quote: ... Takeaway: ... Keep the mood romantic and reflective.",
    "designConcept": "Editorial quote poster, premium typography, readable quote-safe area, elegant cinematic composition.",
    "width": 1080,
    "height": 1600,
    "assetImages": [
      {
        "url": "https://example.com/background-image.jpg",
        "tag": "main atmosphere background must appear accurately"
      }
    ]
  }'

生成成功后，技能要求以 Markdown 图片语法返回成图，并附一句简短说明（何种读书/观影打卡海报）。示例输出结构：

![Quote poster](https://...)

[Open original image](https://...)

适用场景与注意¶

适合谁

• 读书、观影、听播客后，想把金句与感受做成统一审美的竖版分享图，又不想每次手写 prompt 编排两阶段 API 的创作者。
• 已在使用 Cursor、Claude Code、Codex 等支持 Skill 目录的 Agent，并愿意配置 mew.design API Key 的用户。

限制与注意

• 依赖外网调用 mew.design；Key 无效或停用（如 Inactive API Key）时需更换或重新配置。
• 无公网参考图时，只能走纯 prompt 背景或经用户同意的第三方上传，不适合对图源隐私要求极高的素材。
• 技能为社区来源（community），质量与可用性以当前 1.0.0 包内容为准；SkillHub 页显示评分 100000、下载 1148、安装 9（数据随 SkillHub 统计更新）。

结尾¶

「金句打卡海报」把书影金句打卡从「临时拼一张图」收敛为可复用的 Agent 流程：校验 Key、收齐文案与风格、先背景后排版、可读性不过关则按规则重试。若你需要在 Agent 里稳定产出氛围感打卡海报，可从 SkillHub 安装 @user_36bd3ef4/quote-checkin-poster，并准备好 mew.design API Key。

• 技能页：https://www.skillhub.cn/skills/user_36bd3ef4/quote-checkin-poster
• API 索引：https://api.skillhub.cn/user_36bd3ef4/quote-checkin-poster