القائمة
在任意空目录中从零创建数字人智能体应用。自动识别场景（业务流/纯对话/能力展示），从内置模板复制项目文件，引导用户改配置、本地调通。Use when 用户说"新建数字人应用""开发智能体""做 XX 场景的 Demo""搭一个数字人""创建一个数字人项目"。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
接到"加 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 |