需要端到端使用 Pippit.ai 生成/编辑视频…

适用于通过 Pippit.ai 从提示词或参考素材生成视频并下载，再发布或排期到 TikTok/Facebook Page/Instagram，以及管理发布任务和查看分析。

适用场景

解决思路

1. 将 {baseDir} 解析为本技能目录；使用本地 scripts/nest/（生成、编辑、参考上传、进度轮询、结果下载）和 scripts/publish/（社媒账号查询、视频上传、定时发布、任务 CRUD、分析），不需要外部 Pippit 技能目录。
2. 需要详细发布 payload 字段时先读 references/publishing-api.md。
3. 让 Pippit Nest 负责创意解读、提示词扩展、模型选择、分镜和工作流路由；本地 agent 只上传参考、原样传递用户请求、轮询进度、处理澄清、下载结果，并在需要时发布所选视频。
4. 仅创意生成时，使用 scripts/nest/ 生成/编辑、轮询并下载输出；返回本地文件后停止，除非用户要求发布。
5. 仅发布时，使用 scripts/publish/ 处理已有本地视频、已绑定账号检查、排期、任务 CRUD 或分析。
6. 创建后再发布时，先用 scripts/nest/ 生成，下载生成的视频，再用 scripts/publish/ 上传并排期。
7. 仅图片输出时，发布只支持视频；如果用户想发布图片/海报，先询问是否要生成或转换为视频。
8. 创意请求处理时，将用户的创意或编辑请求原样传给 scripts/nest/submit_run.py --message；除非用户明确要求，不要压缩、总结、改写、润色、翻译、拆分或添加提示词语言。
9. 保持一个创意任务对应一次 Nest 提交；除非用户明确要求，不要把单个请求拆成按镜头、按场景或按素材的多次运行。
10. 不要本地手写分镜、推断镜头计划、分析风格、选择模型或编排子提示词；让 Pippit Nest 做这些工作。
11. 提供参考图片或视频时，上传它们并将返回的 asset ID 与原始请求一起提交；不要用自己的参考描述替换用户措辞。
12. 当 Pippit 要求澄清或交互时，把问题展示给用户，并将用户答案提交到同一个 thread_id；不要替用户回答。
13. 创建和发布使用同一个 Pippit access key；按顺序解析：PIPPIT_ACCESS_KEY、PippitAccessKey、本地缓存 $CODEX_HOME/pippit-skill/secrets.json。
14. 使用本地保存脚本保存新 key：python3 {baseDir}/scripts/nest/save_access_key.py --access-key "..."。
15. 不要编造、检索或回显完整 access key。
16. 如果没有可用 key，用英文回复："No Pippit access key is configured. Please get one from https://www.pippit.ai, then provide it or save it before continuing."
17. 收集最小缺失输入：创意请求及任何参考图片/视频文件、目标平台 TikTok/Facebook Page/Instagram、已绑定平台账号、标题或 caption、发布模式（默认发布，除非用户明确要求定时发布）、定时发布时带时区的发布时间。
18. 进行 Pippit 生成/编辑时，告诉用户会消耗 credits，并在调用 submit_run.py 前等待明确确认。
19. 提供参考文件时，用 scripts/nest/upload_file.py 逐个上传。
20. 将用户原始创意请求作为单个 scripts/nest/submit_run.py --message 值提交，存在上传素材时带上 asset IDs。
21. 返回 web_thread_link 时展示它，然后用 scripts/nest/get_thread.py 同时使用 thread_id 和 run_id 轮询。
22. 如果 Pippit 要求澄清或交互，把问题展示给用户，并把他们的答案提交到同一个 thread。
23. 用 scripts/nest/download_results.py 下载生成结果 URL。
24. 选择要发布的生成视频文件；如果存在多个视频且用户未指定，询问用户选择。
25. 用 scripts/publish/list_user_platform_account.py 列出已绑定社媒账号；如果没有可用账号，停止并引导用户在 Pippit 上绑定。
26. 用 scripts/publish/upload_file.py 上传最终本地视频。
27. 如果用户没有提到排期，按默认发布处理；不要要求用户选择发布模式。
28. 默认发布时，将其转换为明确的近期定时时间：除非用户要求不同的短延迟，否则默认为当前本地时间加 5 分钟，并向上取整到下一分钟；定时发布时，要求带时区的明确绝对发布时间。
29. 复述平台、账号、视频文件、caption/标题、发布模式和绝对排期时间；仅在平台/账号/视频/caption 缺失或模糊，或用户要求定时发布但未提供具体时间时等待确认；不要仅因为默认发布模式或其近期排期时间是推断的就询问。
30. 用 scripts/publish/batchcreate_schedule_task.py 创建定时任务；Pippit 发布只有 scheduled-only，绝不要声称存在立即发布路径。
31. 返回 task IDs/statuses、生成的本地文件路径和 Pippit thread link；如果使用了默认发布，简要说明也支持定时发布。
32. 使用 references/command-map.md 查完整命令示例；常用命令包括：python3 {baseDir}/scripts/nest/submit_run.py --message "Create a product video..."，python3 {baseDir}/scripts/nest/get_thread.py --thread-id THREAD_ID --run-id RUN_ID --after-seq 0，python3 {baseDir}/scripts/nest/download_results.py --urls URL1 URL2 --output-dir ./pippit_output --prefix artifact，python3 {baseDir}/scripts/publish/list_user_platform_account.py，python3 {baseDir}/scripts/publish/upload_file.py /path/to/video.mp4，python3 {baseDir}/scripts/publish/batchcreate_schedule_task.py --platform tiktok --platform-user-id PLATFORM_USER_ID --asset-id ASSET_ID --title "TITLE_OR_CAPTION" --schedule-time "2026-05-15T20:00:00+08:00"。
33. 通过 scripts/publish/ 只发布视频。
34. 将未指定发布模式视为默认发布；默认发布意味着“尽快发布”，但仍必须实现为近期定时任务。
35. 没有平台账号、caption/标题、发布模式和明确绝对排期时间时不要排期；默认发布时，在创建任务前计算绝对近期排期时间。
36. 成功创建默认发布任务后，添加简短说明：也支持定时发布。
37. 排期前，把相对日期如 "today"、"tomorrow"、"next Friday" 解析为绝对日期。
38. 针对 TikTok、Instagram 或 Facebook 的特定设置，使用脚本 flags 和 JSON override 选项；不要猜测复杂平台 payload，先读 references/publishing-api.md。
39. 一次 batch create 调用最多支持 10 个任务；更大的批次要有意拆分。
40. 要更新、删除或列出定时任务，使用 scripts/publish/ 任务脚本，并在查询中保留 platform 加 platform_user_id。
41. 要分析已发布帖子，使用 scripts/publish/list_videos.py，并在可用时总结 title、platform、publish time、views、likes、comments、shares 和 engagement rate。
42. 要在发布前优化生成素材，用 scripts/nest/submit_run.py --thread-id 继续同一个 Pippit Nest thread。
43. 保持面向用户的回复简洁，但包含所需操作标识符。
44. Nest 生成输出：thread_id、run_id、web_thread_link、下载的本地文件。
45. 发布输出：platform、platform_user_id、上传的 asset_id、task IDs、task status、scheduled time。
46. 分析输出：platform、account、video title、publish time、核心指标。
47. 除非相关本地脚本返回成功，否则绝不要声称生成、上传或发布任务成功。

适用边界 · 注意事项

• 没有配置 Pippit access key，或没有 Pippit 账号/已绑定社媒账号时不要使用。
• 只想发布图片/海报时不要直接发布；Pippit 发布仅支持视频，需先转为视频。
• 需要立即发布时不要使用；Pippit 发布是 scheduled-only，只能创建近期定时任务。