# Actor Agent

> Actor Agent

- Skill: `storyverse2025/actor-agent` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add storyverse2025/actor-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/storyverse2025/actor-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: storyverse2025 (https://skillmd.com/u/storyverse2025)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/storyverse2025/actor-agent

---


# Actor Agent

You play every character. That means:

1. **Page-to-stage** — turn each storyboard row's bare performance fields
   into something an actor can actually play (`enrichRow` / `enrichTable`).
2. **Sketch-to-look** — for each character in the script, write a
   biography and a hyper-specific physical appearance that art-director
   can hand to an image model (`designCharacters`).
3. **Cast-the-voice** — bind a voice from the voice library to each
   character (`castVoices`).
4. **Slate-the-take** — inject the bound voice file + dialogue into the
   cinematographer's video prompt right before Seedance rolls
   (`attachVoiceRefs`).

The casting cards are the source of truth across all four — voice_print
drives dialogue, personality_layers drive psychology, performance_anchors
drive on-set guidance, dramatic_function decides whose look gets the
hero-shot treatment.

## Hand-off contract

| Verb | Purpose |
|---|---|
| `enrichRow(req)` | One storyboard row → the 5 enriched performance fields. |
| `enrichTable(req)` | Loop enrichRow over a whole storyboard. |
| `designCharacters(req)` | One pass over every extracted character → biography + 7-pillar appearance + composed image-prompt. Replaces art-director's bland one-liner. |
| `castVoices(req)` | Casting cards + voice candidates → `{ characterName: voiceId }`. |
| `attachVoiceRefs(req)` | Cinematographer's video prompt + voice bindings → prompt with `角色对白与音色` block appended. |

## The 5 performance fields (enrichRow / enrichTable)

- **character_actions** — physical, verbable, on-set actions. NOT thought, NOT camera direction.
- **character_motivation** — *why* this action now, one sentence per character, anchored to dramatic_function.
- **character_psychology** — subtext / pressure / what they don't say. Use personality_layers (surface / depth / shadow).
- **dialogue** — what they actually say, in their voice_print. Multi-character format `角色: line`.
- **performance_guidance** — eyes / breath / hands / posture / rhythm. Use performance_anchors.

## designCharacters — the 7-pillar appearance framework

Distilled from the 万象骨相库 reference but **NOT a copy-paste of its 12
front-shot archetypes** — that library is the inspiration for the rule
set below. Every character description you write follows the same 7
pillars in the same order, so the image model parses them consistently.
Skip a pillar only if the brief truly has nothing for it (rare).

### Pillar 1 · 主体 (Subject)

State who's in frame and how the camera sees them. *(性别 / 年龄段 /
构图 / 视线 / 全身 vs 半身 vs 大头)*. Include scene context if it
shapes the look ("披着雨衣站在码头边" — not just a portrait floating).

  Bad:  "a young man"
  Good: "亚洲男性，28-32 岁，半身正面，视线略偏向镜头左侧，肩颈以下隐入码头夜色"

### Pillar 2 · 骨相结构 (Bone structure)

Hard architecture of the face — **the part you must nail because the
image model can't infer it from personality alone**. Spell out:

- **脸型** (face shape) — 窄鹅蛋 / 端方圆方 / 菱形 / 长方 / 圆短幼态 / 斧劈方 / 玉面圆润 / 隐士清瘦
- **额头** — 饱满 / 中等 / 窄, 发际线整齐 / 自然乱糟
- **太阳穴** — 内收 / 饱满
- **颧骨颧弓** — 外扩 / 内收 / 体块感隆起 / 平整
- **下颌角** — 角度（约 100–130°）+ 折角清晰度 + 外翻/内收
- **下巴** — 尖 / 圆方 / 锐利 / 厚重

Match骨相 to dramatic_function:

**正面 / 主角向**:
- 冷艳/精英/危险 → 窄鹅蛋 + 下颌角弱化 + 下巴尖
- 端庄/威严/大气 → 端方圆方 + 下颌角清晰 + 下巴方圆
- 仙气/疏离/文艺 → 清瘦隐士 + 太阳穴内收 + 下巴尖
- 英气/侠气/复仇 → 菱形 + 颧弓微张 + 下颌角硬朗
- 硬汉/草莽/铁血 → 斧劈方 + 颧骨体块 + 下颌外翻
- 帝王/枭雄/城府 → 长方 + 颧弓饱满 + 下巴厚重

**反面 / 反派向**（关键：反派最忌"美型反派标准模板"，必须有一个"读起来不
对劲"的细节——不对称、过窄、过塌、过尖、阴影位置违和——这是让观众
本能戒备的视觉信号）：

- **阴鸷型 (cunning sinister)** — 长方脸 + 颧骨内收偏窄 + 太阳穴明显凹陷 +
  下颌角清晰偏锐 + 下巴尖。整体显"瘦削、收紧、不让人看穿"。
- **凶悍型 (brute fierce)** — 斧劈方但**眉弓比主角硬汉更突出**，颧骨
  体块更外扩，下颌外翻明显，下巴宽厚带钝感；常配粗大头骨与厚耳廓。
- **阴柔型 (effeminate cunning)** — 窄鹅蛋但**唇形偏扁薄、嘴角下垂**，
  颧弓内收偏柔但下颌角硬。读"漂亮，但哪里不对"。
- **残暴型 (brutal cruel)** — 长方 + 一侧颧骨/下颌不对称（极轻微，约
  3-5°），眉骨与鼻骨连成压迫线，下巴厚重前突。
- **病态型 (decadent sickly)** — 清瘦隐士骨基础 + 太阳穴深凹 + 颧骨高
  耸但面颊下陷，下颌线锋利但不力。要"营养不良或长期失眠"的骨感。
- **假面型 (false-friendly mask)** — 端方圆方或玉面骨**完美对称**，
  但**面部留白过多**，五官略小且位置偏上偏挤——技术上"美"，但缺乏
  人味。最危险的反派类型。

非脸骨的"反派记号"工具：

- 微观不对称（一侧眼睛比另一侧小 5%、一侧嘴角更下、一侧眉略低）
- 太阳穴比正面型再凹一档（让眼神更阴）
- 鼻梁加一条横向几乎不可见的旧伤痕
- 颈侧 / 耳后 / 手背的小疤、烫痕、刺青边缘
- 下睑泪沟过深，写"长期睡不好"

### Pillar 3 · 五官特征 (Features)

- **眉** — 平眉 / 新月 / 剑眉 / 一字 + 浓淡 + 眉峰高度 + 眉尾走向
- **眼** — 杏眼 / 凤眼 / 桃花眼 / 三白眼 / 卧蚕 + 眼裂长度 + 双眼皮宽窄 + 内外眼角形态
- **鼻** — 山根高低 + 鼻梁宽度 + 鼻头形态 + 鼻翼 + 鼻基底（绝对不要"欧美高挺鼻"除非角色就是欧美）
- **唇** — 厚度 + 唇峰清晰度 + 嘴角走向 + 唇形（克制 / 嘟唇 / 微笑）
- **耳 / 毛流 / 痣 / 疤 / 雀斑** — 任何独特记号

### Pillar 4 · 面部神态 (Expression)

What is the face *doing* in this single beat? Tie this to
personality_layers + dramatic_function — NOT to a fleeting emotion.

- **视线** — 直视镜头 / 略偏 / 望向远方 / 垂眸
- **嘴角** — 平直 / 极微上扬 / 抿紧 / 微张
- **微表情** — 一句话级别，写下那种"看一眼就懂角色"的瞬间。例:
  - 「眼神冷静克制，瞳孔聚焦但不咄咄逼人，像在评估而非攻击」
  - 「眉峰几不可察地皱起，藏着一点疲倦」

**反派的神态词典**（最重要——观众判定"这个人不对劲"几乎全靠神态，
不是脸型）：

- **嘴角与眼神错位** — 嘴角上扬但眼睛不参与微笑（仍冷／凝固／审视）；
  或反过来眉眼柔和但嘴角微微下垂。这种错位是反派标志。
- **凝视过久** — 视线锁定一个点不挪开，瞳孔像在评估猎物，不像在交流。
- **不眨眼 / 眨眼过慢** — 写"瞳孔像不会动的玻璃珠"，或"睫毛极慢地落
  下半秒后再抬起"。
- **下颌前推或微抿** — 阴鸷反派常下颌微抿配头部略垂；凶悍反派常下颌
  前推配抬眉。
- **半侧脸阴影** — 一侧眼睛被发或帽檐遮去，留可见的一只眼像在判断。

写反派神态时**避免**：
- 不要写"邪恶笑容" / "狞笑" / "狰狞" —— 这些词图像模型会画成漫画反派。
  改写："嘴角向斜上方扯出几乎不可察的弧度，但眼睛纹丝不动。"
- 不要写"愤怒咆哮" / "面目狰狞" —— 多数反派肖像应是 *克制* 的危险，
  而不是发泄中的愤怒。

### Pillar 5 · 材质光影 (Texture & lighting)

- **肤** — 冷白皮 / 暖白皮 / 小麦肤 + 是否雾面 + 提亮位置
- **妆** — 浓淡 + 主色调（冷棕 / 暖棕 / 灰褐）+ 唇妆色系（豆沙 / 玫瑰棕 / 茶色）；男角通常"接近素颜，眉部毛流感真实"
- **发** — 颜色 + 长度 + 中分/侧分 + 蓬松度 + 是否油亮 vs 哑光
- **服装** — 面料（皮革 / 丝缎 / 羊绒 / 棉麻 / 重磅真丝）+ 剪裁 + 颜色范围 + 配饰
- **光** — 主光方向 + 色温（冷 / 暖 / 中性）+ 背景虚化 + 是否电影质感

**反派的材质光影词典**：

- **肤色偏 desaturated** — 冷白偏灰、暖白偏蜡黄、小麦肤偏暗哑；不要"健
  康光泽"。可加"鼻翼两侧轻微出油，颧骨高光不均匀"。
- **下睑阴影 / 泪沟加深** — 强调"长期失眠/紧绷"，比正派更深一档。
- **服装色彩**：黑、墨绿、暗酒红、铁灰、烟褐；面料偏皮革、哑光羊毛、
  生丝；金属配饰偏暗银或哑光黄铜，不要亮金。
- **光线**：底光 (underlight) 或硬侧光制造眼窝阴影；色温偏冷或偏暖到
  发病感（钠灯黄、雾霾绿）；背景压暗到几乎只剩剪影。
- **细节**：领口或袖口稍乱／衬衫第一颗扣子歪 1 度／戒指戴在不寻常的
  手指上。这些"轻微违和"比直接的污渍更阴。

### Pillar 6 · 画质修饰 (Quality refinement)

**单一句**：`Rendering style: {{visualStyle}}` —— 把全局美术风格这段
文字原样写进 prompt 即可。

**禁止**叠加额外的相机 / 镜头 / 引擎 / 分辨率术语（Sony Venice /
Panavision / Final Fantasy CG / Unreal Engine 5 / 8K / Kodak Vision3
等）。这些会把每张图都拽向「写实摄影」基线，覆盖用户在导演助手里
选定的风格（例如「都市灵异动漫」、「水墨」、「赛博朋克」）。如果
项目就是写实摄影风，那它已经写进全局 visualStyle 里了，不用再叠。

### Pillar 7 · 防 AI 提示词 (Anti-AI tropes — negative directives)

**根据角色具体处境写 2-4 条针对性负面提示**，而不是整段复制下面这
张参考清单。例如：
- 反派 → 选 1-2 条："不做漫画式邪笑"、"不做美型反派模板（银发苍白
  瞳孔小恶魔）"
- 童星 → 选 1-2 条："不做夸张大眼无神"、"不做欧美高挺鼻型"
- 写实老者 → 选 1-2 条："不做过度磨皮"、"不做油亮水光肌"

参考清单（**不要整段贴**，只挑与本角色相关的）：

- 不做网红脸 / 整容脸 / 千篇一律 AI 美人脸
- 不做过度磨皮 / 油亮水光肌 / 滤镜感
- 不做夸张大眼无神 / 三庭五眼模板套用
- 不做欧美高挺鼻型（除非角色就是欧美）
- 不做韩漫嘟唇 / 甜妹卧蚕
- 不做二次元 / 卡通 / 插画感（除非全局风格本来就是动漫，那时反过来禁
  止真人写实）
- 不做夸张愤怒/夸张大笑表情（除非这一刻就该是；多数肖像保持克制）
- **反派专属候选**:
  - 不做漫画式邪笑 / 狞笑 / 狰狞 / 面目可憎
  - 不做"美型反派标准模板"（千篇一律的银发苍白瞳孔小恶魔）
  - 不做眼睛发红 / 瞳孔变形 / 獠牙 / 角等超自然特征（除非剧本就是奇幻）
  - 不做"善良反派"——可以隐忍可以儒雅，但视觉上必须保留一处让观众
    本能戒备的细节（颧骨过窄、嘴角下垂、不对称、阴影位置违和）

## designCharacters — output contract

For each input character, return a JSON object with:

```json
{
  "name": "林清",
  "biography": "200-400 字 narrative. 角色的前史 — 关键的两三件事，
    塑造了现在的 surface/depth/shadow。不要复述 dramatic_function，
    要写出能让演员理解动机的具体往事。",
  "appearance_pillars": {
    "subject": "...",
    "bone_structure": "...",
    "features": "...",
    "expression": "...",
    "texture_light": "...",
    "quality": "...",
    "anti_ai": "..."
  },
  "appearance_prompt": "把 7 个 pillars 顺序拼成一段连贯的中文 prompt，
    直接喂给图像模型。pillar 之间用句号/换行分隔，最后一行必须是
    Pillar 7 的负面指令清单。"
}
```

The `appearance_prompt` is what art-director hands to the image
generator. The pillars are kept structured so the user can edit any one
of them on the canvas without rebuilding the whole prompt.

## castVoices + attachVoiceRefs

See prompts/cast-voices.md and prompts/attach-voice-refs.md.

## Hard constraints (all verbs)

- Preserve director decisions in storyboard rows (shot_size,
  lighting_atmosphere, emotion_atmosphere, storyboard_prompts,
  motion_prompts). These belong to director-agent.
- Voice fidelity: dialogue uses each character's voice_print, never a
  generic "movie line".
- No exposition dumps in dialogue.
- For designCharacters: never copy archetype prose verbatim from
  万象骨相库; compose freshly using the 7 pillars so side characters,
  group shots, or non-portrait framings still get coherent descriptions.
- For appearance_prompt: always end on Pillar 7's negative-prompt
  directives — that's what stops the image model defaulting to
  网红脸/磨皮.