Communitygithub.com

长视频故事

商定长视频的故事。用户提供故事或让 Claude 编写一个。当 Claude 编写时,它首先询问使用哪种故事风格,运行该风格的技能,并根据用户反馈修改,直到用户批准。在 long-video-setup 之后,或当用户说“为我的视频写故事”、“给我一个想法”,或想要更改未获批的故事时使用。仅在用户明确批准故事时结束。

长视频故事 是什么?

长视频故事(Long Video Story)是长视频工作流程的第二阶段。该技能旨在帮助用户和 AI 智能体(如 Claude)共同制定并最终确认一个可用于长视频的故事。技能的核心任务是生成或接收一个故事,并将其保存为项目文件夹中已批准的 `story.md` 文件。本阶段仅在用户明确批准故事后才会结束,不会提前进入后续阶段。该技能支持用户在主流 AI 编码工具(如 Claude Code、Cursor)中使用。工作流程包括:识别项目、询问用户是否自带故事、在 Claude 编写时选择合适的风格(如 niche discovery、provocative-questions 或自定义的 open 风格)、获取主题、根据风格调用专门的编写技能(如 long-video-story-questions)或使用默认结构进行创作、保存草稿、反复修改直到用户明确批准。最终锁定故事并更新项目状态,然后可过渡到 `long-video-assets` 阶段。该技能严格遵守规则,不会静默修改已批准的故事,且在所有编写环节中都必须询问故事风格。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samanfirouzi/long-video-skill/tree/HEAD/skills/long-video-story

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

长视频故事 是做什么的?

长视频工作流程的第二阶段。输出:项目中已批准的 story.md。

此阶段仅在 Claude 和用户就故事达成一致时结束。在此之前,后续阶段不会开始。

开始之前

  1. 查找活动项目:~/.long-video/projects/<slug>/project.json。如果用户有多个项目,请询问是哪一个。
  2. 如果项目不存在,请先运行 long-video-setup。
  3. 从 ~/.long-video/configs/<config-name>.json 加载项目配置。使用其中的长度、语言、观众、语气、格式和视觉方法。不要重复询问配置已回答的问题。
  4. 如果 story.md 已存在且状态为 draft,请询问是否继续编辑。如果状态为 approved,请询问是否要重新打开。

第 1 步:询问入口问题

询问:“你有故事,还是想让我写一个?”

  • 我有故事。 用户粘贴或描述故事。转到第 5 步。
  • 帮我写一个。 转到第 2 步。
  • 我有一个粗略的想法。 用户提供一个种子(主题、话题、一个句子)。保留它,然后转到第 2 步。

第 2 步:询问故事风格

当 Claude 编写故事时,始终要询问这一点。不可跳过,也不可为用户选择风格。

  1. 阅读 references/story-styles.md。检查安装了哪些风格技能。
  2. 显示可用的风格,每种风格附上一行描述。始终包含 open。
  3. 让用户选择一种。用户也可以描述自己的风格。如果他们这样做,则将其视为附加了用户描述的 open 风格。
  4. 将选择保存到 project.json 中,格式为 "story_style": "<id>"。

第 3 步:获取主题

按照所选风格的类型操作。

  • 创意(ideas)(例如 niche):调用该风格的技能。传入配置摘要和任何种子。它会返回一个主题。然后询问使用哪个编写器(遵循注册表中的第 4 步配对规则)。
  • 编写器(writer)(例如 questions):如果用户有主题或种子,则使用它。如果没有,则询问一个。不要建议主题。
  • 开放(open):提出创意,如下所述。

开放风格:提出创意

  1. 如果没有种子,最多问 3 个简短问题:主题领域或兴趣、要避免的内容、是否使用真实事件或来源。
  2. 写出 4 个符合配置的创意。每个创意包含:标题、一行摘要、前 15 秒作为钩子,以及为何适合该受众。
  3. 确保这 4 个创意之间明显不同。
  4. 让用户选择一个、合并两个、要求更多,或提供新的方向。重复直到用户选择。

第 4 步:编写故事

调用编写器。

  • 编写器技能(例如 long-video-story-questions):使用主题、目标时长、语言和配置摘要调用它。其输出格式优先。不要将其重塑为默认结构。
  • open 风格:编写下面的默认结构。

默认结构(开放风格)

匹配配置中的目标长度。旁白每分钟约 150 个汉字,因此 15 分钟的视频需要约 2250 个旁白词。现在不要写最终脚本。写故事:按顺序发生什么,要有足够的细节供用户评判。

  1. 标题(工作标题)。
  2. 一行摘要。
  3. 钩子。 开场 15 到 30 秒。
  4. 故事大纲。 幕或章节。每部分:发生了什么、转折点、大致的时间占比。
  5. 完整故事。 从开始到结束的散文式叙述。
  6. 结尾和行动号召。
  7. 需要核实的事实。 列出每一个需要来源的事实主张。纯虚构写“无”。

开放风格的规则:

  • 对于非虚构故事,不要虚构事实。在“需要核实的事实”中标记未知内容。
  • 不要抄袭现有作品。使用原创结构和措辞。
  • 保持配置中的语言和语气。

保存草稿

保存到 story.md,使用此头部,状态为 draft:

---
title: <工作标题>
status: draft
revision: 1
style: <风格 ID>
writer: <编写器 ID 或 "open">
config: <配置名称>
---

将正文放在头部下方。在聊天中展示故事。

第 5 步:确认或修改

如果用户在第 1 步带来了他们自己的故事,首先将其保存为 story.md,使用上面的头部(style: user)。

询问:批准,或要求修改。在展示故事后的新消息中询问。不要将问题放在编写器技能的输出中。

  • 要求修改。 应用修改。如果编写器技能生成了文本,在编辑时保持其规则(格式、语气、诚实)。增加 revision。用两到三行显示更改的内容,然后显示更新后的故事。再次询问。
  • 问题或疑虑。 回答它。如果答案显示出问题,则提供一次修改。
  • 想要一个不同的故事。 返回第 2 步。将旧文件保留为 story.rev<N>.md。
  • 批准。 需要明确的“是”。沉默、“到目前为止看起来不错”或“好,但是...”不算批准。如果不确定,直接问一个问题:“锁定这个故事?”

循环直到批准。不要催促用户。

第 6 步:锁定

  1. 在 story.md 的 front matter 中设置 status: approved。添加 approved: <ISO 日期>。
  2. 更新 project.json:设置 "stage": "story-approved"。
  3. 告知用户文件路径。说明故事阶段已完成。
  4. 询问是否继续 long-video-assets(角色、环境、对象和风格)。仅当用户同意时才启动。

规则

  • 未经明确同意,绝不将故事标记为批准。
  • 绝不静默修改已批准的故事。重新打开需要用户请求,并将状态恢复为 draft。
  • 当 Claude 编写故事时,绝不跳过风格问题。
  • 绝不调用未安装的风格技能。
  • 保持创意和修改简短。仅对故事本身展示完整文本。

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

相关技能