--- name: siluzan-tso description: Operates Siluzan TSO ad accounts via siluzan-tso-cli Google/Bing/Yandex/TikTok/Kwai/Meta account management, Google Ads CRUD and PMax, analytics, optimization reports, forewarning, leads, invoicing, and RAG knowledge lookup. Use when the user mentions ad accounts, balance, spend, campaigns, keywords, open account, MCC/BC binding, or TSO reporting. On each new user task or topic switch, re-read routed references per references/core/agent-conventions.md — do not reuse prior task memory. license: MIT compatibility: Requires Node.js 18+, siluzan-tso-cli installed, authenticated via send-login-code + login or config set metadata: requires: nodejs,siluzan-tso-cli allowed-tools: Bash(siluzan-tso:*) Read Write --- # Siluzan TSO Skill 本 Skill 只保留**任务边界、文档路由与执行入口**。业务细节、参数、Playbook 步骤均以 `references/` 域目录为准。域索引见 `AGENTS.md`。 > **Agent 纪律（每个新任务必读）**：Read `references/core/agent-conventions.md`，再按 `SKILL.md` 任务表 Read 域文档。禁止跨话题复用参数记忆；数据类任务一律 `--json-out` + 脚本读盘（见 `references/core/tips.md`）。 --- ## 一键安装 - **macOS / Linux / WSL：** ```bash bash <(curl -fsSL https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.sh) ``` - **Windows PowerShell：** ```powershell irm https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.ps1 | iex ``` Windows：部分 Agent 通过 PowerShell 代执行时可能失败，改在 [Git Bash](https://git-scm.com/download/win) 运行 Bash 版安装命令。 登录与配置见 `references/core/setup.md`。**401 换凭据时优先「手机号 + 验证码」**：`send-login-code` → `login --phone --code`。 --- ## 可执行的操作范围 | 级别 | 示例 | | ---- | ---- | | **只读** | 账户列表、余额、消耗、报告、预警记录、Google Ads 查询 | | **写入**（需用户确认） | 创建/修改广告、开户申请、预警规则、报告推送 | | **破坏性**（确认 + `--commit`） | 账户解绑/关闭、MCC/BC 解绑、删除预警/报告/广告、发票申请 | --- ## 域路由（lazy-load） | 域 | 入口 | 典型任务 | | ---- | ---- | -------- | | `references/core/` | `agent-conventions.md` | 纪律、tips、playbooks、workflows | | `references/accounts/` | `accounts.md` | 列表、余额、MCC/BC、开户、发票 | | `references/google-ads/` | `google-ads.md` | CRUD、PMax、campaign-plan；`rules/` 优化 SOP | | `references/analytics/` | `account-analytics.md` | google-analysis、批处理、拓词、RAG | | `references/operations/` | `forewarning.md` | 预警、线索、optimize、宿主编排 | 完整文件列表：`references/README.md` · Agent 目录：`AGENTS.md` --- ## 任务 → 必读 references | 用户意图（关键词） | 必读（Read 后再 `-h` / 执行） | | ------------------ | ----------------------------- | | 任意任务（首次） | `core/agent-conventions.md` | | 账户列表 / 余额 / 消耗 / 分享 / MCC / 多账户汇总 | `accounts/accounts.md`；金额加 `accounts/currency.md` | | 拉数 / 报告 / 周报 / `google-analysis` | `analytics/account-analytics.md` + `core/tips.md`；多账户加 `analytics/google-analysis-batch.md` | | Google 新建搜索系列 | `google-ads/google-ads-campaign-plan.md` | | Google 广告 CRUD / 拒审 | `google-ads/google-ads.md` | | PMax | `assets/pmax-create-template.md` + `google-ads/pmax-api.md` | | 拓词 / keyword | `analytics/keyword-planner-workflows.md`；背景先 `analytics/rag.md` | | 优化报告（TSO 平台） | `analytics/reporting.md` | | 预警 | `operations/forewarning.md` | | 发票 / 转账 / 充值 | `accounts/finance.md` | | 开户 | `accounts/open-account-by-media.md`（Google 加 `accounts/open-account-google-ui.md`） | | OKKI 周报 | `report-templates/okki-weekly-google-client.md` + `core/playbooks.md` P6 | | Google 询盘分析 | `report-templates/google-inquiry-analysis.md` + `core/playbooks.md` P7 | | 标准画像/扫描/周期报告 | `core/playbooks.md` 对应 P1–P5 | > 表未覆盖时：查 `references/README.md` → Read 对应 reference → 再执行 CLI。 --- ## Playbook 速查 P1–P7 见 `references/core/playbooks.md`。 --- ## 职责划分 | 由 **本 Skill + CLI** 保证 | 由 **宿主客户端 / 外部调度** 负责 | | -------------------------- | --------------------------------- | | 结构化字段拉取（`--json-out`） | 何时触发检查（cron、对话） | | 写命令语义与读命令复核文档 | IF 条件计算与决策 | | 金额、ID、字段口径一致 | 触达（钉钉/飞书）与工单 | | references 与命令对齐 | 批处理循环、限速、重试 | 详见 `operations/hosted-automation-self-control.md`、`operations/hosted-automation-monitoring-json.md`、`operations/hosted-automation-optimize-index.md`。 --- ## 维护者 - `references/core/skill-authoring.md` — 规范与检查清单 - `docs/skill-guide.md` — 人类导读