前言¶

在 Agent 里做海报、社媒图或封面时，常见做法是让用户自己去 Canva 点选模板，或让模型只产出文字版「设计说明」。前者打断对话流，后者无法直接得到可编辑的设计稿。若要走 Canva 官方能力，又涉及 Canva Connect 鉴权、MCP 接入顺序，以及出错时该重试还是换路径——这些步骤分散在文档里，Agent 容易漏步或误用非官方接口。

下面介绍 SkillHub 社区技能「平面设计助手（生成即用·Canva 海报）」：它不写死某一张成品图，而是把连接鉴权、执行流程、异常处理与反模式写进 SKILL.md，让 Agent 在用户提出 Canva、海报、社媒图等需求时，按同一套流程调用官方 MCP/API。

这是什么¶

平面设计助手（生成即用·Canva 海报） 是面向 Agent 的操作型 Skill，坐标为 @user_af163eaa/z-ping-mian-she-ji-zhu-shou，当前版本 v1.0.2，来源为 community，分类 design-media，由发布者 user_af163eaa（SkillHub 页面标注作者为大智JiYoo）维护。

官方简介说明：当用户需要平面设计助手相关能力时使用（Canva、海报、社媒图、平面设计、设计稿、演示稿、封面、Canva Connect）。本 skill 提供连接与鉴权指引、执行流程、异常处理与反模式，指导 Agent 通过官方 MCP/API 完成 Canva 海报相关任务。Skill 标签标明 requires_api_key=true，即依赖 Canva Connect 等官方接入所需的 API Key，需在环境中完成配置后再调用。

核心功能¶

依据 SkillHub 与官方简介，已核实的能力边界如下。

1. 触发与范围：在用户意图涉及 Canva、海报、社媒图、平面设计稿、演示稿、封面或 Canva Connect 时激活，避免 Agent 用泛泛的「设计建议」代替可落地的 Canva 操作。
2. 连接与鉴权指引：说明如何通过官方渠道完成 Canva Connect / MCP 侧鉴权（具体字段与步骤以安装后的 SKILL.md 为准），减少 Key 泄露或走错端点的风险。
3. 执行流程：把「先连上、再选能力、再产出设计」等步骤串成 Agent 可逐步执行的路径，而不是一次性猜测 API。
4. 异常处理与反模式：对常见失败（鉴权失败、配额、模板/尺寸不匹配等）给出处理取向，并列出应避免的做法（例如绕过官方 API、在对话中明文索要长期密钥等——细则见 Skill 正文）。

本 Skill 不替代 Canva 产品设计本身；它规范的是 Agent 如何合规、可重复地驱动 Canva 官方接口。

安装与启用¶

SkillHub 技能页建议：将安装说明交给 AI，并参照 SkillHub 安装与优先源配置 安装坐标 @user_af163eaa/z-ping-mian-she-ji-zhu-shou。与同发布者其他「生成即用」系列技能一致，安装核心是 skillhub CLI + 指定 Agent 的 skills 目录。

1、安装或检查 skillhub CLI¶

先确认本机是否已有 CLI：

command -v skillhub && skillhub --version

若未安装，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：

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

仅需 CLI 时：

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

2、安装本 Skill 到当前 Agent 目录¶

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。文档给出的常见路径包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 环境下，安装命令示例为：

skillhub install user_af163eaa/z-ping-mian-she-ji-zhu-shou --dir ~/.cursor/skills/

安装后按你所用客户端要求重启或刷新 Skill 列表，使 SKILL.md 被 Agent 读取。

3、API Key 与 Canva Connect¶

Skill 标记 requires_api_key=true。Canva 侧 Key 的申请、环境变量名与 MCP 配置项以 Skill 内「连接与鉴权」章节及 Canva Connect 官方文档为准；不要把 Key 粘贴进公开聊天记录，应写入本地或客户端的安全配置。

典型用法¶

本 Skill 没有附带独立 CLI 脚本，典型用法是 自然语言任务 + Agent 按 Skill 流程调 MCP/API。下列表述与官方简介中的触发词一致，可用于验证 Skill 是否被正确加载（具体 API 调用名以 SKILL.md 与 Canva 官方文档为准）。

示例 1：活动海报

用户：「用 Canva 做一张线下读书会活动海报，尺寸适合微信朋友圈，标题和日期我稍后补充。」

预期行为：Agent 识别为平面设计 / 海报 / Canva 意图，先按 Skill 检查鉴权与 MCP 是否可用，再按流程创建或基于模板生成设计稿，而不是只输出排版文字说明。

示例 2：社媒封面

用户：「帮我做一条短视频的 Canva 封面图，风格偏简洁，需要留出标题区。」

预期行为：走官方接口完成画布与导出相关步骤；若鉴权失败，按 Skill 的异常处理指引提示用户检查 API Key 或 Connect 配置，而非伪造下载链接。

示例 3：演示稿 / 设计稿

用户：「把这份要点做成 Canva 演示稿首页封面。」

预期行为：在「演示稿、封面、设计稿」范围内激活本 Skill，与 Canva Connect 能力对齐执行。

经过上面的步骤，你应能在 Cursor 等客户端中，用同一套话术重复触发稳定的 Canva 工作流。

适用场景与注意¶

适合谁

• 已在或计划接入 Canva Connect / 官方 MCP 的团队，希望 Agent 侧有统一 SOP。
• 需要在对话中完成 海报、社媒图、封面、演示稿首页 等任务，且成品要在 Canva 生态内可继续编辑的场景。

限制与注意

• 依赖 API Key 与 Canva 官方服务可用性；未配置鉴权时，Skill 只能引导配置，无法凭空生成 Canva 内真实设计。
• SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 3503，安装 0——安装数为平台统计字段，实际以你本机 skills 目录是否出现该 Skill 为准。
• 版本 v1.0.2 以 SkillHub 登记为准；升级可用 skillhub 对同一坐标执行更新，并再次确认 --dir 路径。
• 反模式与错误恢复细节以安装后的 SKILL.md 为准，本文不展开未核实的 API 参数。

结尾¶

平面设计助手（生成即用·Canva 海报）把 Canva 海报类需求收敛成 Agent 可执行的官方接入流程：鉴权、步骤、异常与反模式写进 Skill，而不是每次临时搜文档。若你要安装或查看元数据，可使用以下官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_af163eaa/z-ping-mian-she-ji-zhu-shou
• API 坐标页：https://api.skillhub.cn/user_af163eaa/z-ping-mian-she-ji-zhu-shou