需要写 YouTube 视频脚本并保持频道风格一致时：用偏好…

当用户需要针对任意主题生成完整、可直接制作的 YouTube 视频脚本，并希望脚本符合其类型、语气、受众、长度、Hook 和风格偏好时使用。

适用场景

解决思路

1. 运行 `python3 scripts/script_db.py is_initialized` 检查偏好是否已初始化；若返回 'false' 则进入首次偏好收集，若返回 'true' 则直接进入生成脚本。
2. 首次使用时收集脚本类型偏好（可多选）：Educational/Tutorial、Listicle/Top X、Story/Narrative、Review、Vlog style、Commentary/Opinion、How-to、Explainer、Entertainment。
3. 收集语气偏好：Professional/Authoritative、Casual/Friendly、Energetic/Enthusiastic、Educational/Patient、Inspirational/Motivational、Humorous/Entertaining、Conversational。
4. 收集目标受众：年龄范围（teens、20s-30s、35-50、50+）、知识水平（beginners、intermediate、expert）、demographics、interests、pain points。
5. 收集风格偏好：措辞风格（Simple/Direct、Descriptive/Vivid、Technical/Precise、Storytelling）、句子长度（Short/punchy、Medium、Long/flowing）、段落结构（Quick cuts、Balanced、Longer sections）、是否使用反问句（Yes/No/Sometimes）、统计/数据使用（Heavy、Moderate、Light、None）。
6. 收集视频长度偏好：Short form（3-5 分钟，约 450-750 words）、Medium form（7-12 分钟，约 1,050-1,800 words）、Long form（15-30 分钟，约 2,250-4,500 words）。
7. 收集 Hook 风格：Question-based、Bold statement、Conflict/Problem、Promise/Benefit、Shock value、Story opening。
8. 收集 personality：Energetic and animated、Calm and measured、Witty and humorous、Serious and thoughtful、Passionate and intense、Relatable and down-to-earth。
9. 收集额外偏好：Use humor（Yes/No/Sparingly）、Include statistics（Always/When relevant/Rarely）、Storytelling approach（Heavy/Moderate/Light）、Call-to-action preference（Direct/Soft/Minimal）、Personal anecdotes（Frequently/Occasionally/Rarely）、Channel niche/focus。
10. 保存偏好：在 Python 中执行 `sys.path.append('[SKILL_DIR]/scripts')`，`from script_db import save_preferences`，构造 preferences 字典（包含 script_types、tone、target_audience、style、video_length、hook_style、personality、use_humor、storytelling_approach、call_to_action_preference、channel_niche），调用 `save_preferences(preferences)`。
11. 用户请求脚本时收集必要信息：Topic/Title、Key Points（3-5 个）、Video Length、Special Requirements、Target Keywords（可选）。
12. 根据偏好和 `references/script_formats.md` 创建脚本结构。
13. 使用标准 YouTube 脚本结构：HOOK 0:00-0:10 用一句开场阻止划走；INTRO 0:10-0:45 包含快速问候、视频内容、观看理由、将学到什么、个人可信度/背景；MAIN CONTENT 0:45-8:30 中每个主点包含引入、解释、例子/故事、收益/应用、过渡；CONCLUSION 8:30-9:30 回顾主点、关键收获、最后想法、为 CTA 铺垫；CALL TO ACTION 9:30-10:00 包含主要 CTA（subscribe、like、comment）、次级 CTA（links、next video）、sign-off。
14. 生成完整脚本时按用户风格偏好输出：标题、时长、风格、带时间码的分段、HOOK、INTRO、MAIN CONTENT 各节及 visual cue、CONCLUSION、CTA、制作备注、字数、预估时长、目标受众、语气、关键 Hook。
15. 呈现脚本后提供调整选项：强化 hook、调整长度（trim 或 expand）、改变语气（更/更不正式）、增加/删除幽默、加入更多统计、简化语言、加入叙事元素、强化 CTA。
16. 保存最终版本：`from script_db import add_script`，构造 script 字典（title、type、tone、word_count、duration_minutes、content、notes），调用 `add_script(script)`。
17. Hook 创作：前 5 秒关键；做出承诺；制造好奇；解决痛点；使用 pattern interrupts。
18. 控制节奏：变化句子长度；混合短段落和长段落；建立势头；策略性停顿；能量转换。
19. 提升参与：直接向观众提问；使用个人故事；使用可共鸣例子；预先处理反对意见；使用 social proof。
20. 优化留存：预告即将内容；使用 callback references；每 30-60 秒使用 pattern interrupts；制造策略性信息缺口；兑现承诺。
21. 设计 CTA：只用一个主要 CTA；解释收益；使其具体；制造轻微紧迫感；自然融入。
22. 使用 Educational Tutorial 模板：HOOK 问题陈述+解决方案承诺；INTRO 个人背景+将学到什么+为何重要；SECTION 1 概念解释（是什么、为何重要、常见错误）；SECTION 2 分步过程（Step 1 带 visuals、Step 2 带 examples、Step 3 带 tips）；SECTION 3 常见陷阱（避免什么、troubleshooting）；CONCLUSION 回顾+关键收获+下一步；CTA 订阅+资源+评论提示。
23. 使用 Listicle 模板：HOOK 数字预告+意外角度；INTRO 背景+为什么这个列表重要；ITEM 5 倒计时制造悬念（是什么、为何有效、如何使用）；ITEM 4/3/2 重复结构；ITEM 1 最重要/最意外（额外强调、最佳收益）；CONCLUSION 回顾数字+终极收获；CTA 强指令+资源提及。
24. 使用 Story/Narrative 模板：HOOK 引人入胜故事开场；INTRO 设定故事背景；SECTION 1 问题/冲突（建立张力、展示风险、使其可共鸣）；SECTION 2 旅程（面对的挑战、尝试与失败、学习时刻）；SECTION 3 解决（如何成功、转变）；CONCLUSION 教训+观众如何应用；CTA 邀请类似故事+订阅。
25. 按所选语气写作，例如 Casual-Friendly 用 'Hey everyone! So, funny story...'，Professional-Authoritative 用 'In today's video, we're examining...'，Energetic-Enthusiastic 用 'Okay, THIS is insane!...'，Educational-Patient 用 'Let's break this down step by step...'。
26. 写作时避免常见错误：弱 hook（5 秒内进入重点）；长 intro（有价值前不要闲聊）；无结构（观众需要 signposts）；单调表达（变化 energy 和 pace）；信息过载（聚焦关键点）；忘记观众（直接对他们说）；CTA 被埋没（清晰且可行动）；无个性（展示独特 voice）；太正式（YouTube 要 conversational）；无 visual cues（包含 filming notes）。
27. 使用 CLI 命令管理数据：`python3 scripts/script_db.py get_preferences`、`python3 scripts/script_db.py get_scripts`、`python3 scripts/script_db.py stats`。
28. 将偏好、脚本历史和模板持久化保存到 `~/.claude/script_writer.json`，以保持风格一致。
29. 按字数指南写作：说话速度约 150 words per minute；Short form（3-5 分钟）450-750 words；Medium form（7-12 分钟）1,050-1,800 words；Long form（15-30 分钟）2,250-4,500 words。
30. 参考 `scripts/script_db.py` 管理偏好、脚本、模板；参考 `references/script_formats.md` 获取常见 YouTube 视频类型和结构、脚本组件拆解（hook、intro、content、conclusion、CTA）、语气指南、时长指南、参与技巧、常见错误、visual cues、受众调整、平台注意事项。
31. 交互时先问要覆盖几个点子、具体角度、个人经验还是研究；生成后说明字数、时长和特点，并询问是否需要调整。

适用边界 · 注意事项

• 不适用于非 YouTube 视频脚本或非视频内容（如博客、播客、广告），除非重新调整模板和平台注意事项。
• 不适用于缺少主题、关键点或用户偏好的情况，否则无法生成符合风格和时长的完整脚本。
• 不适用于要求实际拍摄、剪辑、配音或发布运营的任务；本技能只生成文字脚本和制作备注。