团队成员首次配置
当有人刚刚安装了技能包但不知道下一步该做什么时,这项技能会手把手地引导他,直到他能正常开始工作。全程使用清晰易懂的西班牙语(无行话),并实际验证每一个步骤,而不是简单地说“应该可以了”。
最高准则
未通过命令验证上一步之前,不得进入下一步。 如果有一步失败,就停下来先解决它。安装这些工具的人不一定熟悉终端:如果要让他执行某操作,必须提供完整的命令(可直接粘贴),并告诉他会看到什么输出。
第0步 — 检查已安装项目
python3 instalar.py --revisar
如果找不到该文件,说明尚未克隆仓库:指导他重新克隆。输出的内容会告诉他还缺什么。按从上到下的顺序依次解决。
第1步 — 工具检查
| 缺失项 | 说明 |
|---|---|
| Python 3 | Mac 自带。如果真出问题:brew install python |
| rclone | brew install rclone — 用于连接 Google Drive |
| openpyxl | pip3 install openpyxl — 仅在他需要处理报告表格时才安装 |
| ffmpeg | brew install ffmpeg — 仅在他需要编辑视频时安装(此时还需安装 editar-vsl-cliente/INSTALACION.md 中的全部内容)。否则跳过 |
如果他没有安装 Homebrew:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
第2步 — 连接团队 Google Drive
这是最容易失败也最重要的步骤:没有 Drive 就没有简报、没有品牌指南、也没有存放文件的地方。
rclone config
逐一告诉他需要输入的内容:
n(新建远程配置)- 名称:
gdrive← 必须全小写。技能会按此名称查找。 - 类型:输入
drive client_id和client_secret:直接按 Enter(留空)- 权限范围:
1(完全访问) root_folder_id:直接按 Enter- 服务账号:直接按 Enter
- 高级配置:
n - 使用浏览器:
y→ 会打开 Chrome → 使用 Dirección 提供的 Flowboost 团队账号登录并授权 - Shared drive:
n· 确认:y· 退出:q
必须实际验证(仅提示完成不算):
rclone lsd gdrive: | head -5
应该输出一组客户文件夹列表(以 i_…、c_… 开头)。如果为空或报错,则说明未成功连接:重复第2步。
第3步 — 创建工作目录
mkdir -p ~/Desktop/CLIENTES && echo OK
所有下载或为客户创建的文件都放在 ~/Desktop/CLIENTES/<客户名>/ 下。严禁散落在“下载”文件夹中。
第4步 — 仅部分职能所需的配置
先问他具体负责什么工作,然后只安装相关部分。不要要求他安装不会用到的工具。
| 负责领域 | 需要 | 提供方 |
|---|---|---|
| 广告投放或报告 | Meta Ads 阅读权限 | 由 Dirección 将其添加到 Business Manager |
| 报告 | 无需额外操作:表格文件已在 Drive 中 | — |
| 静态素材 | 团队 ChatGPT 账号 | 由 Dirección 提供。⚠️ 切勿使用 <correo-direccion> 账号 |
| 视频 | 除 ffmpeg 外还需大量工具:Python 库、转录模型、QC 工具、MoneyPrinterTurbo(需要他自己的 Pexels API 密钥)以及约 8GB 磁盘空间。严格按照 editar-vsl-cliente/INSTALACION.md 逐步安装,并通过 python3 ~/.claude/skills/editar-vsl-cliente/scripts/comprobar_entorno_edicion.py 验证。 | 他自己安装(Pexels 密钥由他本人输入,绝不在聊天中透露) |
| Landing Page | 客户主机访问权限 | 发布时由 Dirección 提供 |
⚠️ 绝不在聊天中索要密码或 API 密钥,也绝不由 AI 输入这些信息。 如需密钥,指导他在本机输入并告知存储位置。
第5步 — 最终验证
只有以下命令成功执行,才算配置完成:
rclone lsd gdrive: | wc -l
如果输出大于0,则一切就绪。此时告诉他现在可以请求哪些功能,并给出其负责领域的示例:
- 报告:“帮我生成 <客户> 的报告”,“将 <客户> 添加到报告系统”
- 广告投放:“构建 <客户> 的广告系列”(广告系列会以暂停状态创建;激活始终由 Dirección 操作)
- 静态素材:“制作 <客户> 的静态素材”
- Landing Page:“为 <客户> 编写 Landing Page 文案”
从一开始就需要知道的事项
- 所有面向客户的内容均使用西班牙西班牙语。 不得使用 voseo。
- 不得编造信息:数字、客户评价、日期或保证内容必须真实。缺失内容标注
[FALTA]。 - 客户 Drive 为只读,除非是存放其交付物的专属文件夹。
- 激活广告系列始终由 Dirección 负责。 AI 代理只能创建暂停状态的广告系列。
- 如果缺少某项权限,必须告知并停下。 不得半途而废。
常见故障排查
| 现象 | 通常原因 |
|---|---|
| “找不到客户文件夹” | Drive 未正确连接 → 返回第2步 |
| “文件 xxx 不存在” | 缺少基础技能包 → 重新安装 |
| 文案毫无逻辑 | 同上:缺少基础技能包,且不会自动提示 |
| “command not found: rclone” | 第1步未完成 |