tt-caption-writer

TikTok 文案撰写器

撰写显示在视频下方的文案：控制在 2,200 字符 API 限制内的精炼文案、兼顾不同覆盖面的标签组合，以及用于控制覆盖面和互动的 platformSettings.tiktok 标志。在 TikTok 上，文案是辅助视频的，而不是撑起视频的。吸引观众的钩子在视频片段的前 1–3 秒（参见 tt-hook-scripter）；文案的作用是补充背景信息并引导观众评论。

适用场景

• 用户有视频（或脚本），需要文案、标签和设置
• 用户即将上传视频，希望正确设置发布标志
• 用户想让 Claude Code 或 Codex 通过 Publora 排期发布已渲染的 .mp4

此技能会生成什么

• 文案（API 限制为 <= 2,200 个字符；建议精简得多），首行优先写上让人愿意阅读或评论的理由
• 标签组合（3 到 5 个，兼顾不同覆盖面），置于末尾
• platformSettings.tiktok 标志及通俗易懂的说明
• 获得批准后，在提供视频文件时调用发布流程（草稿 -> 上传 -> 排期）

TikTok 设置（platformSettings.tiktok）

使用 lib.tiktok_settings(...) 构建。默认值与 Publora 的默认设置一致。

设置	值 / 默认值	作用
viewerSetting	PUBLIC_TO_EVERYONE（默认）、MUTUAL_FOLLOW_FRIENDS、FOLLOWER_OF_CREATOR、SELF_ONLY	谁可以观看。实际上为必填项；空值会被拒绝
allowComments	true（默认）	观众可以评论
allowDuet	false（默认）	观众可以合拍
allowStitch	false（默认）	观众可以拼接
commercialContent	false（默认）	视频属于商业内容
brandOrganic	false（默认）	推广自己的品牌
brandedContent	false（默认）	付费合作 / 赞助内容

必须向用户说明的两个注意事项

1. 布尔值反转错误。 Publora 目前会将 allowComments、allowDuet、allowStitch 映射到 TikTok 的 disable_* 标志，因此布尔值可能会被反转（发送 allowDuet: true 可能会禁用合拍）。无法仅凭 API 确认状态。在信任这些值之前，请先使用 SELF_ONLY 草稿进行测试。 每当用户更改标志时，都要告知此事。
2. 商业内容披露。 如果 commercialContent 为 true，则 brandOrganic（自己的品牌）或 brandedContent（付费合作）至少有一个也必须为 true，否则 Publora 会拒绝。lib.tiktok_settings 会强制执行此规则。

发布时的实际情况

• 未经审核的应用只能发布为 PRIVATE。 在发布应用通过 TikTok 审核之前，无论 viewerSetting 如何设置，帖子都会被强制设为 SELF_ONLY。如果“公开”帖子最终以私密状态发布，请提醒用户。
• 要获得覆盖面，请使用 PUBLIC_TO_EVERYONE。要进行端到端测试，请使用 SELF_ONLY。

步骤

先确定语气档案（适用于所有草稿）。 如果 ../../references/voice-profile.md 中的 filled: yes，请加载该文件，并在全文中匹配用户的语气特征、硬性规则以及 CTA／链接风格。如果尚未填写，提及一次 tt-humanizer --mode profile 可以从用户的几篇帖子中学习其语气，然后继续使用通用语气规则。

绝不编造具体信息。 以下规则要求提供一个具体数字、一个日期和一个专有名词，因为这些内容能让帖子显得真实，而不是机器生成。只能使用用户在本次对话中实际说过的信息。不要编造数字、日期、客户名称或结果，也不要把模糊的说法改成看似合理的数字。 如果用户没有提供某一环节所需的具体信息，只问一次；如果用户仍然没有，就删掉该说法，不要添油加醋。发布后发现数字是编造的，就得更正；不写数字只会让帖子稍逊一筹。

1. 收集输入，先确定目标。 询问（或推断）文案应该达到什么目的， 然后围绕目标撰写：评论 -> 以一个与视频相关的具体问题结尾； 收藏 -> 承诺提供参考价值（“3 个设置写在文案里”）； 分享 -> 提出一个让人想转给别人的说法；访问个人资料 -> 留下一个由置顶视频揭晓的悬念。然后收集视频主题／脚本、细分领域、是否具有商业性质，以及是否存在已渲染的 .mp4 文件路径。
2. 起草文案。 第一行必须一开始就给出继续阅读的理由，或提出一个便于评论的具体问题。 保持简洁。控制破折号数量 （大约每 100 个词不超过一个；短文案通常不需要破折号），避免堆砌 AI 词汇。 可以选择将开头悬念改写成评论提示。
3. 挑选话题标签。 3 到 5 个，兼顾覆盖面：一个广泛标签、1 到 2 个界定细分领域的标签、 1 到 2 个与视频具体内容相关的标签。放在末尾。切勿堆砌。
4. 设置标记。 默认设为 PUBLIC_TO_EVERYONE，开启评论，关闭 duet／stitch， 不加商业内容标记。根据用户需求调整，并指出两个容易忽略的问题。 使用 lib.tiktok_settings(...) 构建设置。
5. 检查字符数。 确认文案 + 话题标签 <= 2,200。超出时精简。
6. Humanizer 处理。 清除 2026 年常见 AI 词汇，控制密度，限制破折号数量 （大约每 100 个词不超过一个，绝不能将破折号替换成句号），拆开堆叠的三段式结构、 通用开场、揭晓过渡句和假装真诚的开场白（“说真的”）。 保持原有节奏；绝不要为了制造冲击感而拆短句子。标准规则： tt-humanizer V3。
7. 审批卡片。 展示：文案、字符数、话题标签组合、设置摘要，以及已确定的 viewerSetting（如可能以私密状态发布，需标明）。
8. 获批后。 调用 lib.publish("video", caption, target_url=<upload or profile URL>, video_path=<path or None>, platform_settings=<settings>, scheduled_time=<iso or None>, platforms=[<TIKTOK_PLATFORM_ID>])。如果有视频路径且已配置 Publora，则会依次创建草稿 -> 上传 -> 安排发布时间。如果没有视频路径，则返回文案和设置，供用户在应用内上传。

硬性规则

全局语气规则：参阅根目录中的 SKILL.md Voice rules。其他仅适用于本技能的规则：

• 文案 + 话题标签必须不超过 2,200 个字符（API 限制），话题标签也计入总数。尽量远低于上限。
• 使用 3 到 5 个话题标签，兼顾覆盖面，并放在末尾。绝不能超过 10 个，绝不能放在句子中间。
• 文案绝不代替视频中的开场钩子。钩子应出现在视频里。
• 始终设置 viewerSetting。绝不能留空。
• 每当修改互动标记时，都要指出布尔值反转警告。

反模式（技能会拒绝）

• 话题标签墙（10 个以上），或把话题标签塞进句子。
• 破折号超过限额（每 100 个词大约超过一个），或把破折号替换成句号。
• 为制造冲击感而添加“结果呢？”式揭晓，以及“没有 X。没有 Y。只有 Z。”这种断句堆叠。
• “关注看第二部分／点赞并订阅／别忘了转发”这类呼吁堆叠。
• 文案逐字重复视频中说出的开场钩子。
• commercialContent: true，但未设置任何品牌标记。
• 在应用未经审计时宣称帖子会公开（此时帖子会设为私密）。

资源

• ../../references/voice-rules.md - 字幕和话题标签规则
• ../../references/algorithm-heuristics.md - 字幕、话题标签和设置启发规则
• references/settings-matrix.md - 每个 platformSettings.tiktok 值、默认值和已知错误
• lib/publora_client.py - tiktok_settings(...)、publish_video(...)、create_draft(...)

可选插图

当视觉内容有助于提升触达率时，提供一张生成的图片。起草提示词并调用 lib.illustrate(prompt, kind="story")，从 Voice & Brand Profile 第 6 节获取品牌账号和颜色，以实现像素级精准的叠加效果。展示返回的 url + cost；对于 TikTok 图片帖子，通过 media_urls=[url] 附加图片（TikTok 图片轮播）；对于视频，TikTok API 没有封面图片字段，因此请在 TikTok 应用中设置封面。完整工作流（包括引用卡片）： ../tt-humanizer/sub-skills/illustration.md。没有 Pixfaro 密钥时，它会为你起草提示词，以便你手动生成图片。

相关技能

• tt-hook-scripter - 视频内的钩子（字幕无法替代它）
• tt-humanizer - 发布前润色字幕
• tt-content-planner - 安排一周内的字幕发布计划