pippit-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Pippit Skill Workflow

Pippit Skill 工作流

Use this self-contained skill for overseas Pippit.ai workflows. It includes both backend script sets locally:

```
scripts/nest/
```
: Pippit Nest AI generation, editing, reference uploads, progress polling, and result downloads.
```
scripts/publish/
```
: Social account lookup, video upload, scheduled publishing, task CRUD, and analytics.

No external Pippit skill directories are required. For local commands, resolve

{baseDir}

to this skill folder. For detailed publishing payload fields, read references/publishing-api.md.

Pippit Nest owns creative interpretation, prompt expansion, model choice, storyboarding, and workflow routing. The local agent should only upload references, pass the user's request through, poll progress, handle clarification requests, download results, and then publish the selected video when requested.

使用这款独立Skill处理海外Pippit.ai工作流。它包含本地部署的两组后端脚本：

```
scripts/nest/
```
: Pippit Nest AI生成、编辑、参考素材上传、进度轮询及结果下载。
```
scripts/publish/
```
: 社交账号查询、视频上传、定时发布、任务增删改查（CRUD）及数据分析。

无需外部Pippit Skill目录。本地命令中，将

{baseDir}

解析为当前Skill文件夹。如需详细的发布负载字段，请阅读references/publishing-api.md。

Pippit Nest负责创意解读、提示词扩展、模型选择、故事板制作及工作流路由。本地Agent仅需上传参考素材、传递用户请求、轮询进度、处理澄清请求、下载结果，并在用户要求时发布选定视频。

Route the Request

请求路由

Creative only: Use
```
scripts/nest/
```
to generate/edit, poll, and download outputs. Stop after returning local files unless the user asks to publish.
Publish only: Use
```
scripts/publish/
```
for existing local videos, bound account checks, scheduling, task CRUD, or analytics.
Create-to-publish: Use
```
scripts/nest/
```
first, download the generated video, then use
```
scripts/publish/
```
to upload and schedule it.
Image-only output: Publishing supports video only. If the user wants to publish an image/poster, ask whether to generate or convert it into a video first.

仅创意生成/编辑：使用
```
scripts/nest/
```
完成生成/编辑、轮询及结果下载。返回本地文件后停止，除非用户要求发布。
仅发布：使用
```
scripts/publish/
```
处理本地已有视频、绑定账号校验、调度、任务增删改查或数据分析。
从生成到发布：先使用
```
scripts/nest/
```
生成并下载视频，再用
```
scripts/publish/
```
完成上传和调度。
仅图片输出：发布仅支持视频格式。若用户需发布图片/海报，询问是否先将其生成或转换为视频。

Creative Request Handling

创意请求处理

Pass the user's creative or edit request to
```
scripts/nest/submit_run.py --message
```
as-is. Do not compress, summarize, rewrite, polish, translate, split, or add prompt language unless the user explicitly asks.
Keep one creative task as one Nest submission. Do not turn a single request into per-shot, per-scene, or per-asset runs unless the user explicitly asks for separate runs.
Do not manually write storyboards, infer camera plans, analyze styles, choose models, or orchestrate sub-prompts locally. Let Pippit Nest do that work.
When reference images or videos are provided, upload them and submit the original request with the returned asset IDs. Do not replace the user's wording with your own description of the references.
When Pippit asks for clarification or interaction, show the question to the user and submit the user's answer to the same
```
thread_id
```
; do not answer on the user's behalf.

将用户的创意或编辑请求原样传递给
```
scripts/nest/submit_run.py --message
```
。除非用户明确要求，否则不得压缩、总结、改写、润色、翻译、拆分或添加提示词内容。
单个创意请求对应一次Nest提交。除非用户明确要求拆分任务，否则不得将单个请求拆分为单镜头、单场景或单资产运行。
请勿手动撰写故事板、推断镜头方案、分析风格、选择模型或在本地编排子提示词，这些工作交由Pippit Nest完成。
当提供参考图或视频时，上传素材并附带返回的资产ID提交原始请求。不得用自身对参考素材的描述替换用户的措辞。
当Pippit要求澄清或交互时，将问题展示给用户，并将用户的回复提交至同一
```
thread_id
```
；不得代表用户作答。

Access Key

访问密钥

Use one Pippit access key for both creation and publishing. Resolve it in this order:

```
PIPPIT_ACCESS_KEY
```
```
PippitAccessKey
```
Local cache at
```
$CODEX_HOME/pippit-skill/secrets.json
```

Save a new key once with either local save script:

bash

python3 {baseDir}/scripts/nest/save_access_key.py --access-key "..."

Do not invent, retrieve, or echo the full access key. If no key is available, respond in English: "No Pippit access key is configured. Please get one from https://www.pippit.ai, then provide it or save it before continuing."

创建和发布使用同一个Pippit访问密钥，按以下优先级解析：

```
PIPPIT_ACCESS_KEY
```
```
PippitAccessKey
```
本地缓存文件
```
$CODEX_HOME/pippit-skill/secrets.json
```

可通过以下任一本地保存脚本一次性保存新密钥：

bash

python3 {baseDir}/scripts/nest/save_access_key.py --access-key "..."

不得伪造、获取或回显完整访问密钥。若未配置密钥，用英文回复："No Pippit access key is configured. Please get one from https://www.pippit.ai, then provide it or save it before continuing."

End-to-End Flow

端到端流程

Collect the minimum missing inputs:
- Creative request and any reference image/video files
- Target platform: TikTok, Facebook Page, or Instagram
- Bound platform account
- Title or caption
- Publish mode: default publish unless the user explicitly requests scheduled publish
- For scheduled publish: scheduled publish time with timezone
For Pippit generation/editing, tell the user it consumes credits and wait for explicit confirmation before calling
```
submit_run.py
```
.
Upload reference files one by one with
```
scripts/nest/upload_file.py
```
when references are provided.
Submit the user's original creative request as a single
```
scripts/nest/submit_run.py --message
```
value, with uploaded asset IDs when present.

Show

web_thread_link

when returned, then poll with

scripts/nest/get_thread.py

using both

thread_id

and

run_id

If Pippit asks for clarification or interaction, show the question to the user and submit their answer to the same thread.
Download generated result URLs with
```
scripts/nest/download_results.py
```
.
Choose the generated video file to publish. If multiple videos exist and the user has not indicated one, ask them to choose.
List bound social accounts with
```
scripts/publish/list_user_platform_account.py
```
. If no usable account exists, stop and direct the user to bind one on Pippit.
Upload the final local video with
```
scripts/publish/upload_file.py
```
.
If the user does not mention scheduling, treat the request as default publish; do not ask the user to choose a publish mode.
For default publish, convert it into an explicit near-future scheduled time, defaulting to current local time plus 5 minutes rounded up to the next minute unless the user requests a different short delay. For scheduled publish, require an explicit absolute publish time with timezone.
Restate platform, account, video file, caption/title, publish mode, and absolute schedule time. Wait for confirmation only when the platform/account/video/caption is missing or ambiguous, or when the user asked for scheduled publish without providing a concrete time. Do not ask solely because default publish mode or its near-future schedule time was inferred.
Create the scheduled task with
```
scripts/publish/batchcreate_schedule_task.py
```
. Pippit publishing is scheduled-only; never claim an immediate publish path exists.
Return task IDs/statuses, generated local file paths, and the Pippit thread link. If default publish was used, briefly mention that scheduled publish is also supported.

收集必要的缺失输入：
- 创意请求及所有参考图/视频文件
- 目标平台：TikTok、Facebook Page或Instagram
- 绑定的平台账号
- 标题或文案
- 发布模式：默认即时发布，除非用户明确要求定时发布
- 定时发布：带时区的定时发布时间
进行Pippit生成/编辑前，告知用户该操作会消耗点数，并等待用户明确确认后再调用
```
submit_run.py
```
。
若提供参考素材，通过
```
scripts/nest/upload_file.py
```
逐一上传。
将用户的原始创意请求作为单个值传入
```
scripts/nest/submit_run.py --message
```
，若有上传的资产ID则一并附带。

web_thread_link

后，使用

thread_id

和

run_id

通过

scripts/nest/get_thread.py

轮询进度。

若Pippit要求澄清或交互，将问题展示给用户，并将其回复提交至同一线程。
通过
```
scripts/nest/download_results.py
```
下载生成结果的URL。
选择要发布的生成视频文件。若存在多个视频且用户未指定，询问用户选择。
通过
```
scripts/publish/list_user_platform_account.py
```
列出绑定的社交账号。若无可用账号，停止操作并引导用户在Pippit上绑定账号。
通过
```
scripts/publish/upload_file.py
```
上传最终本地视频。
若用户未提及调度，默认按即时发布处理；无需询问用户选择发布模式。
即时发布需转换为明确的近期定时任务，默认设置为当前本地时间加5分钟并向上取整到下一分钟，除非用户要求不同的短延迟。定时发布则需用户提供带时区的明确绝对时间。
重述平台、账号、视频文件、文案/标题、发布模式及绝对调度时间。仅当平台/账号/视频/文案缺失或模糊，或用户要求定时发布但未提供具体时间时，等待用户确认。不得仅因推断默认发布模式或其近期调度时间而要求确认。
通过
```
scripts/publish/batchcreate_schedule_task.py
```
创建定时任务。Pippit发布仅支持定时模式；不得声称存在即时发布路径。
返回任务ID/状态、生成的本地文件路径及Pippit线程链接。若使用默认即时发布，简要说明也支持定时发布。

Local Commands

本地命令

Use references/command-map.md for full command examples. Common commands:

bash

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"

完整命令示例请参考references/command-map.md。常用命令：

bash

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"

Publishing Rules

发布规则

Publish only videos through
```
scripts/publish/
```
.
Treat unspecified publish mode as default publish. Default publish means "publish soon" and must still be implemented as a near-future scheduled task.
Do not schedule without a platform account, caption/title, publish mode, and explicit absolute schedule time. For default publish, compute the absolute near-future schedule time before creating the task.
After successfully creating a default publish task, add a short note that scheduled publish is also supported.
Resolve relative dates such as "today", "tomorrow", or "next Friday" into absolute dates before scheduling.
For TikTok, Instagram, or Facebook-specific settings, use script flags and JSON override options. Do not guess complex platform payloads; read references/publishing-api.md first.
One batch create call supports up to 10 tasks. Split larger batches deliberately.

仅通过
```
scripts/publish/
```
发布视频。
未指定发布模式时按默认即时发布处理。默认即时发布意为"尽快发布"，仍需实现为近期定时任务。
若无平台账号、文案/标题、发布模式及明确的绝对调度时间，不得创建定时任务。默认即时发布需先计算出绝对的近期调度时间，再创建任务。
成功创建默认即时发布任务后，添加简短说明：也支持定时发布。
将"今天"、"明天"或"下周五"等相对日期转换为绝对日期后再调度。
针对TikTok、Instagram或Facebook的特定设置，使用脚本参数和JSON覆盖选项。不得猜测复杂的平台负载；请先阅读references/publishing-api.md。
单次批量创建调用最多支持10个任务。需主动拆分更大的任务批次。

Follow-Up Operations

后续操作

To update, delete, or list scheduled tasks, use
```
scripts/publish/
```
task scripts and keep platform plus
```
platform_user_id
```
in the query.
To analyze published posts, use
```
scripts/publish/list_videos.py
```
and summarize title, platform, publish time, views, likes, comments, shares, and engagement rate when available.
To refine a generated asset before publishing, continue the same Pippit Nest thread with
```
scripts/nest/submit_run.py --thread-id
```
.

如需更新、删除或列出定时任务，使用
```
scripts/publish/
```
下的任务脚本，并在查询中保留平台及
```
platform_user_id
```
。
如需分析已发布帖子，使用
```
scripts/publish/list_videos.py
```
，并在可用时汇总标题、平台、发布时间、浏览量、点赞数、评论数、分享数及互动率。
如需在发布前优化生成资产，通过
```
scripts/nest/submit_run.py --thread-id
```
继续同一Pippit Nest线程。

Output Expectations

输出要求

Keep the user-facing response concise but include the operational identifiers they need:

Nest generation:
```
thread_id
```
,
```
run_id
```
,
```
web_thread_link
```
, downloaded local files
Publishing: platform,
```
platform_user_id
```
, uploaded
```
asset_id
```
, task IDs, task status, scheduled time
Analytics: platform, account, video title, publish time, core metrics

Never claim a generation, upload, or publishing task succeeded unless the relevant local script returned success.

用户端回复需简洁，但需包含所需的操作标识符：

Nest生成：
```
thread_id
```
、
```
run_id
```
、
```
web_thread_link
```
、下载的本地文件
发布：平台、
```
platform_user_id
```
、上传的
```
asset_id
```
、任务ID、任务状态、调度时间
数据分析：平台、账号、视频标题、发布时间、核心指标

除非相关本地脚本返回成功，否则不得声称生成、上传或发布任务已完成。