generate-avatar-segmentlisted
Install: claude install-skill huodebing-alt/Agentic-Headshot-Video-Studio
# Generate Avatar Segment / 生成单段 Avatar
## When to use / 何时使用
A-roll production per segment. HeyGen requires each segment 45–60s; this skill validates and submits.
A-roll 单段生产。HeyGen 单段须 45-60 秒,本 skill 校验并提交。
## Inputs / 输入
- `workspace/voice/seg_NNN.mp3`.
- `config/avatar.json` (`avatar_id`, `background`, `dimension`).
- `HEYGEN_API_KEY`.
## Output / 输出
- `workspace/aroll/seg_NNN.mp4`.
- `workspace/aroll/manifest.json` row.
## Steps / 步骤
1. Probe MP3 duration; assert 45 ≤ s ≤ 60, else abort with hint.
2. YOLO guard: check `config/yolo-spend.json`.
3. Call `mcp__heygen__video_generate` with audio + avatar config.
4. Poll `mcp__heygen__video_status` every 15s until ready or timeout 15 min.
5. Download MP4; update manifest.
## Examples / 示例
```
claude run generate-avatar-segment --id 003
```
## Failure recovery / 失败回退
- If duration outside 45–60s, route to segment-script-45s to re-split.
- If render fails, mark segment and let regenerate-failed-segment retry.