# Script Development > Write the project's source text — a faithful, magnetic story screenplay, an executable timed commercial script, a brand or corporate promo script, or an attention-driven short-video script — from the user's need, choosing the interview, direction candidates, and judging ruler by need type. - Skill: `waooai/script-development` (Agent Skill) - Install (CLI): `npx skillmds@latest add waooai/script-development` - Raw SKILL.md: https://api.skillmd.com/api/skills/waooai/script-development/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: waooai (https://skillmd.com/u/waooai) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/waooai/script-development --- # 内容与脚本开发 ## 作用 把一句想法、零散设想、产品资料或已有材料写成项目的**源文本**：故事剧本、商业广告脚本、品牌或企业宣传脚本，或播放量导向的短视频脚本。源文本是项目里唯一回答「发生什么、按什么顺序、用什么话说」的权威；下游的呈现、资产、分段与配乐都读它，不改写它。用户输入是唯一已知事实来源；可以补全未指定内容，但不能与已锁定的人物、地点、关系、产品事实、限制、语气、内容事实或目标时长冲突。 正确但无聊的源文本是不合格交付。忠实、连贯、时长可信只保证「没有错」；钩子、升级、意外、潜台词与情绪运动同样是硬指标。两者冲突时先保事实正确，再在事实允许的全部空间内追求最大强度。 ## 需求类型 同一套手艺服务三种需求。先从用户的话判断需求类型，再用该类型的访谈、方向候选尺子和脚本形态工作；用户没有说品类时不要问「你要做故事还是广告」，用一句话说出你的理解让用户纠正即可。 | 需求类型 | 触发信号 | 观众为什么看 | 源文本形态 | | --- | --- | --- | --- | | 表达型 | 想讲一个故事、一个人物、一种感受；短剧、短片、剧集、动画 | 被故事抓住，想知道接下来 | 剧本：场景 → 动作 → 对白 | | 传播型 | 要投放、要转化、要品牌；广告、产品片、企业宣传、招聘、活动、公益 | 与自己有关，值得记住一件事、做一个动作 | 时间脚本：连续节拍 × 画面 / 旁白 / 屏幕文字 / 声音，固定总时长 | | 播放量型 | 要在信息流里被刷到并看完；短视频、引流片、带货片、系列账号内容 | 前几秒就值得停下，看到最后有回报 | 竖屏时间脚本：钩子 → 留存 → 回报，逐秒可读 | 三种类型的正文都进入同一个 `screenplayText` 字段；`title`、`logline`、`synopsis`、`assumptions`、`openQuestions` 各按类型填写。不为传播型或播放量型另建第二种输出。 ## 开场访谈：先做功课，再问只有用户能答的 访谈是对齐，不是问卷。用户已经给出的一切都是既定事实；给了链接、资料、产品图或旧片，先读完再开口。只问「答案会改变源文本走向、而且专业判断推不出来」的问题；镜头、景别、画幅、模型、价格和文案措辞不是访谈问题。问题本身要证明你已经理解：把你读到的东西说出来，让用户只需要纠正或确认。 - 表达型：你放不下的是什么——是哪个人、哪个瞬间、哪种感受？想让观众看完是什么状态（后怕、想哭、想转发、想追下一集）？给谁看、在哪看？ - 传播型：这条片要观众看完做一个什么动作？只能记住一句话，是哪一句？谁是最该被说服的人，他们在看到之前正在担心或想要什么？有没有必须出现或绝对不能说的东西（价格、承诺、资质、法律限定语、Logo、包装）？在哪个渠道投放，总时长多少？怎么算成功？——这些是“桥的两端”，只有用户能答；怎么建桥不问。 - 播放量型：目标观众刷到这条之前正在看什么？这条片对他们的「利益」是什么——学到、笑到、爽到、被代表、被安慰？是单条还是系列，账号已有什么人设和格式？在哪个平台，是否要挂车或引流？ ## 方向候选检查点 本 Skill 声明一个硬对齐检查点：**内容方向选择**。时机在动笔写完整源文本之前。触发条件：用户只给了高概念——题材、形态或感觉——而没有给出实际内容（表达型：讲谁、发生什么、怎么结尾；传播型：核心主张与说服路径；播放量型：钩子与回报）。用户已经给出内容、完整脚本或明确要求「你来定」时跳过，直接写。 做法：一次调用 `wao.request_user_decision`，恰好三个完整、彼此真正不同的方向候选，外加本地化的 `otherLabel`。每个候选是为本次输入新写的自足方向，一段话，推荐项在前，并吸收用户已经说过的一切。候选之间的差异必须是因果引擎、主张或钩子机制的差异，不是同一个方向换形容词。 - 表达型候选写清：时代与设定、主角与动机、核心冲突、关键关系、基调、结局方向。 - 传播型候选写清：单一核心主张、说服引擎（问题—解决、欲望—证明、使用场景—利益、对比—选择、演示—结果、品牌宣言等）、开场怎么抓住目标观众、结尾动作。 - 播放量型候选写清：钩子类型与前几秒内容、留存机制（悬念、对比、递进、反转、清单）、结尾回报与循环点、字幕与口播关系。 选定后立即写完整源文本；被选中的方向成为既定事实。 ## 用什么尺子评自己的稿 不同类型的「好」不同。写完先按本类型的尺子逐条自评，任一条不及格就地修改后再交付。 - 表达型：情感真实——人物为什么这样选，换一个人会不会不一样；特异性——别的同类故事不可能出现的时刻不少于两个；升级——高峰递增、中点转向、情绪在运动；对白遮名测试；结尾让观众有事可做。 - 传播型：单一主张——观众只能记住一件事，是不是你想要的那件；可信——每个利益都由可见行为或有来源的证据成立，没有无来源的数字、排名、承诺；相关——目标观众在开场能认出「这是在说我」；行动——结尾清楚给出要做的动作，且与简报一致；合规——必须元素齐全、禁止主张为零。 - 播放量型：前 2 秒有扰动、约 6 秒钩子成立；每 8–10 秒有真实变化，找出「会划走的段落」并修掉；无声可看——关掉声音仍能跟上；回报兑现开场承诺，不做接不住的标题党；结尾有循环或转化点。 ## 缺口判断 - 主 Agent 是本次故事专业结果的唯一 writer，可直接与用户交互。不影响成片走向的缺口，用最小、可撤回、不冲突的假设补足并写入 `assumptions`，照常交付完整剧本；会实质改变成片走向的缺口——换一个答案就会写出另一个剧本——仍按最合理的一种解释写完，把分歧写入 `openQuestions`，说清不同答案如何改变动机、冲突、节奏或结局。 - 类型不同，关键缺口也不同：恐怖先看恐惧来源和子类型，爱情先看关系与阻力，悬疑先看诡计结构和真相归属。 - 角色姓名、场景数量、具体对白、镜头细节、画幅、模型、价格和系统参数不是创作缺口。`assumptions` 与 `openQuestions` 只记录真实缺口，不复述已明确事实，也不替代应写进剧本的创作决定。 ## 写前构思 以下方法以表达型为主写成，传播型与播放量型同样适用其中关于因果、特异性与代价的部分；它们各自的额外纪律见「传播型脚本」与「播放量型脚本」两节。 - 动笔前在内部构思 2–3 个因果引擎不同的走向：主角自身选择层层加码、两个正当目标互相碾轧、世界规则的代价倒逼选择。取最锋利的一个再写；候选过程不进入输出。单次生成的多样性必须靠构造强制，不能靠运气。 - 事件由人物因果驱动：压力 → 感知 → 目标 → 符合此人的战术 → 阻力 → 意外后果 → 更大压力。禁止用巧合、类型惯例、突然的能力或无来由的背叛推动剧情。 - 每个关键事件要能回答「为什么是这个人物这样选，换一个人会不一样」。核心事件若换个道具就能搬进任何同类故事，重写。 - 重要冲突要有不可逆代价：主要人物至少付出一次收不回的东西（关系、资源、身份、底线）。笑点与场面不能替代代价。 ## 节奏档位 按题材与发行形态选择注意力纪律；用户的明确节奏要求逐条覆盖档位。数字是创作纪律，不是输出字段。 - 抢夺注意力档（竖屏短剧、引流短视频、广告）：约 2 秒内出现第一个扰动，约 6 秒内钩子成立——观众知道该期待什么并开始痒；此后每 8–10 秒一个真实变化；单句台词短到能被烧录字幕承载；连续纯对白节拍不超过 2 个。 - 标准叙事档（网络短片、剧集、长片）：按体量在前 15–90 秒内完成钩子，每 10–40 秒一个变化；对白可以更长，但仍逐拍有功能。 - 沉浸档（恐怖铺垫、悬疑发酵、情感慢戏、文艺片）：以上数字仅作参考。铺垫不等于没有变化——它是更小、更安静的变化：一声不该出现的响动、一个错位的细节、一次没有回应的呼喊。每个安静节拍必须完成一次可感知的压力积累，张力只升不泄；泄压必须是设计出来的（假警报、错误解脱），为下一次更高的峰值服务。 - 任何档位：时间轴前重后缓再收紧——开头变化最密，中段放宽，结尾再次加密；禁止把全片均分成等长块各装一件事。 - 连续高峰必须递增；中点用新信息转向故事（改变目标、关系或对过去的理解），不是把同一冲突重复得更响。同一个笑点、同一种威胁、同一层恐惧不升级地出现第二次，删。 - 情绪要运动：在紧张、好笑、温暖、恐惧、释然之间换挡，摆幅按题材校准——喜剧大开大合，恐怖在压迫与虚假松弛间交替，文艺片幅度可以极小但方向必须在走。不允许整片停在一个声部。 ## 开场与结尾 - 开场是选择出来的，不是时间顺序的第一件事。从全片最具磁性、最只属于这个故事的时刻切入；需要时冷开场，后文自然回接。沉浸档的开场可以安静，但必须立刻建立「这里有什么不对」的特异性。 - 开场画面若能属于任何其他同类故事，重选；特异性优先于场面强度。禁止用设定说明、自我介绍、赶路、寒暄开场；前提信息在冲突或不安进行中带出。 - 开场承诺什么，正片就以至少同等强度兑现什么；不写正片接不住的标题党开场。 - 伏笔来自已建立的行为、物件与事实，兑现要「意料之外、回头必然」。反转必须改变人物处境、策略、关系或观众对已知事实的理解，不为密度而反转。 - 结尾让观众有事可做：重看、转发、争论、后怕、追下一集，或长久的余味。收束情节不等于完成结尾。 ## 场景与正文 - 写故事本身，不写创作说明、导演说明、设定表或过程解释。 - 建立自然的集、幕、场结构但不固定数量；每场一个完整时空单元，按真实发生顺序排列，与前后场因果衔接。 - 每场包含明确地点、在场人物、可见行动、有效对白或旁白，以及情绪或信息推进；正文必须是可拍摄的完整场景，不是摘要。结构摘要负责预览，正文负责表演与叙事。 - 每个节拍造成一次可感变化：新问题、解答、新威胁、战术转变、地位或关系变化、新代价、感官异变、再语境化或不可逆行动。写完自问「这一拍为什么不是重复」，答不出就删或合并。 - 动作、停顿、反应和环境描写必须有表演价值，不以文字密度假装影视时长；感官与环境细节在沉浸档承担叙事功能，不是气氛填充。 ## 对白锋利度 - 每句台词同时做两件事：表面话题之下有真实冲突或潜台词。只推剧情的是草稿，只装饰的是填充物，都要重写。 - 遮住人物名，应能凭语气、词汇和策略猜出说话人；猜不出说明人物没有独立声音。 - 人会打断、回避、答非所问、用具体细节当武器；优先用这个故事世界里的具体名词，不用抽象情绪词。 - 行为可以与台词矛盾，矛盾本身就是戏。沉默是一种动作——施压、拒绝、认出、划界——要有明确位置和功能。 - 禁止：复述已知事实、解释性台词、向观众说明功能、为凑时长加台词。 ## 时长控制 - 用户指定时长时，完整剧本必须能在该时长内正常演完，不能只在标题或摘要中标注时长。语速与真实表演时长使用 `creative-core` 的「通用时长估算方法」，本 Skill 不另立数字。 - 一分钟对白密集内容的口播字数约 240–300 字；动作、停顿、气氛和复杂调度越多，对白应越少。时长来自对白、动作、反应、停顿和转场的实际时间，不来自幕数、场景数或节拍数。 - 同时发生的内容按同一时间轴计算，不按先后相加：画外音、内心独白、旁白与覆盖画面同时进行，人物可以边走边说、边打边喊。 - 超时先删次要情节、重复描写、冗长对白、多余动作和无效转场，优先保留用户核心事实、人物关系与主线。未指定时长时写成自然紧凑的作品，不自行宣称固定片长。 ## 长故事与分段 - 先建立完整主线、人物目标、主要冲突、转折和结局，再按自然场景边界展开正文。 - 分段按故事顺序，元信息在同一集、同一幕内保持一致，不重复、跳号、倒序或互相冲突。单段是单一完整场景，不塞多个不连续时空，也不为格式机械截断不可分割的场景。 - 整体过长时保留原始来源和全局结构，局部展开携带该场入口状态、必须发生的事件与出口状态，避免各段独立改写世界事实。 ## 忠实性与连续性 - 人物行动由已建立的欲望、限制和信息状态驱动；不让人物提前知道尚未发生的事实，不让失去、损坏或转移的物件无理由恢复。 - 重要身份、关系、地点特征、物件、目标、限制和已发生的状态变化一旦出现，后文保持一致。 - 场景转换需要因果或叙事目的；时间跳跃应使观众能理解已变化的状态。 - 类型、情绪和语言可以丰富，但不能覆盖用户已指定的故事目标。 ## 自检 先查事实，再做盲评。盲评只看观众能看到的文本，忘掉创作理由——需要解释才成立的段落就是不成立。 - 事实：用户事实与目标时长是否全部保留？行为是否有因果？是否有跳变设定、提前获知或物件无理由复原？实际演出能否在目标时长内完成？ - 钩子：按本片档位，我本人会在时限内停下滑动、坐进故事吗？ - 逐段走时间轴，标出失速区间——抢夺注意力档找「会划走的段落」，沉浸档找「张力泄气的段落」（没有积累的安静、无功能的对白、重复的恐惧层级）。每一处都修。 - 高峰是否递增？中点是否转向？情绪是否在运动？ - 数「别的同类故事里不可能出现的时刻」，少于两个说明太通用。 - 对白遮名测试是否通过？结尾是否让观众有事可做？ - 任一条不及格，就地修改后再交付。不允许交付「正确但无聊」的版本。 ## 传播型脚本（广告、产品片、品牌与企业宣传） ### 先立简报，再写脚本 - 动笔前在内部收敛一份简报（不另存文档，除非用户要求或下游需要精确 Resource）：现在在哪 / 要去哪（一个可衡量的目标，商业目标 → 行为目标 → 态度目标三层相连）/ 对谁说（与总人口有意义地不同、规模足以实现目标、品牌有理由赢得他们；“年轻人”这类标签不是受众）/ 单一主张（一句话，不是 tagline，不是购物清单）/ 支撑点（只留相关的，数量按渠道不同）/ 语气与品牌资产 / 必须元素与禁止主张 / 渠道、时长、画幅 / 成功怎么衡量。 - 分工：用户负责“桥的两端”——目标、受众、主张事实、限制与预算、什么算成功；“怎么建桥”——结构、钩子、画面、节奏——是你的专业判断，不抛回给用户，也不让用户在简报里规定创意。一份脚本只对应一个策略：拉新、老客升级、提高频次是互斥目标，要多个就写多份。 - 事实纪律：产品事实、价格、优惠、性能、资质、法律限定语、品牌拼写、Logo、包装文字和 CTA 只来自用户或精确提供的 Resource。来源只说“便捷”不得写成“最快”；来源没有数字，不得加百分比、排名、销量或时间承诺。无法验证但可撤回的解释进 `assumptions`；会改变受众、主张、CTA 或交付范围的缺口进 `openQuestions`。 ### 结构与时间分配 - 骨架：钩子 → 问题或相关性 → 方案与产品行为 → 证明 → 行动。吸引、露出品牌、建立连接、引导行动四段是同一骨架的另一种说法。 - 开场不铺垫：不用“铺垫—积累—高潮”的电视片弧线；开场强刺激、多个高峰、意外转折、全程穿插品牌线索。前 5 秒用 2 个以上镜头、对人或产品紧框取景、有人物就让人物出现并可直接对观众说话；前 3 秒交代内容主张、前 6 秒钩子成立，广告回忆主要在前 6 秒内决定；信息流里单条内容只有一两秒争取停留。 - 品牌早露出：开头露出的是产品行为或主张，不是 Logo 动画；由出镜者说出品牌名比旁白更有效；Logo 位置按目标——求回忆则融入故事或产品上，求考虑则用字幕或水印。 - 时长切分（参考区间，最终以 creative-core 的时长估算核算）：15 秒约 30–40 词、30 秒约 65–85 词、60 秒约 120–150 词；30 秒常见分配为 0–5 秒钩子、5–22 秒问题 → 方案 → 证明、22–30 秒 CTA，实际演出留 2–3 秒余量；不要把 6 秒的点子拉成 20 秒。6 秒版：一个点子、一个画面、一个“变化”，像笑话提炼到 punchline，不必讲完整故事。写终稿前就规划 15 秒 / 30 秒剪辑版。 - 行动：CTA 用具体动词（访问、注册、购买），文字卡与旁白同时可见可听；只有有真实依据的“限时”才写紧迫感，不自创促销。 - 声音与字幕：有的平台默认开声，有的默认静音，两者都要满足——旁白和音乐承担情绪，屏幕文字独立把利益点说清，关掉声音仍能跟上；字幕每秒 5–10 词。投放竖屏信息流（如 Reels）时，顶部约 14%、底部约 35%、两侧约 6% 不放关键文字与 Logo，写进脚本备注供导演与资产阶段使用。 - 企业与品牌片：四拍——建立相关性 → 揭示组织的回应（人、流程、成果）→ 用真实情境证明主张 → 明确方向收尾；一个中心思想加两三个分层证明点；出镜组合：领导讲愿景、员工讲文化、客户讲结果，只靠领导访谈显得片面；最有力的信息放最前，因为很多观众会提前离开。时长：默认社交版 60 秒内、主页长版不超过 2 分钟，用户另有要求以用户为准。 ### 传播型的尺子 - 单一主张：观众只能记住一件事，是不是简报里那一句。 - 值得观众花时间；人们是否在乎到愿意行动。 - 点子是否激发人、执行是否出色、是否切合目标。 - 情绪反应强度与品牌归因：看完能否正确说出是哪个品牌，品牌是否在故事核心。 - 只有这个品牌能说、能做；同时保护独特资产——颜色、声音、画面母题——让信息能挂到品牌上。 - 事实与合规：每个利益由可见行为或有来源证据成立；必须元素齐全，禁止主张为零。 ## 播放量型脚本（信息流短视频） - 钩子：前 3 秒要有让人留下的钩子，前 6 秒钩子成立并给出主张。跳过问候和自我介绍，直接进最精彩部分；最好的钩子是一句话说清一个承诺。 - 钩子三类：音频钩子（制造好奇的陈述）、视觉钩子（提供可信度或兴趣的画面）、文字钩子（最容易被忽略）。好奇循环 = 障碍 + 解决；开启方式有“我真希望早点知道…”、“但是 / 因此”链式推进、把不相干元素并置。 - 留存曲线：观看通常逐渐衰减，要把最吸引人的内容前移；曲线尖峰是被重看或分享的片段，下陷是观众放弃处。写脚本时逐段走时间轴，标出“会划走的段落”并修掉；每 8–10 秒一个真实变化（本 Skill 节奏档位）；用音乐、动态转场、运动、文字、emoji 维持刺激。 - 回报与结尾：娱乐类以 punchline 收尾，教育类以关键洞察收尾；不要在结尾要求点赞关注，会打断动能。循环结构是可选技法：结尾无缝接回开头，以问题结尾、答案是第一句，或同机位同着装镜像开场；不是每条都用。 - 原生感与格式：像原生内容，DIY 不过度精致；9:16、≥720p、留出平台 UI 安全区；很多人静音刷，文字叠加要把利益点说清；产品上镜与 CTA 卡片有助于回忆与好感。 - 系列与账号：内容要能独立成立、可共鸣可分享、持续发布；先对非粉丝测试再推给粉丝；一条一个承诺，不塞多个主题。 - 事实纪律同传播型：带货或引流的产品事实、价格、承诺只来自用户。 ## 边界 本 Skill 只负责源文本创作方法。唯一专业结果是运行时注入 schema 约束的 `outputKind: "screenplay"` 严格 JSON；完整源文本（无论是剧本、时间脚本还是竖屏脚本）写入 `screenplayText`，摘要、来源、假设与开放问题写入各自固定字段，不另建 Markdown 脚本或第二份解释文件。不得在源文本中登记系统资产、生成 Resource ID、建立媒体任务或替资产设计决定视觉空间。一个项目只有一个源文本权威：已有源文本时修订它，不另起第二份。 Creative Direction 可选。当前输入提供了精确方向 Resource 时，完整读取并使用会实质影响当前写作的领域，同时保持彼此协调；不得把制作政策复制成剧本元数据，也不得改变已经成立的故事事实。未提供时，根据用户要求和已提供故事事实工作，不得临时发明项目级方向。