# 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`(每个关掉的户的逐小时数据和一句教训)。每关一个户追加一条。

## 安装(一次)

```bash
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`:

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

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

Claude Code:

```bash
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`(已有这个文件就合进去,别覆盖):

```json
{
  "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` 里的阈值要一起改),
然后提交推送。提交信息写清是哪个户、改了哪条。