yuyolin/act-skill

---

✨ 它解决什么

多数 AI 视频提示词会写很多画质、镜头和场景词，却只给演员一句：

她非常悲伤，眼含泪水。

这不是表演指导，只是情绪标签。模型不知道：悲伤从哪一刻开始、角色在压住什么、身体先发生什么、泪水是否应该出现、镜头为什么移动。

表演skill 会把它转译成可执行节拍：

听到触发词后，她仍把手上的动作做完一半，视线没有抬起；下颌只绷紧一瞬，呼吸在下一句话前卡住。她试图维持正常语速，却在关键词后出现多余停顿。镜头保持静止，直到第一次情绪泄漏后才缓慢靠近，并在眼神可读的位置停止。禁止触发前落泪。

核心区别是：

🔥 为什么它不只是提示词模板

表演skill 是一套从剧情到可生成表演的导演工作流：

flowchart LR
    A["锁定剧情事实"] --> B["外部目标 + 内部压抑目标"]
    B --> C["情绪曲线与触发事件"]
    C --> D["检索情绪知识库"]
    D --> E["八维表演设计"]
    E --> F["对白、呼吸与沉默"]
    F --> G["Camera Intent"]
    G --> H["时间轴与连续性质检"]
    H --> I["Kling / Seedance 2.0 提示词"]

它不会把知识库内容生硬贴进提示词。工作顺序永远是：先理解人物，再检索；先判断动机，再选择动作。 找不到合适条目时，Skill 会自主生成，而不是硬套模板。

🧠 核心方法

1. 表演内容占绝对主导

默认提示词信息预算：

背景一致性、人物一致性和摄影信息都会检查，但只保留最必要的锚点，不允许反客为主。

2. 八维表演框架

每个关键节拍依次判断：

1. 时间与镜头
2. 外部目标与内部压抑目标
3. 情绪起点、触发、变化与终点
4. 触发事件与表演载体
5. 肉眼可见的面部动作
6. 视线、身体、重心与行动完成状态
7. 声音、呼吸、停顿、抢话与沉默
8. 结束残留与禁止过早发生的反应

3. Camera Intent：机位也在“表演”

机位的位置、静止和移动必须回答：

观众此刻需要感受到什么，因此机位为什么在这里，为什么动或不动？

• 静止可以表达压迫、等待、尴尬或无处可逃。
• 运动必须由触发、关系变化、信息揭示或人物行动启动。
• 推近需要写明触发点、路径、速度、持续时间和停止位置。
• 不使用“悲伤必推近、愤怒必手持”之类的机械公式。

4. 对白不是字幕，而是表演事件

Skill 会区分：

• 谁在说话，镜头在看谁
• 哪个词触发听者反应
• 画外声、电话声和门外声的位置
• 谁打断谁，被打断者留下什么未完成反应
• 无对白时，什么声音、物件或目光承担触发作用

🚀 快速开始

在 Codex 中调用

使用表演skill。

模型：Seedance 2.0
总时长：12 秒
人物关系：刚分手的恋人
场景：深夜厨房
剧情：她听完对方的最后一条语音，试图装作没事
对白：“好，我知道了。”
核心情绪：迟发、克制的悲伤
必须保留：她手里一直拿着杯子
不要出现：触发前落泪、夸张颤抖、无动机运镜

信息不完整也可以调用。Skill 会使用容易回退的保守假设；只有缺失内容会改变剧情事实时才询问。

安装

将 Skill 目录复制或链接到 Codex 的 skills 目录：

skills/direct-ai-actor-performance

知识库默认自动发现仓库内的：

knowledge-base/情绪

也可以通过环境变量指定自定义知识库：

$env:ACT_SKILL_KB="D:\your-path\knowledge-base\情绪"

📚 可扩展情绪知识库

仓库同时保留两种格式：

• 情绪表演知识库-v1.md：便于 GitHub 阅读、比较和协作。
• 情绪表演知识库-v1.docx：排版完成的 Word 版本。

当前初始条目覆盖：

• 悲伤：克制、迟发与崩溃边缘
• 愤怒：压抑、防御与短促爆发
• 恐惧：冻结、侦测与求生反应
• 羞耻：缩小自己与避免被看见
• 内疚：自责、修复与不敢靠近
• 思念与失落：被日常物件触发
• 欣喜与释然：确认之后才释放
• 嫉妒与不安：观察、比较与掩饰

每个合格条目必须包含：适用前提、双重目标、明确触发、情绪阶段、面部/身体/声音证据、结束残留、表演禁区、简短机位支撑和可直接取用的提示词片段。

检索示例：

python skills/direct-ai-actor-performance/scripts/search_emotion_library.py `
  --query "悲伤 克制 迟发 不愿被看见" `
  --top-k 5 `
  --json

🎬 Kling 与 Seedance 2.0

Skill 先生成平台无关的表演母版，再做最小模型适配：

模型能力变化不会影响核心表演逻辑。仓库不会把某个平台的新功能误写成所有版本都具备的能力。

🧪 时间轴验证

仓库提供对白时长与镜头节拍检查脚本：

python skills/direct-ai-actor-performance/scripts/validate_timeline.py examples/timeline.json

它会检查：

• 节拍重叠或未说明空档
• 起止时间错误和总时长越界
• 对白估算时长是否超过可用时间
• 动作预留时间是否足够

🗂️ 项目结构

act-skill/
├─ skills/
│  └─ direct-ai-actor-performance/
│     ├─ SKILL.md
│     ├─ agents/openai.yaml
│     ├─ references/
│     └─ scripts/
├─ knowledge-base/
│  └─ 情绪/
│     ├─ 情绪表演知识库-v1.md
│     └─ 情绪表演知识库-v1.docx
├─ applications/表演skill/
│  ├─ validation/
│  └─ 最终验收.md
├─ examples/
├─ docs/
├─ registry/skills.json
├─ CHANGELOG.md
└─ README.md

✅ 质量边界

交付前必须确认：

• 情绪变化由明确事件触发，而不是凭空切换。
• 每个抽象情绪至少拥有一个可见或可听的证据。
• 表情、呼吸、身体和声音循序发生，没有同时堆叠。
• 对白归属、画外声、打断和反应对象明确。
• 时间装得下对白、停顿和动作。
• 运镜有触发、有停止位置，且没有抢走演员反应。
• 连续性信息简短，从属于表演。
• 所有新增内容只补足执行信息，不擅自改写剧情事实。

🧭 版本计划

• v1.x：扩展情绪条目、实例与检索质量。
• v2.x：增加人物关系、表演强度和长镜头节拍知识库。
• 后续方向：真实生成结果回灌、失败样本分类、模型差异回归测试。

详见 CHANGELOG.md。

🤝 贡献情绪材料

欢迎提交电影表演观察、微表情笔记、声音节奏、身体行为、成功提示词和失败案例。内容不会原样堆进知识库，而会经过：

来源标注 → 去重 → 适用条件判断 → 可执行化 → 禁区补充 → 检索测试

请先阅读 docs/knowledge-base-guide.md。

📄 权利说明

本项目采用 MIT License，允许使用、修改和再发布，但必须保留版权与许可声明。

---