schedule-social

/digital-marketing-pro:schedule-social

脚本位置。 如果宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 并列。请使用 Python 3.10 或更高版本运行：使用 python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

将社交媒体帖子安排到一个或多个平台，并针对各平台进行格式调整、优化发布时间、制定主题标签策略和设置互动监控。根据单份内容简报生成适合多平台发布的定制版本，遵循各平台的字符数限制、媒体规格和受众惯例，同时在所有渠道保留核心信息。

执行关卡（强制 — 不可跳过）

1. 在接触任何线上系统之前，先提供完整预览——接收方／支出／变更／合规事项——作为执行摘要。
2. 用户必须输入 yes（或明确表示批准的同义内容）。任何其他输入——含糊、暗示、部分或未批准——都会取消本次运行。
3. 不得根据含糊的输入继续执行。执行失败后不得自动重试；再次运行前必须由人工审核失败原因。
4. 只有在用户输入 yes 后，才能记录批准：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"schedule-social","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'，然后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}。任一命令报错，都必须停止并报告错误；不得改用其他工具绕过。如果记录存在，即可证明此操作已执行批准步骤，但无法证明是谁输入了 yes。
5. 执行操作。通过 connector_executor.py 发送的写入操作需要 --approval-id，且只有匹配的、未使用且未过期的记录才能触发（参见 /digital-marketing-pro:execute-action）。通过已连接的 MCP 服务工具执行的写入操作不受该代码检查约束：这类操作依赖用户输入的 yes 以及宿主的权限提示。执行后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（或 failure）。

所需输入

用户必须提供（或系统会提示用户提供）：

• 帖子内容：核心消息文本，以及要附带的图片、视频、轮播素材或链接；可以是统一的草稿，也可以是针对各平台预先撰写的版本
• 目标平台：要发布到哪些平台——Twitter/X、Instagram（动态、快拍、Reels）、LinkedIn（帖子或文章）、TikTok、YouTube（Shorts 或社区）或 Pinterest；必须已连接相应的 MCP 服务
• 发布日期和时间：为各个平台指定具体日期和时间及其时区，或填写“optimal”，以便根据受众互动模式使用数据驱动的时间建议
• 话题标签：指定要使用的话题标签、提供主题以自动推荐，或填写“auto”，根据内容分析、热门标签和品牌话题标签策略生成话题标签
• 平台专属变体：针对各平台的调整，例如不同的文案长度、图片或宽高比、行动号召、语气调整或平台原生功能（Instagram 投票、LinkedIn 文档轮播、Twitter/X 话题串）
• 链接和 UTM 参数：要附带的 URL 及其 UTM 跟踪参数（source、medium、campaign、content），用于归因；也可以根据品牌资料中的活动命名规范自动生成 UTM 参数
• 媒体素材：图片文件或 URL，以及各平台的宽高比偏好；符合时长要求的视频文件；或按发布顺序排列的轮播图片集
• 互动说明：是否设置回复监控、评论回复指南、互动提升触发条件（互动超过阈值时推广），或跨平台同步发布规则
• 内容日历背景：可选——帖子所属的活动名称或内容支柱，用于日历跟踪，并确保整个发布计划的主题一致
• 无障碍要求：图片替代文本、视频字幕或字幕文件，以及任何无障碍专用格式要求（通俗易懂的语言、高对比度文字叠加）
• 首条评论或话题串：可选——在主帖发布后立即发布的后续评论（用于话题标签的 Instagram 首条评论、Twitter/X 话题串续帖或 LinkedIn 互动提示）
• 地理定向：可选——在平台支持的情况下，将帖子可见范围限制在特定地区或语言（LinkedIn 地理定向、Facebook 位置定向）
• 交叉推广引用：可选——帖子中要包含的其他平台相关内容引用（例如“在 YouTube 上观看完整视频”或“在我们的博客上阅读完整文章”）
• 提及和标记：可选——根据各平台的标记规范，在帖子中通过 @提及或标记的账号（合作伙伴、协作者、网红、被推荐的客户）

流程

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前启用的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景信息。还要检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南；如果存在，则加载限制要求。检查 ~/.claude-marketing/sops/ 中是否有代理机构 SOP。如果没有品牌，请询问：“先设置品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 验证已连接的社交平台 MCP：检查已连接的社交媒体平台 MCP 服务，并确认它们涵盖用户指定的所有平台。列出任何缺失的连接及其设置说明。确认每个平台的 API 权限都包含排期发布功能。
3. 按平台规范设置内容格式：根据各平台的要求调整内容——查阅 skills/context-engine/platform-publishing-specs.md，了解字符数限制（Twitter/X：280，LinkedIn：3,000，Instagram：2,200，TikTok：2,200，Pinterest：500）、图片尺寸（1:1、4:5、9:16、16:9）、视频时长上限、轮播图页数限制和链接预览行为。如果内容无法在各平台间原样共享，则创建不同版本。
4. 优化发布时间——优先使用品牌数据：如果品牌有帖子级互动历史（从平台分析数据导出：每条帖子的时间戳和互动数据），将其写入 JSON 文件，并运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/posting-time-analyzer.py" --platform {platform} --history {file}——该脚本会按排名返回第一方数据的时间窗口，并附上样本量；只有这些建议可以获得高置信度。没有历史数据时，使用 --platform {platform} --industry {industry} --audience-type {b2b|b2c|mixed} 运行脚本，以获取带日期的人群基准数据（输出中含 baseline_as_of 和最高为中等的置信度上限；基准数据过时则会以退出码 3 拒绝运行——请刷新数据或提供历史记录）。展示输出中的 algorithm_note——在基于兴趣排序的信息流中，内容质量比发布时间更重要。还要考虑受众所在时区的分布。
5. 分析并优化主题标签：运行 hashtag-analyzer.py，评估拟用主题标签的覆盖潜力、竞争程度、相关性评分和趋势状态。为每个平台推荐均衡的主题标签组合——品牌主题标签、细分社群主题标签和广泛覆盖主题标签，并采用平台特定的数量（Instagram：15-20 个，Twitter/X：2-3 个，LinkedIn：3-5 个，TikTok：4-6 个，Pinterest：2-5 个关键词标签）。
6. 评估内容与品牌语气的一致性：对每个平台的内容版本运行 brand-voice-scorer.py，确认内容符合品牌语气、词汇和消息指南。标记低于品牌最低评分的版本，并提出具体修改建议。
7. 为各平台创建不同版本：如果用户未提供明确的分平台文案，则生成针对各平台的版本——Twitter/X 文案更短、更有冲击力；LinkedIn 文案专业且注重洞见；Instagram 文案以视觉为先，并通过换行提升可读性；TikTok 文案轻松随意且紧跟趋势；Pinterest 文案富含关键词并搭配竖版图片。所有平台都要保留核心信息和 CTA，同时适应各平台的原生风格。
8. 验证媒体素材：确认所有图片和视频均符合平台要求——尺寸、宽高比、文件大小限制、视频时长和格式（图片用 JPEG/PNG，视频用 MP4）。标记需要调整尺寸或转换格式的素材，并建议各平台的最佳裁剪方式。
9. 创建审批记录：通过 approval-manager.py --action create-approval 创建记录，并在 --data JSON 中包含风险级别——{"type":"schedule-social","platform":"<platform>","content_summary":"...","risk_level":"medium"}。没有 --risk-level 标志；确切命令请参阅上文的 Execution gate。生成排期摘要，展示每个平台的帖子内容、媒体预览、主题标签、发布时间、带 UTM 标记的链接和品牌语气评分。
10. 展示排期摘要：向用户展示完整的多平台排期以供审核——每个平台单独列出一节，包含最终文案及字符数、媒体附件及其尺寸、主题标签、带时区的发布时间，以及平台特定备注或警告。等待用户明确批准。
11. 通过各平台的 MCP 服务排期：获得批准后，通过已连接的 MCP 服务将每条帖子提交至对应平台。处理各平台特定的排期 API、媒体上传、主题标签格式和链接缩短。分别确认每个平台的排期状态。
12. 验证排期状态：排期后，查询各平台 API，确认帖子已按正确时间和内容进入队列。标记任何排期失败、内容截断或媒体上传错误；仅当能证明写入请求从未到达平台时才重试（连接被拒绝、DNS 失败或因 429 速率限制而被拒绝）；超时或响应丢失后，先在平台上查询记录（帖子是否已在平台队列中？），只重新排期缺失的帖子；否则上报处理。
13. 排期首条评论或帖子串：如果用户提供了首条评论内容，则为每个适用平台排队安排后续评论或帖子串续帖，在主帖发布后立即发布。
14. 更新内容日历：将已排期的帖子记录到品牌内容日历中，注明活动名称、内容支柱、平台和发布时间，以便跨渠道查看并防止重复发布。
15. 按平台记录执行情况：针对每个平台运行 execution-tracker.py，记录排期事件及其时间戳、平台、计划发布时间、内容摘要、主题标签、UTM 参数和媒体素材引用。

输出

结构化的排期确认，包含：

• 已排期帖文确认：按平台提供确认信息，包括帖子 ID、带时区的排期日期和时间，以及可用时的预览链接或草稿 URL
• 平台专属内容：各平台的最终文案，显示字符数与上限、话题标签及其位置（正文内或评论中）、媒体附件及其尺寸，以及带 UTM 参数的链接
• 发布时间及理由：各平台的排期时间及数据驱动的依据——历史互动高峰时段、与受众时区的匹配情况、竞争对手发帖时段分析，或用户指定的时间
• 话题标签建议：各平台的最终话题标签集及其支持指标——每个话题标签的预估覆盖人数、竞争程度、热门状态和相关性评分
• 品牌语调评分：各平台的契合度评分，并备注创建不同版本时所做的语气调整及任何后续建议
• 媒体规格合规性：确认所有图片和视频均符合平台对尺寸、文件大小、格式、宽高比和视频时长的要求，并说明所做的裁剪或调整
• UTM 跟踪摘要：各平台完整的 UTM 参数（来源、媒介、广告系列、内容），用于在 Google Analytics 或品牌的分析平台中进行归因跟踪
• 跨平台协调备注：如帖文分时发布，说明发布顺序的理由；并列出平台间的交叉推广内容（例如 Twitter/X 帖子中包含“在 YouTube 上观看完整视频”的链接）
• 无障碍合规性：确认所有图片均已添加替代文本，视频均已附带字幕文件，并已核验各平台内容采用浅白易懂的语言，便于无障碍访问
• 首条评论或帖子串状态：确认各平台已排期的后续评论，并提供内容预览和发布时间（主帖发布后立即发布）
• 内容日历位置：广告系列名称、内容主题和日历日期，以便与品牌的发布计划交叉参照
• 已应用的提及和标记：确认各平台已添加所有 @提及和账号标记，并说明账号句柄的核验状态
• 执行日志条目：按平台记录带时间戳的信息，用于审计跟踪、内容日历同步和跨渠道排期协调

使用的 Agent

• social-media-manager — 按平台惯例排版内容、优化发布时间、制定和分析话题标签策略、评估品牌语调、创建平台专属版本、验证媒体素材、确保无障碍合规、安排首条评论，以及配置互动监控
• execution-coordinator — 管理审批工作流、通过 MCP 服务执行多平台排期、核验各平台状态、安排首条评论和帖子串、更新内容日历、仅对可确证从未提交至平台的写入操作进行重试，以及记录各平台的执行日志