---
name: sino-bc-cli
description: >
  Use when 查询或操作 BeyondClick 业务线、周策略生成、广告结构、广告成效，或配置 sino-bc-cli：
  投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯/客户满意度/ROAS；
  Facebook / Google / TikTok 广告结构（账户、广告系列、广告组、广告、目标、出价、定向）
  与广告成效（消耗、曝光、点击、购买、安装）；
  SSO 组别；以及 /init、/get-config、/set-config。
  用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、biz-line、
  Meta、Facebook、Google、TikTok、sso、sino-opti-hive 时也必须用本技能，不要自己拼 HTTP。
  完整规则在子技能 sino-bc-shared 与 sino-bc-<domain>。
metadata:
  requires:
    bins: ["sino-bc-cli"]
---

# sino-bc-cli

用全局 CLI `sino-bc-cli` 查询或操作 BeyondClick。本文件是**唯一对外技能**，也是决策页：按用户意图只读一份子技能，再执行命令。不要自己拼网关 HTTP，也不要一次读完全部子技能。

`/init` 之后本机目录是 `~/.agents/skills/sino-bc-cli/`，子技能嵌在其下（没有 `system/` / `custom/` 这一层）：

```text
sino-bc-cli/
├── SKILL.md                 ← 本文件
├── sino-bc-shared/          横切：配置、信封、确认门
├── sino-bc-biz-line/        业务线、周策略、广告结构、广告成效
└── sino-bc-sso/             SSO 组别
```

## 怎么跑

1. 用 Read 打开 [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)：禁止拼 HTTP、成功看 `ok` / 退出码、写操作退出码 10、配置。
2. 按下表再读**一份**域技能。Shortcut、组参、枚举、长尾 `api <name>` 都在那份里。
3. 有 Shortcut 用 `sino-bc-cli <domain> +<shortcut>`；没有再用 `sino-bc-cli <domain> api <name> --data '<json>'`。
4. 写操作先停下确认环境和意图，用户同意后再加 `--yes`。**不要自行补 `--yes`。**

不确定哪条命令：`sino-bc-cli biz-line --help` 或 `sino-bc-cli sso --help`。

CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出现或升级 CLI 后：`sino-bc-cli /init`。

## 意图 → 子技能

| 用户在问 | 读 | 命令入口 |
| --- | --- | --- |
| 环境、API_KEY、成功/失败怎么看、写操作要不要确认 | [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md) | `/init` `/get-config` `/set-config` |
| 投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、红绿灯/消耗/ROAS | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
| Facebook / Google / TikTok 广告结构（账户、系列、组、广告、目标、出价、定向）或广告成效（消耗、曝光、点击、购买、安装） | 同上 | `biz-line +<shortcut>`（维度 / 成效） |
| SSO 组别 | [`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md) | `sso +group-list` |

不要用本技能处理：本仓库源码开发、扩展命令、npm 发版（见仓库 `README.md` / `ReleaseSteps.md`）。

## 子技能索引

Agent 先读子技能 `sino-bc-shared`，再按意图读域技能。

1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/custom/sino-bc-shared/SKILL.md`](skills/custom/sino-bc-shared/SKILL.md)）
2. 业务线、周策略生成、广告结构、广告成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/system/sino-bc-biz-line/SKILL.md`](skills/system/sino-bc-biz-line/SKILL.md)）
3. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/system/sino-bc-sso/SKILL.md`](skills/system/sino-bc-sso/SKILL.md)）

安装与刷新（会写入上面列出的子技能到本机 `sino-bc-cli/`，并删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录）：

```bash
sino-bc-cli /init
sino-bc-cli /skill
```

列出包内技能：`sino-bc-cli /skill`（只有这一条）。查看某条命令何时用：`sino-bc-cli biz-line --help`。
升级 CLI 后请再跑一次 `/init`。

> 仓库里子技能分两层：`skills/system/sino-bc-<domain>/` 由 `npm run sync-api-doc` 生成；`skills/custom/sino-bc-shared/` 与 `skills/custom/sino-bc-<domain>/references/` 手写且不会被同步覆盖。每个子技能都是标准目录：`SKILL.md` + `references/`。
> `/init` 把根 `SKILL.md` 与两层子技能嵌进 `~/.agents/skills/sino-bc-cli/`。
> 上面的索引由同步脚本维护，改它请改 `src/api-utils/render-skills.ts`。