菜单
在任意空目录中从零创建数字人智能体应用。自动识别场景（业务流/纯对话/能力展示），从内置模板复制项目文件，引导用户改配置、本地调通。Use when 用户说"新建数字人应用""开发智能体""做 XX 场景的 Demo""搭一个数字人""创建一个数字人项目"。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
接到"加 Biz 类型 / 加新消息类型 / 加新消息样式 / 发某某卡片 / 想发个表单让用户填 / 消息发出去对端没收到"等需求时触发。引导决策：基础类型 vs 已有 BIZ vs 新增 BIZ；新增 BIZ 必须走后端专属接口 + 前后端共同约定 4 步流程；前端职责仅"调发送接口 + 写展示卡片"。
合并 master 前检查 swagger-repo.json 是否残留 feat 分支，半自动逐条切回并重跑 gen:api。**触发场景**：准备合并到 master 之前（由 git-ship skill 自动调用）/ 修改过 swagger-repo.json 的 branch 字段 / 拉到陌生分支后想确认 API 类型来源 / 用户输入 /check-api-branch。
多模型并行 Code Review。**自动触发场景**：用户拍板 plan 后改完代码（中等 / 复杂任务），AI 主动询问「需要 code review 吗？」**手动触发**：用户输入 `/code-review` 或说「review 一下这次改动 / 帮我看看这次提交」。按改动复杂度分级派 SubAgent，**轻量改动只派 1 个 sonnet 兜底，复杂任务才派 3 个含 opus 架构师**——不浪费最强模型在简单任务上。
公司前端通用编码规范（从 11 个项目 + 飞书知识库抽取）。当用户开始编写/修改前端 TS/TSX/Vue/SCSS 代码，或者需要 code review / 检查规范一致性时，**必须**加载本 skill 作为硬性规则基础。
启动开发环境 + 调试。触发场景："看一下效果 / 跑起来看看 / 启动一下 / 打开看看 / 启动 dev / 跑 dev"。本 skill 读 profile.devServer 配置 → 校验前置 → 后台 spawn dev server → 等 ready → 拼带 token 的真实域名 URL → open 浏览器。同时含项目特定的"关键调试场景"片段（按 profile 加载）。
检查本地开发环境（node / pnpm / lark-cli / figma-to-code / Figma MCP / npm registry / glab / 代理 等 15 项）是否就绪。新会话开始时由主 Agent 调用一次；只检测 + 给安装命令，不自动跑。如有 ERR 级缺失 -> 告知用户并停止后续动作；只有 WARN/INFO -> 简短提示后继续。glab 缺失 → 用 `glab-setup` skill 引导。
| name | avatar-agent-builder |
| description | 在任意空目录中从零创建数字人智能体应用。自动识别场景（业务流/纯对话/能力展示），从内置模板复制项目文件，引导用户改配置、本地调通。Use when 用户说"新建数字人应用""开发智能体""做 XX 场景的 Demo""搭一个数字人""创建一个数字人项目"。 |
从零开发交互式数字人智能体。skill 自带三个完整模板，复制即用。
根据用户需求，自动匹配三种模式之一，从 templates/ 目录复制对应模板：
| 用户描述 | 匹配模式 | 模板 |
|---|---|---|
| "挂号" "办证" "理赔" "开户" "流程" "步骤" "引导" "表单" | 业务流 | templates/flow/ |
| "聊天" "客服" "对话" "问答" "助手" "陪聊" | 纯对话 | templates/chat/ |
| "展示 SDK" "教学" "教程" "看看有什么能力" "配置项" | 能力展示 | templates/sdk/ |
cp -r .claude/skills/avatar-agent-builder/templates/flow/* .
改 package.json name 字段
定义业务流程 — 改 src/config/state-machine.ts
{
layout: 'half_center' | 'pip',
widgetType: 'picker'|'input'|'text'|'confirm'|null,
subtitleText: '数字人说的话',
inputMode: 'llm'|'regex'|'passthrough'|'none',
nextState: 'next_step',
}
写 System Prompt — 改 src/config/llm-prompts.ts
调 Widget 配置 — picker 选项、input 校验规则
本地跑起来
cd my-project
pnpm install
pnpm dev
cp -r .claude/skills/avatar-agent-builder/templates/chat/* .
# 改 src/config/personas.ts 人设 → pnpm install → pnpm dev
cp -r .claude/skills/avatar-agent-builder/templates/sdk/* .
# 直接可用 → pnpm install → pnpm dev
onWidgetEvent + CSS 隐藏 SDK 内置字幕interrupt → offlineMode → destroy| 现象 | 原因 | 检查 |
|---|---|---|
| 白屏 | SDK CDN 没加载 | index.html 是否有 <script src="xmovAvatar@latest.js"> |
| 初始化失败 | APP ID/SECRET 不对 | 控制台 lastInitError |
| 数字人不说话 | SSML 没包 <speak> | sdk.speak(\${text}`, true, true)` |
| ASR 无声 | 非 HTTPS/localhost | 本地 localhost 调试 |
| LLM 不回复 | 模型名错了 | 用 qwen-flash 而非 qwen3.6-flash |