sino-bc-cli 1.8.18 → 1.8.19

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/dist/SKILL.md CHANGED
@@ -2,7 +2,8 @@
2
2
  name: sino-bc-cli
3
3
  description: >
4
4
  Use when 查询或操作 BeyondClick 业务线、周策略、投放品类、关联项目、广告策略维度与成效、广告投放媒体渠道,或配置 sino-bc-cli:
5
- 投放品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯、优化项目、投放渠道;
5
+ 投放品类、业务线列表/详情/状态、周策略增删改查、策略周期/消耗/红绿灯、优化项目、投放渠道;
6
+ 生成业务线投放策略并导出 Excel(预算/广告产品/受众/素材及 learning);
6
7
  Facebook / Google / TikTok 广告策略维度(目标、出价、定向等配置分布)
7
8
  与广告策略成效(消耗、曝光、点击等);
8
9
  SSO 组别; 以及 /init、/update、/get-config、/set-config、/schema。
@@ -10,7 +11,7 @@ description: >
10
11
  以及营销协同项目、阶段、任务、文档、文件、投放数据、看板、飞书消息、组织用户、租户和用户资料接口。
11
12
  用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、广告策略维度、biz-line、
12
13
  Meta、Facebook、Google、TikTok、sso、user、sino-opti-hive、sino-bc-nexus、营销协同时也必须用本技能,不要自己拼 HTTP。
13
- 完整规则在子技能 sino-bc-shared 与 sino-bc-<domain>。
14
+ 完整规则在子技能 sino-bc-shared、sino-bc-<domain> 与额外专家技能。
14
15
  metadata:
15
16
  requires:
16
17
  bins: ["sino-bc-cli"]
@@ -28,6 +29,7 @@ sino-bc-cli/
28
29
  ├── sino-bc-shared/ 横切:配置、信封、确认门
29
30
  ├── sino-bc-auth/ 身份令牌与浏览器授权
30
31
  ├── sino-bc-biz-line/ 业务线、周策略、投放品类、广告策略维度与成效
32
+ ├── biz-line-strategy-generate/ 编排:四大策略 + Excel
31
33
  ├── sino-bc-media/ 广告投放媒体:投放渠道等媒体字典
32
34
  ├── sino-bc-sso/ SSO 组别
33
35
  ├── sino-bc-tenant/ 签约主体
@@ -63,7 +65,7 @@ Agent 读取时用本机实际安装路径(常见为 `~/.agents/skills/sino-bc
63
65
  ## 怎么跑
64
66
 
65
67
  1. 用 Read 打开 [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md):禁止拼 HTTP、成功看 `ok` / 退出码、写操作退出码 10、配置。
66
- 2. 按下表再读**一份**域技能。Shortcut、组参、枚举、长尾 `api <name>` 都在那份里。
68
+ 2. 按下表再读**一份**子技能(域技能或额外专家技能)。Shortcut、组参、枚举、长尾 `api <name>` 都在那份里。
67
69
  3. 有 Shortcut 用 `sino-bc-cli <domain> +<shortcut>`;没有再用 `sino-bc-cli <domain> api <name> --data '<json>'`。
68
70
 
69
71
  输入字段先查看 `/schema <name>`:query 参数同样放入 `--data`,由 CLI 编码到 URL;multipart 文件字段填写本地文件路径(如 `"file":"/path/report.pdf"`),CLI 发送文件内容。`--dry-run` 只校验并预览,不上传。
@@ -77,7 +79,8 @@ CLI 未安装:`npm i sino-bc-cli@latest -g`(Node.js >= 24)。技能未出
77
79
  | --- | --- | --- |
78
80
  | 身份令牌、网关地址、成功/失败怎么看、写操作要不要确认 | [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md) | `/auth login` `/set-config auth-token <AT> [RT]` `/get-config` |
79
81
  | 浏览器授权登录、身份令牌状态、清除凭证、查询可用签约主体 | 同上 | `/auth login\|status\|logout` `/tenant list` |
80
- | 投放品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯、关联项目/优化项目 | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
82
+ | 投放品类、业务线列表/详情/状态、周策略增删改查、策略周期/消耗/红绿灯、关联项目/优化项目 | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
83
+ | 生成业务线投放策略并导出 Excel(预算/广告产品/受众/素材及 learning) | [`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md) | 该技能 `scripts/`(`python3`) |
81
84
  | 投放渠道、广告投放媒体字典 | [`sino-bc-media/SKILL.md`](sino-bc-media/SKILL.md) | `media +channels` |
82
85
  | Facebook / Google / TikTok 广告策略维度(目标、出价、定向等配置分布)或广告策略成效(消耗、曝光、点击等) | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>`(维度 / 成效) |
83
86
  | SSO 组别 | [`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md) | `sso +group-list` |
@@ -97,7 +100,7 @@ CLI 未安装:`npm i sino-bc-cli@latest -g`(Node.js >= 24)。技能未出
97
100
 
98
101
  ## 子技能索引
99
102
 
100
- Agent 先读子技能 `sino-bc-shared`,再按意图读域技能。
103
+ Agent 先读子技能 `sino-bc-shared`,再按意图读域技能或额外专家技能。
101
104
 
102
105
  1. 配置、信封、确认门、禁止拼 HTTP:[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)(仓库 [`skills/default/sino-bc-shared/SKILL.md`](skills/default/sino-bc-shared/SKILL.md))
103
106
  2. 身份令牌与浏览器授权:[`sino-bc-auth/SKILL.md`](sino-bc-auth/SKILL.md)(仓库 [`skills/oapi/sino-bc-auth/SKILL.md`](skills/oapi/sino-bc-auth/SKILL.md))
@@ -116,6 +119,7 @@ Agent 先读子技能 `sino-bc-shared`,再按意图读域技能。
116
119
  15. 营销协同任务:交付闭环与操作日志:[`sino-bc-task/SKILL.md`](sino-bc-task/SKILL.md)(仓库 [`skills/oapi/sino-bc-task/SKILL.md`](skills/oapi/sino-bc-task/SKILL.md))
117
120
  16. 签约主体:[`sino-bc-tenant/SKILL.md`](sino-bc-tenant/SKILL.md)(仓库 [`skills/oapi/sino-bc-tenant/SKILL.md`](skills/oapi/sino-bc-tenant/SKILL.md))
118
121
  17. SSO 用户与签约主体(租户)用户资料:[`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md)(仓库 [`skills/oapi/sino-bc-user/SKILL.md`](skills/oapi/sino-bc-user/SKILL.md))
122
+ 18. 业务线策略生成:[`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md)(仓库 [`skills/custom/biz-line-strategy-generate/SKILL.md`](skills/custom/biz-line-strategy-generate/SKILL.md))
119
123
 
120
124
  安装与刷新:
121
125
 
@@ -132,8 +136,8 @@ sino-bc-cli /skill target list
132
136
  列出包内技能:`sino-bc-cli /skill`(只有入口这一条)。管理安装目录:`/skill target add|remove|list`。查看某条命令何时用:`sino-bc-cli biz-line --help`。
133
137
  不要把 `/update` 和 `/init` 连着跑:升级只用 `/update`。
134
138
 
135
- > 仓库里 `skills/default/` 只留 `sino-bc-shared`。域默认技能在 `skills/oapi/`,由 `npm run sync-api-doc` 整层重写。`skills/custom/` 可空;有同名目录则打包和 `/init` 整份用 custom,不再与 oapi 按文件叠加,且必须自带完整 `SKILL.md`。custom 不能覆盖 `sino-bc-shared`。
139
+ > 仓库里 `skills/default/` 只留 `sino-bc-shared`。域默认技能在 `skills/oapi/`,由 `npm run sync-api-doc` 整层重写。`skills/custom/` 可空:同名且自带完整 `SKILL.md` 则打包和 `/init` 整份用 custom;也可以放额外专家技能(目录名不是 `sino-bc-<domain>`)。custom 不能覆盖 `sino-bc-shared`。
136
140
  > `/init` 把根 `SKILL.md` 与选定子技能嵌进通过门控的默认目标(`~/.agents/skills` 始终写;Cursor/Claude/Codex 需 Agent 根已存在)以及 `extraSkillTargets`。
137
- > 上面的索引由同步脚本按 catalog 维护;域中文标签在 `src/catalog/sync/business-info.json`,概念与 HOW 在 `src/catalog/sync/domains/`,不要手改索引或往通用生成器添加业务特例。
141
+ > 上面的索引由同步脚本按 catalog 域 + `skills/custom/` 中带完整 `SKILL.md` 的额外专家技能维护;域中文标签在 `src/catalog/sync/business-info.json`,概念与 HOW 在 `src/catalog/sync/domains/`,不要手改编号索引。
138
142
 
139
143
  CLI 授权接口出入参采用驼峰;`accessExpiresAt`、`refreshExpiresAt` 为毫秒时间戳。凭证由 CLI 直接保存,Agent 无需自行换算或处理 token。
@@ -10,7 +10,7 @@
10
10
  | `oapi/` | Apifox 全模块同步生成,整层替换,禁止手改 |
11
11
  | `custom/` | 手写字段说明或文档覆盖,同步只读 |
12
12
 
13
- 同名文档按 custom → oapi → 目录根解析。custom 同名文件会优先展示,只有确需完整覆盖生成文档时才使用;一般业务工作流放 `skills/default/sino-bc-<domain>/references/`。
13
+ 同名文档按 custom → oapi → 目录根解析。custom 同名文件会优先展示,只有确需完整覆盖生成文档时才使用。这是接口文档的按文件查找,不是技能安装方式。域工作流写在 `src/catalog/sync/domains/`(同步进 `skills/oapi/`);额外专家技能放 `skills/custom/<技能名>/`,必须自带完整 `SKILL.md`。
14
14
 
15
15
  ## 按业务域查看
16
16