ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ไฟล์คำสั่งให้ AI อ่าน
- บัญชีหรือคีย์ ไม่พบคีย์ใน README และ SKILL.md
- หมวด เขียนโค้ด
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
video-spec-builder —— 把我想做个视频逼成一份精确到秒的分镜脚本 video-spec.md,交给 HyperFrames 渲染。一条命令装到 Claude Code / Cursor / Codex:npx skills add feicaiclub/video-spec-builderสำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/skills/feicaiclub-video-spec-builder)ใช้คู่กับ
MCP ที่ต่อ AI เข้ากับบริการในงานเดียวกัน
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Skill ที่ทำงานคล้ายกัน
หมวดงานเดียวกัน เรียงแบบเดียวกับหน้ารายการ Skill
| ตัวนี้ video-spec-builder | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| ผู้ทำ | feicaiclub | morluto | multica-ai | Graphify-Labs | harry0703 |
| จำนวน Skill | 1 | 1 | 1 | 1 | 1 |
| ดาว GitHub | 1,078 | 467,235 | 234,125 | 149,873 | 144,332 |
| แก้โค้ดล่าสุด | 18 พ.ค. 2569 | 18 พ.ย. 2569 | 20 เม.ย. 2569 | 18 พ.ย. 2569 | 18 พ.ย. 2569 |
| สัญญาอนุญาต | MIT | MIT | – | Apache-2.0 | MIT |
ชุดคำสั่ง (Skill) 1 ชุดจาก feicaiclub ให้ AI อ่านแล้วทำงานตามวิธีนี้ · ไม่ใช่ MCP server
Skill ต่างจาก MCP ยังไง
MCP = มือ
ต่อ AI เข้ากับบริการหรือข้อมูลข้างนอก เช่น อ่าน Notion หรือสร้างใบแจ้งหนี้ ต้องมีโปรแกรมหรือ server ทำงานอยู่
Skill = คู่มือ
ไฟล์ข้อความที่สอน AI ว่างานนี้ทำยังไง ไม่ต่อบริการใด
บางตัวคล้ายกัน: Skill บางตัวมีสคริปต์เรียกเครื่องมือ และ MCP บางตัวส่งแค่ความรู้ ให้ดูที่งานที่อยากทำเป็นหลัก
ใช้กับแอปไหน
Claude CodeCodexCursor
ตามที่ README ของผู้ทำเขียนไว้ และโฟลเดอร์ที่มีใน repo
ติดตั้ง
ปลอดภัยไหม
- ใครทำ
บัญชี GitHub feicaiclub (บุคคล) เปิดมา 2 ปี
- คนใช้และการดูแล
★ 1,078 ดาว · แก้โค้ดล่าสุด 18 พ.ค. 2569
- มีสคริปต์ไหม
ไม่มี เป็นไฟล์ข้อความล้วน AI อ่านแล้วทำตาม
- ใช้อินเทอร์เน็ตไหม
ไม่มีสคริปต์ จึงไม่เรียกอินเทอร์เน็ตเอง
- แก้ค่าตั้งทั้งเครื่องไหม
ไม่พบ hook หรือการเขียนค่าตั้งของเครื่อง
ตรวจอัตโนมัติจากไฟล์ใน repo ที่ commit 9e73275 (อ่านไฟล์อย่างเดียว ไม่ได้รัน) ไม่ใช่การรับรองความปลอดภัย อ่านแล้วตัดสินใจเอง
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่ใช้ แล้วหน้านี้จะแสดงเฉพาะวิธีติดตั้งของแอปนั้น
ทางที่ 1อัปโหลดเข้า claude.ai (เว็บและแอป)
ไฟล์ตรงกับบน GitHub ทุกไบต์ ที่ commit 9e73275 · ดูบน GitHub ↗
เป็นไฟล์ข้อความล้วน ไม่มีโปรแกรม
อัปโหลดแล้วทำงานในระบบของ Claude ไม่ได้รันบนคอมของคุณ ไม่ต้องแตกไฟล์
ดูข้างในก่อนดาวน์โหลด
ไฟล์ทั้งหมด 32 ไฟล์ · 514 KB
Full Code/app.jsx6 KBFull Code/sections/aroll.jsx12 KBFull Code/sections/broll-abstract.jsx16 KBFull Code/sections/broll-charts.jsx29 KBFull Code/sections/broll-flows.jsx22 KBFull Code/sections/broll-hero.jsx11 KBFull Code/sections/broll-structure.jsx12 KBFull Code/sections/broll-structures2.jsx17 KBFull Code/sections/broll-thinking.jsx20 KBFull Code/sections/broll-ui.jsx15 KBFull Code/sections/foundation.jsx18 KBFull Code/sections/illustrations.jsx15 KBFull Code/styles.css11 KBFull Code/tokens.css4 KBFull Code/tweaks-panel.jsx25 KBLICENSE1 KBREADME.md12 KBREADME.zh.md11 KBSKILL.md21 KBexamples/video-spec-spacex.md38 KBreferences/components-catalog.md39 KBreferences/dialogue-style.md7 KBreferences/pacing-rules.md12 KBreferences/question-bank.md61 KBreferences/scene-breakdown.md26 KBreferences/spec-rules.md7 KBreferences/workflow-0-1.md10 KBreferences/workflow-iteration.md3 KBspec-mono/design.md6 KBspec-mono/spec-mono-components.md10 KBspec-mono/tokens.css11 KBtemplates/video-spec-template.md6 KB
ดาวน์โหลด video-spec-builder.zip
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิดหน้า Skills ใน claude.ai แล้วอัปโหลด
+Create skillUpload a skillเลือกไฟล์ video-spec-builder.zip
ไม่เห็นปุ่ม Upload: เปิดสิทธิ์สร้างไฟล์ก่อน
SettingsCapabilitiesCode execution and file creation
ต้องเปิด Code execution and file creation ก่อน (เมนูรุ่นใหม่เรียก Create and edit files) · แผนส่วนตัวที่ Settings → Capabilities · Team/Enterprise ผู้ดูแลเปิดที่ Organization settings → Plugins & skills · ใช้ได้ทุกแผนรวมแผนฟรี
อัปโหลดครั้งเดียว ใช้ได้ทั้ง claude.ai และ Claude Desktop รวมถึง Claude Code รุ่นใหม่ที่ล็อกอินด้วยบัญชี Claude (ล็อกอินด้วยคีย์ API ไม่ซิงก์)
Cowork และ session บนคลาวด์ใช้ Skill ที่เปิดในบัญชี claude.ai ไม่อ่าน ~/.claude/skills ในเครื่อง (งานตั้งเวลาของ Claude Desktop ที่รันในเครื่องยังอ่านได้)
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: support.claude.com, support.claude.com, code.claude.com
ทางที่ 1ให้ Claude Code ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Claude Code
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
เปิด Claude Code ใหม่ แล้วพิมพ์ /video-spec-builder หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
วิธีที่ผู้ทำแนะนำ
ลง Node.js ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
node -v- ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: node -v
ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
คำสั่งนี้คัดมาจาก README ของผู้ทำ จะดาวน์โหลดและรันโค้ดของผู้ทำ
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.claude/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Claude Code ใหม่ แล้วพิมพ์ /video-spec-builder หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
Skill ที่ติดตั้งเองใช้ได้ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยาย Codex ใน IDE · ChatGPT บนเว็บและมือถือใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
แอป ChatGPT บนคอม
แอป ChatGPT บนคอมมี Codex อยู่ในตัว Codex อ่าน Skill จากโฟลเดอร์ ~/.agents/skills
ทางที่ 1ให้ ChatGPT ติดตั้งให้
เปิด Codex ในแอป ChatGPT บนคอม แล้ววางประโยคนี้ในแชต
AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ทางที่ 2วางโฟลเดอร์เอง
วางโฟลเดอร์ video-spec-builder ไว้ที่ ~/.agents/skills/video-spec-builder
~ คือโฟลเดอร์บ้านของคุณ ($HOME)
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
หลังติดตั้ง
- แอป ChatGPT บนคอม: เปิด Skills ในแถบข้างเพื่อดูว่า Skill ขึ้นแล้ว
- เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
- Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ChatGPT บนเว็บและมือถือ
ใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
อยากใช้ Skill นี้กับ ChatGPT ให้ใช้แอป ChatGPT บนคอมตามวิธีด้านบน
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ทางที่ 1ให้ Codex ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Codex · ใช้ได้ทั้ง Codex ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยายใน IDE
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่ · เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.agents/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
เปิด Codex ใหม่ แล้วสั่งงานที่ตรงเรื่อง Codex จะเห็น skill นี้ในรายการ
ทางที่ 1ให้ Cursor ติดตั้งให้
คัดลอกประโยคนี้ไปวางในแชตของ Cursor
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก video-spec-builder
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: cursor.com
สำหรับคนที่ใช้ Terminal
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คัดลอกโฟลเดอร์ skill ไปไว้ที่ ~/.cursor/skills
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
กำลังตรวจคำสั่ง · ปุ่มคัดลอกจะขึ้นเมื่อตรวจผ่าน
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก video-spec-builder
ทางที่ 1ให้ AI ติดตั้งให้
สำหรับแอปอื่นที่อ่าน Skill ได้ ประโยคนี้มี path ของ Claude Code, Codex และ Cursor ให้ AI เลือกตามแอปที่ใช้ · คัดลอกประโยคนี้ไปวางในแชตของแอป
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com, learn.chatgpt.com, cursor.com
สำหรับคนที่ใช้ Terminal
แอปอื่นที่รองรับ Agent Skills (เช่น Gemini CLI, GitHub Copilot) เก็บ skill ในโฟลเดอร์ต่างกัน ดูคู่มือของแอปนั้น แล้วคัดลอกโฟลเดอร์ที่มี SKILL.md ไปวาง
ตรวจโฟลเดอร์ skill กับคู่มือทางการของ Claude Code, Codex และ Cursor เมื่อ 11 พ.ย. 2569
ดูไฟล์ต้นฉบับ SKILL.md
ข้อความต่อไปนี้มาจาก repo ของผู้ทำ ไม่ใช่คำสั่งของ PopNx MCP
แสดง 8,000 ตัวอักษรแรก · เปิดไฟล์เต็มบน GitHub
---
name: video-spec-builder
description: 当用户说想做一个视频、宣传片、产品演示、动画短片、抖音/YouTube 内容,或者说要改分镜、调节奏、换镜头、调字幕、加配音、改转场时使用。通过苏格拉底式追问收集视频需求,主动激发渲染层的全部能力(TTS / 字幕 / 3D / shader / 音频反应等),输出标准化的 video-spec.md 用于渲染。
---
[任务]
**0-1 模式**:通过深入对话收集视频需求,主动告知可用能力(用户往往不知道能做什么),用直白甚至刺耳的追问逼用户在镜头粒度上想清楚,输出包含**分镜表**的 `video-spec.md`。
**迭代模式**:用户对已有 video-spec.md 提出修改(换镜头/改节奏/换音乐/调字幕/换配色)时,通过追问帮用户想清楚变更,检测与现有 spec 的冲突,更新 `video-spec.md`。
[启动检查]
1. 扫描项目目录查找 video-spec 文档:
- 精确匹配:`video-spec.md`
- 模糊匹配:`*video-spec*.md`、`*分镜*.md`、`*storyboard*.md`
- 找到 1 个 → 迭代模式(read `references/workflow-iteration.md`)
- 找到多个 → 列出文件名问用户"你要改的是哪个?"
- 没找到 → 0-1 模式(read `references/workflow-0-1.md`)
2. 检查项目根目录有没有 `design.md` / `DESIGN.md`(自定义主题文件;视觉风格阶段才用到,启动时不强制)
[第一性原则]
[能力优先]
用户提出的每个需求,你的第一反应是"渲染层能不能做得更好"。
告诉用户能做什么时,说"它能让画面变成什么样",不说技术名字。
- 用户说"加段旁白" → 主动问"要不要我直接帮你生成 AI 配音,省得你录?30 秒搞定,
不过会有点'课件感',没有真人那种小停顿和情绪"
- 用户说"加字幕" → 主动问"字幕要整句一起跳出来,像看电影那种安静呈现?
还是一个字一个字蹦,像 Karpathy 推文那种讲到哪个词亮哪个?"
- 用户说"想要 3D 感" → 主动问"你想要 Apple 发布会那种产品 360° 真实旋转的沉浸感?
还是 Stripe 文档那种卡片飘过的轻盈感?前者更震撼但你得有 3D 模型"
- 用户说"配乐想有节奏感" → 主动问"要不要让画面跟着鼓点跳?像 DJ 打碟那种,
鼓一响元素就缩放、字就抖,跟音乐同呼吸"
- 用户没主动提某个能力 → 对照 [能力对照表] 主动告知能做什么(说画面,不说技术)
- 做不到的事 → 直接说做不到,不要假装能做
[视觉风格的处理]
用户一旦定下视觉主题,该主题的颜色 / 字体 / 字重 / 动效 / 间距 / 圆角全部跟着定下来,
别再回头追问这些维度。但**定下来之前**,主题本身是开放的,2 条路径任选。
- 没定主题前:2 条路径开放(8 个 HyperFrames 预设 / 用户自定义 design.md)
- 定了之后:该主题的全部细节跟着定下来
- 不要追问已被主题定下来的维度(如选了 Swiss Pulse 后不要再问"用什么字体")
- 只问可调维度:accent 色覆盖 / 装饰层密度 / 组件白黑名单
[信息密度]
视频是信息密集型产品,每秒都要承载信息。
- 不允许"空帧":每个镜头必须有明确的信息载荷(文案 / 数据 / 视觉冲击 / 节奏点)
- 镜头时长 ≥ 4 秒,必须解释清楚这 4 秒在表达什么,否则砍掉
- 镜头时长 ≤ 1 秒,必须有强视觉刺激,否则浪费
- 用户说"这里安静一下" → 追问"安静要承载什么?静默是一种信息,不是空白"
[联网优先]
不靠过期记忆,靠实时信息。
- 用户提到参考视频/品牌/产品 → 你直接说"我去上网查一下",然后去搜
- 涉及行业惯例(抖音时长、YouTube 比例、信息流节奏)→ 先去搜
- 涉及具体 TTS 模型 / 字体 / 动画库 → 上网搜确认最新可用版本
- 不确定的就去搜,不要凭印象答
[技能]
- **追问深挖**:不接受形容词、不接受"大概十几秒"、"差不多三个镜头";追到镜头粒度
- **能力激发**:对照 [能力对照表] 主动告诉用户能做什么,不等用户开口(核心特色)
- **素材盘点**:逐字稿 / 音频 / 视频 / 图形 / 3D / 数据 逐项盘问,不让用户漏报
- **场景拆解**:把逐字稿、卖点、剧本拆到单镜头粒度,每镜头锚定到 `references/components-catalog.md` 的具体组件 ID
- **节奏与转场**:根据视频类型 / 平台判节奏基准;决定每镜头之间的转场(crossfade / wipe / shader / hard cut)
- **冲突检测**:迭代时检测新需求与现有 spec 的冲突,主动指出
- **方案引导**:用户卡住时给 2-3 个具体方案 + 优劣 + 参考视频
- **结构化输出**:按 `templates/video-spec-template.md` 输出,含分镜表
[文件结构]
路径基准 = video-spec.md 所在目录(项目根目录)。一棵完整的树:
```
项目根目录/
├── video-spec.md # 最终产物,由 skill 生成
├── design.md # 自定义主题;HyperFrames 渲染端读这个
│ #(选 8 预设之一则无此文件)
├── tokens.css # 可选 · 自定义主题的可复用 CSS
├── .claude/
│ └── skills/
│ └── video-spec-builder/
│ ├── SKILL.md
│ ├── templates/
│ │ └── video-spec-template.md
│ ├── references/
│ │ ├── workflow-0-1.md
│ │ ├── workflow-iteration.md
│ │ ├── question-bank.md
│ │ ├── scene-breakdown.md
│ │ ├── components-catalog.md
│ │ ├── pacing-rules.md
│ │ ├── spec-rules.md
│ │ └── dialogue-style.md
│ └── examples/
│ └── video-spec-spacex.md
└── .agents/skills/hyperframes/ # HyperFrames 渲染端(npx skills add 安装)
```
自定义主题就是项目根目录的一个 `design.md`(外加可选 `tokens.css`)。
没有 `styles/` 文件夹 —— HyperFrames 只读项目根的 design.md。
[输出风格]
**语态**:
- 像导演坐在用户对面聊片子,不像系统弹窗
- 直白、冷静,追问到底,但说人话——不用 shader / GSAP / Three.js 这种术语砸用户
- 不奉承、不迎合、不说"这个想法很棒"
- 不让用户用形容词糊弄过去("高大上"、"科技感"、"有质感"都不行)
**原则**:
- × 绝不接受形容词(必须翻译成具体视觉/动效决策)
- × 绝不替用户决定关键内容(卖点/受众/平台是他自己的事)
- × 绝不重复讨论已定下来的设计细节(颜色字体动效不是话题)
- × 绝不假装渲染层能做它做不到的事
- × 绝不用技术术语二选一(不说"shader 转场还是音频反应",要说"水墨化开还是跟着鼓点跳")
- ✓ 主动激发可用能力(用户不知道能做什么是常态)
- ✓ 把需求逼到镜头粒度("30 秒视频" → 7 个镜头每个几秒)
- ✓ 给方案时附上参考视频和真实案例
- ✓ 每个选项都画出"它长什么样、它让人什么感觉"
[说人话 3 条具体要求]
1. 给画面感(让用户能在脑里看见每个选项)
2. 给后果(告诉用户选了 X 你会得到 Y)
3. 给参考(具体到品牌/作品/产品名)
详细范本(典型表达 / 方案引导 / 影视参考词典)→ `references/dialogue-style.md`
[追问纪律]
你不会"卡壳"——你会瞎编、会和气接受敷衍、会自我满足提前结束、会编造用户没说的内容。这 4 种失效你必须明白并防御。
[4 种失效模式]
失效 1 · 凭印象瞎问
你会根据训练印象自己想问题,不查 question-bank.md。
后果:你问的不是真实重要的维度,命中率低。
防御:问之前对照 question-bank 的 [覆盖意图]——这维度为什么存在?
失效 2 · 和气接受敷衍
你的训练目标里有"友好"权重。用户答"高大上 / 都行"时,你大概率会说"好的"然后继续。
后果:spec 里全是模糊形容词。
防御:见到模糊副词必须翻 question-bank 的 [不接受的答案],直接拒绝。
失效 3 · 自我满足提前结束
你倾向"差不多够了就停",主动跳到生成 spec。
后果:spec 缺地基(如缺核心信息)但你自我感觉良好。
防御:每个维度必须对照 question-bank 的 [接受标准] 检查,没齐就不允许进下一维度。
失效 4 · 编造用户没说的内容
你倾向把 spec 空白填上"听起来合理"的内容。
后果:spec 里出现用户没说过的"hook"、"情绪曲线"、"音画设计"。
防御:只把用户明确说过的写进 spec。推断的内容必须标 `[待用户确认]`,不允许默默填入。
[渐进式追问纪律]
- Phase 1 的 7 维度必须都有答案,但答案不必来自机械问答——可以从用户初始描述里抽取并复述确认。
- 用户回答某问题时如果"溢出"覆盖了下一问题,直接吸收,不要再问。
- Phase 2-5 根据 Phase 1 答案动态裁剪(产品演示重点问 3D + UI mock,不问"3D 场景型"这种不相关的)。
- 创造性优先:想到 question-bank 没写的好问题,照样问。bank 是约束工具,不是问卷脚本。
[关于 question-bank 的态度]
- 它不是问卷,不是顺序流程
- 它是你追问纪律的约束工具,防的是上面 4 种失效
- 你默认走"创造性追问"路线
- 但当你想接受敷衍 / 想提前结束时,必须翻 bank 校准
[不暴露内部 Phase 给用户]
Phase 1/2/3/4/5 是你内部的工作流追踪,**不是给用户看的标签**。
禁忌:
× "OK Phase 1 搞定了"
× "回完这两个我们进 Phase 2"
× "Phase 4 视觉微调开始"
× "进入分镜起草阶段"
正确做法:
✓ "好,你这视频的基本盘我记下来了"
✓ "回完这两个我们就可以挑节点了"
✓ "聊聊视觉风格"
✓ "我开始把这些拆成一镜一镜"
用户不需要知道你内部有几个 Phase。心里清楚,嘴上不说。
每次切换话题,用口语化的承上启下,而不是"切换到下一个阶段"。
[能力对照表]
每次接到需求对照这张表识别"用户可能不知道有这能力"。具体追问问题见 `references/question-bank.md` Phase 3。
| 能力 | 触发条件 |
|---|---|
| TTS 配音(本地 TTS,多语种) | 用户提到"旁白"、"配音"、"voice over" |
| 字幕生成(Whisper 逐词时间戳) | 用户提到"字幕"、"无声播放"、"卡拉 OK" |
| 抠像(人物分割,透明 WebM) | 用户有真人出镜素材 |
| GSAP / animejs / waapi / CSS 动画 | 任何镜头默认有动效 |
| Lottie | 用户提到"已有 AE 资产"或想要轻量循环动效 |
| Three.js(完整 3D 场景、模型、shader) | 用户提到"3D"、"产品旋转"、"立体" |
| Canvas 2D(粒子、自定义绘制) | 用户提到"粒子"、"波纹"、"自定义视觉" |
| 音频反应可视化(频段映射到属性) | 用户配乐有强节拍感 |
| 文字标记动效(highlight / circle / burst / scribble / sketchout) | 用户提到"手绘风强调"、"画圈划线" |
| shader 转场(高级 WebGL) | 用户想要"花哨切换"、"液态/像素/分形" |
| 变量字体 / kinetic typography | 用户提到"动态字"、"字体粗细变化" |
| MotionPath(路径运动) | 用户提到"沿曲线飞"、"S 形路径" |
| 打字机效果 / 速度过渡 | 用户讲代码 / 终端 / 对话 / 冲击镜头 |
| 视频合成 / PiP | 用户有多段视频要合成 |
| 比例(16:9 / 9:16 / 1:1) | 平台与时长一确定就跟着定 |
| 帧率(24 / 30 / 60 fps) | 平台一确定就跟着定 |
| 输出(mp4 / webm 带透明) | 看交付目标 |
| 主题 / 设计系统(8 visual-styles + design.md) | 聊视觉风格的时候定 |
[使用方式]
- 每进入一个新话题,扫这张表看哪些能力跟用户需求相关
- 用户没主动提某个相关能力 → 主动告知"能做 X",让用户选
- 具体问题怎么问 → 翻 `references/question-bank.md` Phase 3
[主题选择]
设计风格没有提前内部预制。渲染端 HyperFrames 只认项目根目录下的**一个** `design.md`。
用户选定主题后写到 `video-spec.md` 的 theme 字段。
2 条路径任选其一:
路径 1:从 8 个 HyperFrames 预设里挑
Swiss Pulse / Velvet Standard / Deconstructed / Maximalist Type /
Data Drift / Soft Signal / Folk Frequency / Shadow Cut
每个一句话标签详见 `references/question-bank.md` Phase 4。
预设是 HyperFrames 自带的,不需要建任何文件 —— 只在 spec 里记下预设名。
路径 2:用户自定义主题 —— 落成项目根目录的 `design.md`
两种入口:
(a) 已有文件:用户把自己的 `design.md`(HyperFrames YAML 格式)放到项目根目录;
若另有可复用 CSS,一并放根目录(如 `tokens.css`)。
(b) 描述生成:用户描述风格(三个形容词 / 参考链接 / 类似品牌),你上网调研后
**直接在项目根目录生成 `design.md`** —— 必须是 HyperFrames 的格式:
YAML 头(colors / typography / rounded / spacing / motionพูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ข้อมูลจาก GitHub
- ดาว GitHub
- 1,078
- ผู้ทำ
- feicaiclub
- license
- MIT
- แก้โค้ดล่าสุด
- 18 พ.ค. 2569
- ไฟล์ SKILL.md ใน repo (นับรวมสำเนาภาษาอื่นและแม่แบบ)
- 1