SanHsien

Video Spec Builder — Testing skill for Claude Code

Testing community

將影片需求精確拆解為分鏡腳本 video-spec.md 的 Agent Skill,Windows 原生維護 fork|Distill video ideas into second-accurate storyboard specs (video-spec.md) for HyperFrames.

How to install Video Spec Builder

This entry records only its repository, not the path inside it, so there is no exact command to give. Open SanHsien/video-spec-builder and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Video Spec Builder does

將影片需求精確拆解為分鏡腳本 video-spec.md 的 Agent Skill,Windows 原生維護 fork|Distill video ideas into second-accurate storyboard specs (video-spec.md) for HyperFrames. Windows-first maintenance fork of feicaiclub/video-spec-builder.

Alternatives in Testing

README

ChatGPT Image May 16, 2026, 10_46_58 PM

[English](README.en.md) | **繁體中文**

video-spec-builder(SanHsien 維護 fork)

[![CI](https://github.com/SanHsien/video-spec-builder/actions/workflows/ci.yml/badge.svg)](https://github.com/SanHsien/video-spec-builder/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen)](LICENSE) ![Agent Agnostic](https://img.shields.io/badge/Agent-Agnostic-blueviolet) [![skills.sh Compatible](https://img.shields.io/badge/skills.sh-Compatible-brightgreen)](https://skills.sh)

本專案為 [`feicaiclub/video-spec-builder`](https://github.com/feicaiclub/video-spec-builder) 的 Windows-first 維護型 fork,聚焦於 Windows 11 原生開發者體驗、自動化驗證門禁與逐筆審查之上游追蹤。英文版請見 [`README.en.md`](README.en.md),維護決策請見 [`FORK.md`](FORK.md)。

一個像影片編導的 Agent Skill。你說一句「我想做個影片」,它就追著問你,幫你把想法理成一份能落地的分鏡腳本。

我做這個 skill,是因為發現做影片最卡人的不是渲染,是前面那一步:想清楚。

你心裡有個念頭,想做個產品介紹、發則短影音、做個公司簡介。可念頭是模糊的。真要落地,每個鏡頭幾秒、畫面上擺什麼、先講什麼後講什麼,這些細節你未必想得全,也未必說得出來。

`video-spec-builder` 就是來陪你過這一關的。裝好之後,你在 Codex、Claude Code 或 Antigravity 裡說一句「我想做個影片」,它就接管對話,像編導聽你講 brief 那樣一路追問:這影片給誰看?多長?最想讓人記住哪句話?哪個鏡頭是重點?你答不上來的、壓根沒想到的地方,它會停下來提醒你、幫你補上。

來回聊下來,你那個模糊的念頭會變成一份 `video-spec.md`:精確到秒、每個鏡頭都寫明白的分鏡腳本。這份腳本交給 HyperFrames,就能渲染成真正的影片。

它不替你拍片,也不替你想創意。它就做一件事:逼著你、也陪著你,把想法想到能落地為止。

它幫你解決什麼

它解決的是「我有想法,但說不清楚」這個問題。幾種典型情況它都管用:

  • 你知道想要什麼感覺,但說不出具體畫面。它會把「高大上」「有衝擊力」這種形容詞擋回去,問到你能描述出實際的畫面和動作為止。
  • 你有想法,但有些環節根本沒想到。比如開頭結尾想好了,中間怎麼過渡沒想;比如你沒意識到這段可以加字幕、可以讓畫面跟著音樂節奏動。這些它會主動提。
  • 你東西不少,但理不出頭緒。逐字稿、賣點、素材一大堆,它幫你拆成一個個鏡頭,排出先後和節奏。

最後它把這些落成腳本。每個鏡頭是什麼內容、用什麼呈現、停幾秒、怎麼轉到下一個,全寫清楚。

它有兩種用法。手上還沒有腳本,它從頭陪你聊一遍,產出 `video-spec.md`。已經有腳本、只想改某個地方,你直接說要改什麼,它問清楚再動手,還會順手查一下這改動會不會牽連別的鏡頭。

工作流程

整件事是兩個 skill 接力。video-spec-builder 在上游,把你的想法變成腳本;HyperFrames 在下游,把腳本變成影片。

        你:「我想做個影片」
                 │
                 ▼
    ┌────────────────────────┐
    │   video-spec-builder   │   追問 + 拆鏡頭,陪你想清楚
    └────