Matriz Viralidad — 启动
用途 这是 Matriz Viralidad 内容分析系统的启动环节（/matriz-start）。它负责把系统配置到可工作状态，并对使用者做一次五问访谈，逐项询问、不使用术语，用对方书写的语言回复（默认西班牙语）。
工作方式与路径 所有操作发生在使用者当前所在文件夹；脚本位于 RAIZ（根目录）。插件模式下 RAIZ 为插件根路径（${CLAUDE_PLUGIN_ROOT} 显示为绝对路径时）；若该占位符未被替换，则为克隆模式，RAIZ 即当前文件夹，可用 ls scripts/apify.mjs 确认。命令中的 <RAIZ> 需替换为该值。使用者数据始终保存在当前文件夹。若派发子代理（espia、analista-video、matricero、simulador、validador 等）时找不到，说明处于插件模式，需使用带前缀的名称，例如 matriz-viralidad:espia。
第一步：检查密钥与环境 运行 node "<RAIZ>/scripts/revisar.mjs" todo。不要读取 .env，也不要把密钥粘贴进命令（会被守卫拦截）；该脚本只报告「存在/缺失」，绝不显示值。
- APIFY_TOKEN 缺失或仍为占位符：停止流程，提示用户注册 https://apify.com/sign-up，在 Settings → API & Integrations 复制 Personal API token，在当前文件夹执行 cp .env.example .env，编辑并粘贴 token（Mac 可用 open -e .env，Windows 用记事本），粘贴在 APIFY_TOKEN= 之后、不加引号；完成后重新运行 /matriz-start。该文件为私有，不读取。若 .env 已存在但仍为占位符，提示替换示例文本。
- GEMINI_API_KEY 缺失：可继续，属可选项。缺少时视频分析依赖 watch 技能（若已安装）或读取画面烧录字幕；有该密钥则可听取音频，约 0.003–0.011 美元/视频。免费密钥：https://aistudio.google.com/apikey。
- 环境：node.ok 为假则要求 Node 20 或更新版本（https://nodejs.org）。缺少 ffmpeg 则逐帧分析不可用，Mac 可 brew install ffmpeg（需先征得同意，不得擅自安装）。skill_watch.instalada 为假时仅作信息告知，不视为问题（见 matriz-ver）。若文件夹内有 .git，用 git check-ignore .env 检查，未忽略则加入 .gitignore 并一行提示。
第二步：是否已有配置文件 若存在 perfil.json，读取后用 AskUserQuestion 询问：「已有针对“…”、… 的配置文件，接下来怎么做？」选项：沿用并进入菜单 · 更新（重新过一遍问题）· 其他配置文件（其他品牌或客户，保存到 perfiles/<nombre>.json，当前生效的始终是 perfil.json）。沿用跳至第六步，更新与其他配置文件进入第三步。
第三步：访谈（五个问题） 若用户首条消息已提供部分信息（如 @用户名、细分领域），不再重复询问。有选项的用 AskUserQuestion 聚合，自由文本在聊天中询问。
- 研究谁？（标题「谁」）我的账号（已在发布内容）· 参考创作者（刚起步，研究 2–3 个）· 两者。若用于客户，记录 nombre_cliente。
- 哪些平台？（多选）Instagram · TikTok · YouTube · X (Twitter)。
- 各平台精确 @用户名（不带 @，每个平台一个）。研究参考账号时索取 2–3 个公开账号；若无明确参考，帮助其思考谁做得最好（不得编造账号，询问其关注和欣赏的人）。
- 你讲什么或想讲什么？细分领域，一句话。示例：「面向久坐上班族的居家训练」。
- 语气与频率（两个问题）：语气 → 直接不修饰 · 亲切口语 · 教学式 · 挑衅式；每周条数 → 2 到 3 · 4 到 5 · 6 到 7 · 超过 7。 将各区间上限保存为 publicaciones_por_semana（2–3→3；4–5→5；6–7→7；超过 7→8）。若用户以文本给出不同答案，遵从原意，不得编造。
第四步：写入 perfil.json 平台以 apify.mjs 能识别的确切名称保存：instagram-reels（Instagram，常规）、instagram（仅当需要帖子与轮播）、tiktok、youtube、x。日期用 date +%F 生成，不凭记忆书写。字段结构：version、creado、actualizado、modo（propia | referencias | ambas）、nombre_cliente、nicho、tono、publicaciones_por_semana、cuentas_propias（数组，含 red 与 handle）、competencia（空）、medianas（空）、topes_de_gasto（corrida_inicial 与 rutina_semanal，各含 limite 与 tope_usd）。competencia 由 matriz-espiar 填充，medianas 由 matriz-analiticas 填充，此处保持为空，不填零也不填编造数字。
第五步：创建目录 mkdir -p fuentes videos transcripciones matriz guiones calendario perfiles .matriz，并逐行说明：fuentes/ 抓取器下载的原始内容（永不编辑）· videos/ 下载的视频 · transcripciones/ 每个视频的分析，一文件一个 · matriz/ 矩阵与报告 · guiones/ 带模拟的新脚本 · calendario/ 月度计划 · perfiles/ 其他配置文件。
第六步：命令菜单 最后输出带头部配置信息的菜单：/matriz-analiticas 用中位数衡量自己的账号表现 · /matriz-espiar 抓取其他公开账号内容并分析所选视频 · /matriz-ver 查看单个视频（按链接）的制作方式 · /matriz-construir 构建 10 列矩阵与模式文档 · /matriz-ganador 交叉使用与表现，找出有效且尚未饱和的内容 · /matriz-sentimiento 读取评论，了解受众想法、疑问与需求 · /matriz-guion 撰写 5 个新脚本并对矩阵模拟 · /matriz-calendario 编排当月日历，每天对应矩阵中的一条内容 · /matriz-rutina 每周例行：重新采集、更新、衡量成果、规划 · /matriz-doctor 出现问题时诊断。建议从 /matriz-analiticas 开始衡量自身，或从 /matriz-espiar 查看竞品。插件模式下命令带前缀，如 /matriz-viralidad:matriz-espiar。最后列出本次创建的文件及其路径。
适用场景与限制 适用于初次配置内容分析系统、切换或新增品牌/客户配置文件。依赖 Node 20+ 与 Apify token；ffmpeg 与 Gemini 密钥为可选。脚本与命令内容需原样保留，不得读取或输出密钥值；配置文件中的某些字段由后续技能填充，启动阶段不写入。