AutoEcom — 每日产品轮播管道
管道工具位于 ~/Documents/skill-autoecom/。每天，该技能从商店的畅销品列表中选取一个产品，生成一个 3-8 张幻灯片的样式轮播，向用户展示并获得批准，然后通过 Upload-Post 将其发布到 Instagram 和 TikTok 上。
架构：基于代理的，脚本作为胶水
该技能故意分离责任：您（代理）负责创意和身份工作：识别标志，选择品牌颜色，推断品牌声音，选择要展示的畅销产品，规划幻灯片结构，在图像上写文本，写帖子字幕。您使用 WebFetch、Read（图像多模态视觉）和 Write 直接进行操作。您不会将这些任务委托给一个封闭的 Python 脚本 —— 这就是整个过程的重点。正则表达式可能会将特征品牌标志误认为是商店标志；您不会犯这种错误。
Python 脚本（autoecom.py）仅处理您无法自己完成的机械部分：下载 URL、从图像中提取十六进制调色板、解析 JSON-LD、调用 nano-banana API、运行 Pillow 组合、将多部分轮播发布到 Upload-Post、持久化状态。
每一步都使这种分离变得明显。当您看到“您执行 X”时 —— 直接写入或决定。当您看到 python autoecom.py … 命令时 —— 运行它。
设置（仅当尚未配置时）
cd ~/Documents/skill-autoecom && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt
位于 ~/Documents/skill-autoecom/.env。所需键：
STORE_URL=https://www.your-shop.com
GEMINI_API_KEY=...
UPLOAD_POST_API_KEY=...
UPLOAD_POST_PROFILE=...
TIMEZONE=Europe/Madrid
如果缺少所需键，则在继续之前询问用户。
在 https://upload-post.com 注册 → https://app.upload-post.com 的仪表板。通过 OAuth 在仪表板中连接 Instagram（商业/创作者账户链接到 Facebook 页面）和 TikTok。在“管理用户”中创建一个配置文件 —— 其名称是 UPLOAD_POST_PROFILE（不是社交媒体句柄）。在“设置”中生成 API 密钥。
验证：curl -H "Authorization: Apikey $UPLOAD_POST_API_KEY" https://api.upload-post.com/api/uploadposts/me。
编排模型
该技能每天由代理工具（Hermes / openclaw / Claude Code）调用，该工具还处理消息桥（Telegram、WhatsApp 或用户配置的任何渠道）。该技能本身不直接与 Telegram 或任何消息应用程序交互 —— 它只运行管道并以文本 + 绝对文件路径的形式呈现轮播。代理工具将幻灯片转发到用户的手机，捕获用户的回复，并将其反馈到对话中。
如果该技能在没有代理工具的情况下调用（例如，用户在 Claude Code 中直接运行 /autoecom），则相同的提示仍然有效 —— 它们只会出现在终端中，而不是在手机上。
两个计划例行程序（必要 —— 在第一次运行时安装）
该技能不设计为按需运行。它仅在代理工具具有两个 cron 风格例行程序安装时按预期工作。
在第一次调用之前，代理工具必须验证两个例行程序是否存在，并提供创建缺失的例行程序的选项。
例行程序名称 Cron 表达式 作用
/autoecom 每天 09:00 本地时间 0 9
运行步骤 0-9：选择下一个产品 → 计划 → 生成 → 组合 → 通过配置的消息应用程序向用户展示轮播以获得批准 → 发布 → 标记为已处理。
/autoecom-learn 每周一 09:00 本地时间 0 9 1 运行 python autoecom.py learn，然后在同一个消息应用程序渠道中发布摘要，包括 Gemini 提取的模式、样本大小和审计文件链接。
如何安装（选择与代理工具匹配的路径）
Hermes：要求 Hermes 安排一个重复的例行程序 —— “每天 09:00 安排 /autoecom，并在每周一 09:00 安排 /autoecom-learn，两者都向我的 Telegram 报告”（或 WhatsApp / 任何配置的渠道）。Hermes 将编写例行程序本身。
openclaw：相同的模式 —— openclaw 具有内置的调度器。使用其调度 / 例行程序机制。
Claude Code（仅本地）：通过系统 crontab 安装。示例：
0 9 cd ~/Documents/skill-autoecom && ./venv/bin/python -c "import os; os.system('claude /autoecom')"
0 9
1 cd ~/Documents/skill-autoecom && ./venv/bin/python autoecom.py learn
（对于没有消息应用程序桥的 Claude Code，日常运行将在终端中显示轮播 —— 这意味着用户必须在其机器上。建议使用 Hermes / openclaw 进行无人值守操作。）
在第一次调用之前，执行以下操作：
检测代理工具（Hermes 与 openclaw 与 Claude Code）通过查看环境 / 可用工具。
询问用户一次： “¿Quieres que programe las dos rutinas (carrusel diario 09:00 + aprendizaje semanal lunes 09:00) en , enviando los carruseles a tu ? Necesitarás dar el ok cada día desde tu móvil.”
如果是 —— 安装两个例行程序。
by