sino-bc-cli 1.8.5 → 1.8.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/SKILL.md +26 -16
- package/dist/affordance/biz-line.md +24 -12
- package/dist/api-doc/custom/README.md +8 -8
- package/dist/api-doc/{system → oapi}/biz-line-strategy.md +49 -13
- package/dist/generated/api-catalog.json +89 -32
- package/dist/index.js +1 -1
- package/dist/skills/custom/sino-bc-biz-line/references/common-mistakes.md +8 -0
- package/dist/skills/custom/sino-bc-biz-line/references/enums.md +7 -0
- package/dist/skills/oapi/sino-bc-biz-line/SKILL.md +54 -0
- package/dist/skills/oapi/sino-bc-biz-line/references/long-tail-api.md +19 -0
- package/dist/skills/{system → oapi}/sino-bc-sso/SKILL.md +5 -14
- package/dist/skills/oapi/sino-bc-sso/references/long-tail-api.md +9 -0
- package/package.json +1 -1
- package/dist/skills/system/sino-bc-biz-line/SKILL.md +0 -65
- package/dist/skills/system/sino-bc-biz-line/references/long-tail-api.md +0 -17
- /package/dist/api-doc/{system → oapi}/biz-line-query.md +0 -0
- /package/dist/api-doc/{system → oapi}/sso.md +0 -0
- /package/dist/skills/{custom → default}/sino-bc-shared/SKILL.md +0 -0
- /package/dist/skills/{custom → default}/sino-bc-shared/references/config-and-env.md +0 -0
- /package/dist/skills/{custom → default}/sino-bc-shared/references/output-contract.md +0 -0
- /package/dist/skills/{custom → default}/sino-bc-shared/references/write-approval.md +0 -0
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sino-bc-sso
|
|
3
|
-
description: Use when 查询或操作 BeyondClick
|
|
3
|
+
description: Use when 查询或操作 BeyondClick SSO 组别,或用户提到 sso。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# sso
|
|
7
7
|
|
|
8
8
|
**开始前 MUST 先用 Read 工具读取 [`../sino-bc-shared/SKILL.md`](../sino-bc-shared/SKILL.md)**(配置、信封、确认门、禁止拼 HTTP)。
|
|
9
|
-
仓库里手写件在 `skills/
|
|
9
|
+
仓库里手写件在 `skills/default/sino-bc-shared/SKILL.md`。
|
|
10
10
|
|
|
11
11
|
## When to Use
|
|
12
12
|
|
|
@@ -18,12 +18,13 @@ description: Use when 查询或操作 BeyondClick sso 数据,或用户提到 s
|
|
|
18
18
|
## Agent 流程
|
|
19
19
|
|
|
20
20
|
1. **优先 Shortcut**:`sino-bc-cli sso +<shortcut>`。WHEN 见 `affordance/sso.md`。
|
|
21
|
-
2. **没有 Shortcut 再点名**:`sino-bc-cli sso api <name> --data '<json>'`。
|
|
21
|
+
2. **没有 Shortcut 再点名**:`sino-bc-cli sso api <name> --data '<json>'`。 长尾 name → [`references/long-tail-api.md`](references/long-tail-api.md)。
|
|
22
22
|
3. 写操作须确认环境和意图后再加 `--yes`,不要自行补 `--yes`。
|
|
23
23
|
|
|
24
|
+
|
|
24
25
|
```bash
|
|
25
26
|
sino-bc-cli sso +group-list
|
|
26
|
-
sino-bc-cli sso api sso-team-group-list --data '{}'
|
|
27
|
+
sino-bc-cli sso api sino-opti-hive-sso-team-group-list --data '{}'
|
|
27
28
|
```
|
|
28
29
|
|
|
29
30
|
## 意图 → Shortcut
|
|
@@ -31,13 +32,3 @@ sino-bc-cli sso api sso-team-group-list --data '{}'
|
|
|
31
32
|
| 用户在问 | 命令 | 注意 |
|
|
32
33
|
| --- | --- | --- |
|
|
33
34
|
| 查询组别列表 | `sso +group-list` | |
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# 长尾接口(无手写 Shortcut)
|
|
2
|
+
|
|
3
|
+
用 `sino-bc-cli <domain> api <name> --data '<json>'`。`<name>` 取自 `src/api-doc/` 与该域技能 references,不要发明新 name。
|
|
4
|
+
|
|
5
|
+
| 用户在问 | name | 注意 |
|
|
6
|
+
| --- | --- | --- |
|
|
7
|
+
| 查询组别列表 | `sino-opti-hive-sso-team-group-list` | |
|
|
8
|
+
|
|
9
|
+
描述含 ⚠️ 的 name 同样走确认门。请求体按用户条件组装,禁止原样提交文档示例业务线 ID。
|
package/package.json
CHANGED
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sino-bc-biz-line
|
|
3
|
-
description: >
|
|
4
|
-
Use when 查询或操作 BeyondClick 业务线数据:投放渠道/品类、
|
|
5
|
-
业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯/客户满意度/ROAS;
|
|
6
|
-
Facebook / Google / TikTok 广告结构(账户、广告系列、广告组、广告、目标、出价、定向)
|
|
7
|
-
与广告成效(消耗、曝光、点击、购买、安装)。
|
|
8
|
-
用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、biz-line、
|
|
9
|
-
Meta、Facebook、Google、TikTok、sino-opti-hive 时也必须用本技能。
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# biz-line
|
|
13
|
-
|
|
14
|
-
**开始前 MUST 先用 Read 工具读取 [`../sino-bc-shared/SKILL.md`](../sino-bc-shared/SKILL.md)**(配置、信封、确认门、禁止拼 HTTP)。
|
|
15
|
-
仓库里手写件在 `skills/custom/sino-bc-shared/SKILL.md`。
|
|
16
|
-
|
|
17
|
-
## When to Use
|
|
18
|
-
|
|
19
|
-
- 查投放渠道、投放行业/品类、业务线主数据、周策略与表现
|
|
20
|
-
- 新建/编辑/删除业务线或周策略(须先确认环境和写操作意图)
|
|
21
|
-
- 查 Facebook / Google / TikTok 广告结构或广告成效
|
|
22
|
-
- 用户点名 `biz-line`、sino-opti-hive
|
|
23
|
-
|
|
24
|
-
不要用本文件处理:配置(走 shared)、本仓库开发与发版。
|
|
25
|
-
|
|
26
|
-
## Agent 流程
|
|
27
|
-
|
|
28
|
-
1. **优先 Shortcut**:`sino-bc-cli biz-line +<shortcut>`。WHEN 见仓库 `affordance/biz-line.md` 或 `sino-bc-cli biz-line --help`。
|
|
29
|
-
2. **没有 Shortcut 再点名**:`sino-bc-cli biz-line api <name> --data '<json>'`。长尾 name → [`references/long-tail-api.md`](references/long-tail-api.md)。
|
|
30
|
-
3. 组参前不确定字段口径就读本地文档。全局安装:`$(npm root -g)/sino-bc-cli/dist/api-doc/system/`;本仓库:`src/api-doc/system/`。何时用哪条命令:`sino-bc-cli biz-line --help`。
|
|
31
|
-
4. `--name` 命中 0 条或多条都失败,按 hint 收窄或改用 `--id`,不要擅自选第一条。
|
|
32
|
-
5. 回复用业务语言摘要;文档路径写成 Markdown 链接。
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
sino-bc-cli biz-line +list --name 用户给出的业务线名
|
|
36
|
-
sino-bc-cli biz-line api biz-line-strategy-compare \
|
|
37
|
-
--data '{"bizLineId":123,"currentId":2,"prevId":1}'
|
|
38
|
-
sino-bc-cli biz-line +status --id 123 --status 3 --dry-run
|
|
39
|
-
sino-bc-cli biz-line +status --id 123 --status 3 --yes
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
CLI 未安装:`npm i sino-bc-cli@latest -g`(需 Node.js >= 24)。技能未出现:`sino-bc-cli /init`。
|
|
43
|
-
|
|
44
|
-
## 意图 → Shortcut
|
|
45
|
-
|
|
46
|
-
| 用户在问 | 命令 | 注意 |
|
|
47
|
-
| --- | --- | --- |
|
|
48
|
-
| 有哪些投放渠道 | `biz-line +channels` | `code` = 业务线里的 `mediaChannelId` |
|
|
49
|
-
| 投放行业 / 品类树 | `biz-line +categories` | 一级行业(1=APP / 2=ECBR / 3=游戏),二级=品类 |
|
|
50
|
-
| 业务线有哪些 / 按名或品类筛 | `biz-line +list --name / --id / --category` | 不传条件 = 全部(`pagination: false`) |
|
|
51
|
-
| 某条业务线的周策略和表现 | `biz-line +strategies --name` 或 `--id` | `--name` 命中 0 条或多条都会失败;`--id` 只接受单个 |
|
|
52
|
-
| 新建 / 编辑业务线 | `+save --data` / `+update --data` | ⚠️ 需 `--yes` |
|
|
53
|
-
| 切换业务线状态 | `+status --id --status` | ⚠️;枚举见 [`references/enums.md`](references/enums.md) |
|
|
54
|
-
| 删除业务线 | `+delete --id` | ⚠️ |
|
|
55
|
-
| 新建 / 编辑 / 删除策略 | `+strategy-save` / `+strategy-update` / `+strategy-delete` | ⚠️;编辑带 `version` 乐观锁 |
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
## Common Mistakes
|
|
59
|
-
|
|
60
|
-
| 错误 | 正确做法 |
|
|
61
|
-
| --- | --- |
|
|
62
|
-
| 自己用 curl 拼网关请求 | 走 `biz-line +<shortcut>`,没有就用 `biz-line api <name>` |
|
|
63
|
-
| 执行已下线的 `/bc-api` | 这条只会打印迁移提示并非 0 退出 |
|
|
64
|
-
| `--name` 命中多条时随便选一条 | 按 hint 里的候选让用户确认,或改用 `--id` |
|
|
65
|
-
| 把 `exprot-all` 改成 `export-all` | 按服务端拼写调用 |
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
# 长尾接口(无手写 Shortcut)
|
|
2
|
-
|
|
3
|
-
用 `sino-bc-cli <domain> api <name> --data '<json>'`。`<name>` 取自 `src/api-doc/` 与该域技能 references,不要发明新 name。
|
|
4
|
-
|
|
5
|
-
| 用户在问 | name | 注意 |
|
|
6
|
-
| --- | --- | --- |
|
|
7
|
-
| 业务线详情 | `sino-opti-hive-biz-line-detail` | `{ "id": <bizLineId> }` |
|
|
8
|
-
| 策略周期列表 | `sino-opti-hive-biz-line-strategy-period-list` | |
|
|
9
|
-
| 策略周期内关联项目周表消耗汇总 | `sino-opti-hive-biz-line-strategy-spend` | |
|
|
10
|
-
| Facebook广告策略维度数据 | `icenter-mcp-strategy-dimension-facebook-ad-list` | |
|
|
11
|
-
| Google广告策略维度数据 | `icenter-mcp-strategy-dimension-google-ad-list` | |
|
|
12
|
-
| TikTok广告策略维度数据 | `icenter-mcp-strategy-dimension-tiktok-ad-list` | |
|
|
13
|
-
| Facebook广告策略成效数据 | `icenter-mcp-strategy-metrics-facebook-ad-list` | |
|
|
14
|
-
| Google广告策略成效数据 | `icenter-mcp-strategy-metrics-google-ad-list` | |
|
|
15
|
-
| TikTok广告策略成效数据 | `icenter-mcp-strategy-metrics-tiktok-ad-list` | |
|
|
16
|
-
|
|
17
|
-
描述含 ⚠️ 的 name 同样走确认门。请求体按用户条件组装,禁止原样提交文档示例业务线 ID。
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|