用途：matriz-doctor 是 Matriz Viralidad 系列技能中的环境诊断命令，用于确认当前环境可以正常使用该系列技能，还是存在缺失项。它本身不执行内容抓取或分析，只做只读检查并汇报。
主要能力：一是定位脚本根目录，区分插件模式（根目录为插件绝对路径）与克隆模式（根目录为当前文件夹），并提示子代理在插件模式下需加前缀调用。二是执行三条只读命令：scripts/revisar.mjs todo、scripts/revisar.mjs gasto，以及 ls -a。三是按项汇报状态，包括 Node ≥ 20、APIFY_TOKEN 是否存在、.env 是否在当前目录、GEMINI_API_KEY 是否配置、ffmpeg/ffprobe 版本、yt-dlp 版本、watch 技能是否安装、perfil.json 是否存在、当月实际花费 gasto_usd_real。所有检查均不显示密钥的具体值。四是检查 perfil.json、fuentes/、transcripciones/、matriz/ 等文件与目录是否存在。
使用方式：在 Claude Code 中执行 /matriz-doctor（插件模式下命令带 /matriz-viralidad: 前缀）。命令会用 ✓/!/✗ 单行信号灯列出每个检测项，不粘贴原始 JSON；失败项会给出具体修复说明，例如从 nodejs.org 安装 Node LTS、把 .env.example 复制为 .env 并填入 Apify Token、在 macOS 上通过 brew 安装 ffmpeg 和 yt-dlp、通过插件市场添加 claude-video、运行 /matriz-start 生成资料等。最后给出用户接下来应执行的第一步，或全部通过时说明应继续使用哪个技能。
适用场景：首次配置 Matriz Viralidad 后验证环境；运行抓取、视频分析等命令报错时排查原因；确认密钥与外部工具是否齐备；查看当月花费。文档还列出常见错误及原因，如视频链接过期导致 403/404、Apify 拒绝 token、handle 写错或账号私密导致搜不到公开内容、插件模式与克隆模式下命令写法不同、使用 Apify MCP 时输出被截断需设置 MAX_MCP_OUTPUT_TOKENS。
限制：仅做只读检查，不修改环境；不读取或展示 .env 中的密钥值；Gemini API Key 与 watch 技能为可选项，缺失时相关功能不可用；费用项仅为信息展示，若存在未返回成本的运行会标注为 s/d。