当已批准的内容 brief 要一键执行成完整营销…

把已批准的 brief 按五阶段执行成完整 campaign：社交渠道生成 Canva 设计并排期到 HubSpot，邮件只写纯文本供 owner 自行发送，所有步骤需 owner 明确批准。

适用场景

解决思路

1. 按五阶段顺序执行，每阶段由 owner approval gate 控制：brief → calendar → asset inventory → Canva designs → copy → HubSpot staging。
2. 明确路径：Canva (social) 仅用于 Instagram、Facebook、X/Twitter、LinkedIn，产出 Canva design + caption + scheduled HubSpot post；Text-only 用于 Email（newsletter、marketing、drip），产出 subject + preheader + body，内联展示供 owner 从自己的工具发送。
3. Canva 绝不用于 email rows，任何情况下都不：no templates、no autofill、no design copies、no asset uploads、no exports。Email graphics 超出本 skill 范围；若 owner 要求 Canva email design，使用 reference/gotchas.md 中的 redirect language。
4. Pre-flight 第 1 步：开始 Stage 1 前确认用户已引用或粘贴已批准的 brief。若没有，询问：「I'll need the content brief before I can build the campaign. Do you have one from the content-strategy skill, or would you like to write one now?」
5. Pre-flight 第 2 步：确认 Canva tier。Pro/Teams 需要从用户模板库手动选择模板（无 autofill API）。Enterprise 可从品牌模板 autofill。
6. Pre-flight 第 3 步：确认 HubSpot tier。Social staging 需要 Marketing Hub Professional。Starter 或 Free → 跳过 Stage 5，改为导出 CSV（见 reference/hubspot-staging.md）。
7. Pre-flight 第 4 步：若有店面连接（Shopify 或 Square — peers，../../shared/connector-neutrality.md），先读取商品列表：brief 提到的每个商品的标题、图片 URL、价格。只读；直到 Stage 2 step 5 才上传到 Canva，且只上传已批准日历槽位需要的图片。该列表作为起始照片库存；只询问店铺没有图片的商品。拉取规则（哪些字段、价格声明规则）见 ../social-content-engine/reference/shopify-assets.md（以 Shopify 写；Square 的目录图片按工具库存同样步骤）。若无店面，确认磁盘上产品照片路径或 Canva 中品牌套件已上线。
8. Pre-flight 第 5 步：估算 campaign 的 Canva 生成量并在 Stage 1 前展示。默认每个 Canva-bound row 3 个候选；每个设计约 5 次 API 调用（autofill + export + polling）。展示预算模板，包括 Canva (social) rows、Candidates per row、Total designs、API calls (approx)、Canva limit: 100 requests/minute、预计耗时，并询问是否继续。若预计总设计数超过 30，预先推荐 single-candidate mode。Owner 可在 Stage 1 开始前把默认覆盖为 1、2、3 个候选/行；整个 session 锁定所选值。
9. Stage 1：从 brief 提取 content themes、channels、cadence、hard dates（launches、sales、holidays）。
10. Stage 1：构建 calendar table，包含 Date、Channel、Path、Theme、Asset type、Caption/Subject angle 列；Path 路由每行到 Canva 或 text-only drafting。
11. Stage 1：在展示前把每个 email-channel row 标记为 Text-only；除非 brief 另有指定，最多 30 天；预先标记 scheduling conflicts（同一天同一产品两条帖子）。
12. Stage 1 Checkpoint 1：展示 calendar，询问：「Does this match the plan? Any dates to shift, channels to add, or themes to swap?」迭代直到批准；然后 move on 前口头复述拆分：「N rows go through Canva, M rows go through text-only drafting」。在这里发现错误分类成本很低；生成设计后发现成本很高。
13. Stage 2：Email rows 完全跳过 Stage 2。对每个 Canva (social) row，建立 manifest，说明模板需要什么和已有什么。
14. Stage 2 step 1：按名称枚举每个 image slot。Square Instagram posts 通常有 1-2 个 image slots；carousels 和 product grids 可有 5+。逐个列出（Header_Image、Product1_Image、Product2_Image、…），绝不合并成「product images」。Enterprise：从品牌模板的 dataset[].label 读取字段名（GET /v1/brand-templates/{id}）。Pro/Teams：数模板中每个不同 image rectangle。
15. Stage 2 step 2：Inventory available assets。包括 brief 中的文本内容（product names、offer copy、taglines、pricing）；pre-flight 时从连接店面读取的 product image URLs（在 step 5 上传，仅用于 gap table 需要的 slots，并按 asset.id 记录）；已上传到 Canva（GET /v1/assets）或在 owner 磁盘上的 product photos；brand kit colors and fonts（Enterprise）。caption 中的价格来自店面返回值或 brief，绝不凭记忆。
16. Stage 2 step 3：构建 slot-by-slot gap table。每个设计每个 slot 一行，不是每个设计一行。列：Date、Slot name、Slot kind、Available asset、Status。
17. Stage 2 step 4：与 owner 解决 slot/asset 不匹配。如果模板 image slots 多于 brief 提供的照片，暂停并询问，给出 3 个选项：1. Reuse the same photo across all 5 slots；2. You send me 4 more photos（file paths）；3. Pick a simpler template with fewer slots。在 owner 选之前不做 generation calls。用空 slots 生成会产生 Canva 默认 landscape placeholders。
18. Stage 2 step 5：上传缺失照片并捕获 verified asset IDs。通过 POST /v1/asset-uploads 上传，然后轮询 GET /v1/asset-uploads/{job_id} 直到 status == "success"。记录响应中的 asset.id — 这是 autofill image field 唯一可用的值。传空字符串、URL、文件路径或 stale ID 会静默渲染 Canva stock landscape graphic 而非照片。
19. Stage 2 step 6：确认 manifest。向 owner 展示完成的 slot-by-slot table，每个 slot 已解决，每个 image asset.id 已确认。这是 Canva API calls 前最后一站。
20. Stage 3：在任何 Canva API call 前，重新阅读 calendar，删除 Path 不是 Canva (social) 的行。Email rows 不经过此 stage。
21. Stage 3：一次只生成一个 calendar row 的设计，每行 3 个候选（或 pre-flight 选的值）。每行相同循环：generate candidates → verify → export → visually check → retry failures → present → wait for owner pick → next row。行之间暂停 30 秒。将 burst 限制在每约 30s 3 generations + 3 exports，远低于 Canva 100 req/min rate limit。不要并行多行；一次一行是防止 owner 在 campaign 中途触及 quota 的保护。
22. Stage 3 Polling cadence：每 3-5 秒轮询 job status，不要更快。更紧间隔消耗 quota 且不会加快完成。
23. Stage 3 Preview URLs：只有永久 export URLs 安全嵌入。Autofill responses 返回 design.canva.ai thumbnails，几分钟内过期；作为 markdown images 嵌入会产生 broken 「Show Image」 placeholders。永久 export URLs（export-download.canva.com 或 export-design MCP tool）不过期。Native Cowork carousels 使用 connector 的 authenticated session 直接渲染 autofill result — 让它们自行渲染，不要重新嵌入。
24. Stage 3 Row loop step 1：解析模板（每 session 一次 — 除非 calendar 混合 asset types，行间同模板）。Enterprise：GET /v1/brand-templates 按 asset type 过滤。Pro/Teams：GET /v1/designs?ownership=any&query={template name}，向 owner 展示 top 3，生成前确认一个。
25. Stage 3 Row loop step 2：并行生成该行候选。同时触发该行 3 个候选（或 pre-flight 的 N）。Enterprise：每个候选 POST /v1/autofills，带 template ID 和 field values；并发轮询所有 jobs。Pro/Teams：POST /v1/designs 创建副本；描述 owner 在 Canva 中应用哪些文本和图片编辑；收集 design IDs 回来。
26. Stage 3 Row loop step 3：验证 job status。每个候选确认 GET /autofills/{job_id} 返回 status == "success" 且 result.design.id 存在。按设计处理错误：JOB_FAILED → 读 job.error.message，修复 field values 或 asset IDs，重试一次。RATE_LIMIT_EXCEEDED（本 session 第一次）→ 等 60s，重试该候选一次，处理 transient spikes。RATE_LIMIT_EXCEEDED（本 session 第二次）或任何 quota_exceeded / daily-cap error → 立即停止生成。不要重试。展示进度并询问，给出 3 个选项：1. Switch to 1 candidate per remaining row（4 designs total）— finishes now；2. Pause campaign — resume in 60 minutes when quota refills；3. Stop generation — work with what we have, move to captions。等待 owner 选择。不要 loop on retry。
27. Stage 3 Row loop step 4：将每个成功候选导出为 permanent PNG。并行触发该行 exports。REST：POST /v1/exports，format.type: "png"，轮询 GET /v1/exports/{job_id} 直到 success，捕获 urls[0]。Canva MCP：export-design 带 design ID。这些永久 URL 之后嵌入 previews 并附加到 HubSpot post。autofill response thumbnail 绝不下游使用。
28. Stage 3 Row loop step 5：视觉验证每个 export。查看图像并拒绝这些：generic landscape with clouds and green hills（Canva 默认 placeholder）；solid gray rectangles where a photo should be；Lorem-ipsum 或 template-default text；subject 与 brief 不符（wrong product、wrong brand）。若候选验证失败：重新检查受影响 slot 的 manifest，修复 asset.id，只重新生成该单个候选，重新导出，重新验证。
29. Stage 3 Row loop step 6：部分失败时按候选重试。如果行中 N 个候选中 1 个在 Step 3 或 5 失败，只重新生成那一个 — 不要重做整行，不要展示部分损坏的 carousel。如果第二次尝试也失败，询问 owner 3 个选项：1. Skip it — present the other 2 and move on；2. Swap to a simpler template for just this candidate；3. Try once more with a different photo。
30. Stage 3 Row loop step 7：展示该行候选。让 native Cowork carousel 渲染 autofill tool result。在下方加文字提示：「Jun 9 candidates are ready — scroll through the carousel above. Which one should I use for the Jun 9 post?」如果 carousel 不渲染或某个位置损坏，改用 Step 4 的 permanent export PNG URLs 嵌入。最终 fallback：链接到 design 的 Canva edit URL（https://www.canva.com/d/{design_id}）。绝不重新嵌入 design.canva.ai URLs。
31. Stage 3 Row loop step 8：暂停 30 秒，然后进入下一行。
32. Stage 3 Checkpoint 2：当 owner 已为每个 calendar row 选好一个设计即满足。若他们想重新生成，只重新生成那一个候选。
33. Stage 4：对每个 calendar row 起草 copy。Social rows 得 caption；email rows 得完整 email。
34. Stage 4 Social captions — Instagram、Facebook、X、LinkedIn：长度符合频道（Instagram ≤ 2,200 chars；Facebook ≤ 500 recommended；X ≤ 280）。结构：hook → one product benefit → CTA → 3-5 hashtags（not 30）。Voice：匹配 brief 的 tone markers。若 brief 说「casual and friendly」，不要写 corporate copy。No filler。不要用「Exciting news!」或「We're thrilled to announce.」用价值开头。
35. Stage 4 Email content — Claude 写整个 email；不用 Canva：Subject ≤ 50 chars，specific，no clickbait。例如「Spring projects are booking up」优于「Don't miss out!」。Preheader ≤ 90 chars，补充 subject 不重复。Body：plain prose，100-250 words。开头赢得阅读 → 1-2 段实质内容 → 单一清晰 CTA → sign-off。Voice：与 social 相同 tone markers。Owner 希望 email 听起来像他们，而不是 templated newsletter。No image references。不要写「see image above.」如果 owner 想要 visuals，他们在自己的 email tool 添加。每封 email 一个 CTA。选最重要行动并 lead with it。
36. Stage 4：在每个 social row 下方内联展示 captions。在每个 email row 下方内联展示完整 emails，格式为 Subject、Preheader、body 文本。参考 reference/examples/boutique-brief-campaign.md 的 worked examples。
37. Stage 4 Checkpoint 3：询问：「Any captions or emails to rewrite? Flag the date and what to change.」迭代直到批准。
38. Stage 5：在 HubSpot 排期 social posts。Email content 不排期 — 内联展示供 owner 复制到自己的 email tool。API field reference 见 reference/hubspot-staging.md。
39. Stage 5 step 1：创建 campaign。POST /marketing/v3/campaigns，带 campaign name 和来自 calendar 的 start/end dates。
40. Stage 5 step 2：排期每个 social post。对每个 Canva (social) row POST 到 HubSpot Social API：channel 映射 calendar channel 到 HubSpot account ID；scheduledAt 用 ISO 8601 datetime — 调用前确认在未来；content.body 用 approved caption；attachments 用 Stage 3 的 permanent Canva export PNG URL；status 用 SCHEDULED（绝不用 PUBLISHED）。
41. Stage 5 step 3：确认队列。调用 GET /marketing/v3/social/posts?status=SCHEDULED，展示列表，提供 HubSpot campaign view 的直接链接。
42. Stage 5 step 4：为 handoff 展示 email content。对每个 email row，按 send date 分组内联展示 approved subject + preheader + body。Owner 复制到他们的 email tool（HubSpot Marketing Email、Mailchimp、Gmail 或 M365）。
43. Stage 5 Final checkpoint：展示「Your social posts are scheduled in HubSpot: [link] They'll go out as scheduled — you can cancel or edit any post in HubSpot. Email content is drafted below — copy each into your email tool when you're ready to send: Jun 5 — Spring projects are booking up；Jul 15 — Summer maintenance windows are filling. Anything to change before we're done?」同时（绝不替代）按 house style（../../shared/artifact-style.md）把 campaign 渲染为 HTML artifact：posting calendar 作为 table，每行 per-channel status pill（scheduled / drafted / handoff），每行 staged-post panel 含 approved caption 或 email copy 及其 export PNG link。
44. Stage 5 Closing offer：一句话说明 campaign 现在包含什么，然后给单个最相关下一步及 trigger phrase — 通常「is my marketing working?」（growth-pulse）在帖子开始发出后。最多两个其他：「make the content」（social-content-engine）用于 standing calendar，或「my ads」（ad-manager）。最多三个；绝不再 offer owner 本 session 已拒绝的东西。
45. Approval gate：No Canva calls for email rows。每次 API call 前重新检查 Path 列。
46. Approval gate：No publishing。每个 HubSpot post staged as SCHEDULED；owner 控制 go-live。
47. Approval gate：Always surface the generation budget at pre-flight。Owner 在 Stage 1 前看到 total design count 并批准。
48. Approval gate：One row at a time in Stage 3。行内候选并行，但行是顺序的，有 30s gap — quota protection。
49. Approval gate：On the second quota error, pause and ask。Never loop on retry。
50. Approval gate：Always export to permanent PNG before presenting。Job success 不代表设计渲染正确。
51. Approval gate：Never embed design.canva.ai URLs in messages。它们会过期。
52. Approval gate：Never regenerate the whole row when one candidate fails。仅 per-candidate retry。
53. Approval gate：Never auto-select a template for Pro/Teams users。总是确认。
54. Approval gate：Never skip slot-by-slot inventory。多 slot 模板任一 slot 空时会渲染 placeholder landscapes。
55. Approval gate：Never skip Checkpoint 1。Calendar 批准前生成是该 skill 中最大浪费工作来源。
56. Reference：reference/canva-api.md（Canva Connect API endpoints、asset upload、export formats、MCP equivalents）；reference/hubspot-staging.md（HubSpot Social API 和非 Pro tiers CSV fallback）；reference/gotchas.md（常见失败模式的 Good/Bad patterns）；reference/examples/boutique-brief-campaign.md（完整 worked examples：single-slot social、multi-slot template）。
57. 使用未列出的工具：如果 owner 想用未连接或未列出的工具，提供 build-connector — 它先检查 connector directory，否则通过 Zapier 连接，绝不手写 raw API。连接存在后，该工具像任何其他 optional connector 一样加入此 skill，并遵守相同 approval gates。

适用边界 · 注意事项

• 没有已批准 brief 的日常发帖场景不要用此 skill；例如「I need to post more」「what should we post」应改用 social-content-engine，它拥有 standing calendar。
• 不要用此 skill 生成 Canva email 设计；email graphics 明确超出范围，应按 reference/gotchas.md 重定向。
• 需要自动发布而非 staged 排期时不要用此 skill；HubSpot posts 始终设为 SCHEDULED，由 owner 控制 go-live。