minis-analyse-skill

TikTok 小程序(Minis)短剧投放的三个 skill,Codex 和 Claude Code 通用。 经验每天更新,git pull 一下就是最新的。

skill	做什么
swads-minis-batch-launch	把本地素材批量建成 Minis 计划:上传、策源、配乐、推送、同步、开投、逐条核对
swads-minis-launch-watch	新户冷启动盯盘:每 10 分钟一轮,按判断点提示关广告 / 等 / 加预算 / 关户,关户后写小结
swads-delivery-watch	按广告盯一个在投户:15 分钟分段 ROAS、上一小时亏损、点击率、预算用量

经验在哪: skills/swads-minis-launch-watch/references/playbook.md(判断点手册)和 references/benchmarks.json(每个关掉的户的逐小时数据和一句教训)。每关一个户追加一条。

安装(一次)

git clone https://git.mincode.cn/jolie_hill_4zocb4/minis-analyse-skill.git ~/minis-analyse-skill
bash ~/minis-analyse-skill/install.sh

install.sh 把三个 skill 用软链接挂进 ~/.codex/skills/ 和 ~/.claude/skills/,所以以后只要在 ~/minis-analyse-skill 里 git pull,两边立刻都是新版本,不用重装。 那两个目录里原来就有同名的旧拷贝时,脚本会跳过并提示,删掉旧拷贝再跑一次。

配 swads 令牌(每人一个)

在管理台 /operations/mcp-tokens 领自己的令牌,令牌不要提交到任何仓库。令牌能看到哪些户,就只能盯哪些户。

Codex,写进 ~/.codex/config.toml:

[mcp_servers.swads]
url = "https://ads.mincode.cn/mcp"

[mcp_servers.swads.http_headers]
Authorization = "Bearer <你的令牌>"

Claude Code:

claude mcp add --transport http swads https://ads.mincode.cn/mcp --header "Authorization: Bearer <你的令牌>"

盯盘脚本会自己从上面两处之一读到网关地址和令牌,也认环境变量 SWADS_MCP_URL / SWADS_MCP_TOKEN。

每次开 Codex 自动拉最新经验(可选)

在 ~/.codex/hooks.json 的 hooks 里加一个 SessionStart(已有这个文件就合进去,别覆盖):

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "timeout 15 git -C ~/minis-analyse-skill pull --ff-only -q >/dev/null 2>&1; true",
            "timeout": 20
          }
        ]
      }
    ]
  }
}

第一次开 Codex 会问要不要信任这个钩子,点信任。拉不下来(没网、本地改过)就跳过,不影响使用。

用法

• Codex:对话里点名 skill,例如「用 swads-minis-launch-watch 盯 88776-1 这个户」。
• Claude Code:/swads-minis-launch-watch、/swads-minis-batch-launch、/swads-delivery-watch。

所有写平台的动作(开投、关广告、改预算、停计划)都会先问你,你点头才动。

更新经验

关户后把这个户追加进 benchmarks.json,判断点要改就改 playbook.md(scripts/watch.py 里的阈值要一起改), 然后提交推送。提交信息写清是哪个户、改了哪条。