Files
minis-analyse-skill/README.md
T
blueming3andClaude Opus 5.5 9f9e70ea2d feat: minis launch, cold-start watch and delivery watch skills
Three TikTok Minis skills for Codex and Claude Code, with the cold-start
playbook and five benchmark accounts through 88776-1 (2026-09-30).
install.sh links them into ~/.codex/skills and ~/.claude/skills.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-30 15:10:54 +08:00

83 lines
3.0 KiB
Markdown

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