Skill Publish Scheduler Agent Skill

批量定时发布排期

> 管理一张排期表（内容×平台×时间），到点把任务派发给各平台发布 SKILL。走

> scripts/publish_queue.py（纯标准库）。本 SKILL 负责调度与状态，实际发布委派各平台 publisher

> （skill-xhs-publisher / skill-douyin-upload / skill-wechat-publisher / skill-bilibili-upload / cross-platform-publish）。

输入

排期表 CSV（表头需含 publish_at, platform, content，可选 title, note）：

publish_at,platform,content,title
2026-08-01 09:00,xiaohongshu,outputs/note1,早间笔记
2026-08-01 20:00,douyin,outputs/主题名/final.mp4,晚间视频

或等价 JSON。

执行

脚本路径（相对项目根）：skills/openclaw/skill-publish-scheduler/scripts/publish_queue.py（各子命令 -h）。

Q=outputs/publish-queue/q.json
python <skill>/scripts/publish_queue.py import --file plan.csv --queue $Q   # 导入排期
python <skill>/scripts/publish_queue.py list  --queue $Q                    # 查看队列
python <skill>/scripts/publish_queue.py due   --queue $Q                    # 此刻到期项
python <skill>/scripts/publish_queue.py run   --queue $Q                    # 打印到期派发计划
# 按计划逐条委派对应平台 publisher 发布，完成后回填：
python <skill>/scripts/publish_queue.py mark  --queue $Q --id 1 --status done

到期派发流程（编排）

• due/run 得到此刻到期项。
• 对每条到期项：按 platform 委派对应发布 SKILL 执行真实发布

（单平台或用 cross-platform-publish）。发布前按平台适配内容格式。

• 发布成功/失败后 mark 回填状态（可配合 skill-publish-notify 推送结果、skill-publish-log 记录）。
• 需要"守护式到点触发"时，由 OpenClaw 定时任务周期性跑 run（本脚本只做单次到期计算，不常驻）。

规则

• 本 SKILL 不直接驱动浏览器/API 发布——只做排期与状态管理，发布交给各平台 publisher。
• --now 可覆盖当前时间用于预演（查看某时刻会发哪些），不影响真实时间。
• 发布时间用 YYYY-MM-DD HH:MM；同一时刻多平台会一并到期。
• 每条发布后务必 mark，避免重复发布。
• 定时触发依赖上层（OpenClaw cron / 手动周期跑），本脚本是无状态到期计算 + 持久化队列。

参考来源

排期→到期计算→派发→状态回填是内容日历落地发布的标准闭环。调度与真实发布分层：

调度纯脚本（可测），发布委派各平台 publisher（环境相关）。