用途：把一段上下文（文件路径、已抓取的 URL 或文本本身）转成完成的带旁白视频。参数按 slug context seconds orientation 解析：$0 为小写连字符 slug，作为 public/ 下的文件夹，并转成 PascalCase 作为 composition id；$1 为上下文；$2 为秒数，默认 60；$3 为 landscape 或 vertical，默认 landscape。无参数时需询问视频主题、时长和发布位置。
使用方式：先确认流水线存在，skills 可单独安装：test -f cli/generate.ts && test -f src/Root.tsx && echo present || echo missing。缺失则先运行 story-setup 技能，它会获取项目、安装依赖、创建 .env 并校验密钥。之后一切在项目根目录执行。写作前阅读规则：rules/story-formats.md 选形状、rules/narration.md 写脚本、rules/images.md 写提示词、rules/pitfalls.md 对照检查清单。从 rules/assets/<format>/story.json 对应模板复制到 public/<slug>/story.json，先改 slug 与 compositionId。
脚本要求：场景数约等于秒数除以十，限制在 3 到 10；每场景 24 到 32 词；数字写成单词，仅统计卡用数字；每个事实须可追溯到上下文，不得虚构；指出来源矛盾并说明采用哪种读法。图像提示词只写场景方向，统一风格在 style.artPrompt；每场景两张图以显动感，一张更平静；不得写出真实人名；用户提供参考照片时加入 references 并设置 reference，把相似度条款放在提示词最前；图像 id 全故事唯一，outro.imageId 必须是其中之一。
批准与生成：先把旁白给用户并等待批准，因为配音与图像会产生费用。然后运行 npm run generate -- --slug <slug>，会把配音、图像和实测 durationInFrames 写回 story.json，已存在文件会跳过，重复运行成本低。预览或渲染：npm run studio；npx remotion render <CompositionId> out/<slug>.mp4 --codec h264。报告前验证输出存在并读取真实时长而非假定。报告场景数、总时长、图像数、输出路径与大小，以及对模糊事实所做的假设。
全自动替代方案：当用户不需要审核步骤且已设置 OPENAI_API_KEY 时：npm run story -- --slug big-bull --context ./article.md --seconds 60 --render，一次完成起草、生成与渲染；事实质量低于手写 story.json，用于发布的场景建议走审核路径。
格式：Biography（assets/biography/story.json，60s，6 场景）、Concept explainer（assets/explainer/story.json，60s，6 场景）、Vertical short（assets/reel/story.json，30s，3 场景）、Numbered list（assets/listicle/story.json，60s，6 场景）、News or event（assets/news/story.json，45s，5 场景）、Myth versus fact（assets/myth-buster/story.json，45s，5 场景）。
示例：/story-new big-bull ./article.md 60 landscape；/story-new repo-rate "Explain the repo rate to a first time borrower" 30 vertical；/story-new fed-cut ./notes/fed.md。
限制：资料未提供具体收费、价格与平台支持范围；配音、图像生成依赖相应密钥与外部服务；全自动路径的事实准确度较低；slug、时长与方向需按约定传入。