sino-bc-cli 1.8.31 → 1.8.32

package/dist/skill-manifest.json

@@ -2,7 +2,7 @@
   "formatVersion": 1,
   "skillFormat": 3,
   "packageName": "sino-bc-cli",
-  "version": "1.8.31",
+  "version": "1.8.32",
   "skills": [
     {
       "name": "sino-bc-cli",
@@ -12,8 +12,8 @@
       "sourcePath": "skills/sino-bc-cli",
       "entryPath": "skills/sino-bc-cli/SKILL.md",
       "files": {
-        "SKILL.md": "d69b5e65223f94042be9ecd61707079ef7a7509fe8bff555579d1be9254414d9",
-        "references/domain-index/module-8534789.md": "320060f5f485b6b2f68d74f2c4675cdee1fb7092c2cf028ab4fc0d996830054b",
+        "SKILL.md": "b3eaeb206e150edf885a7f4f8bd1453be11c5bf7d0e81177477842f38dcb4b1b",
+        "references/domain-index/module-8534789.md": "44afc5c053796bd2f266ad1847ae2bbda0cbeff2346c1848dc268d62de05fee5",
         "references/domain-index/module-8551546.md": "d66ad239715fb4a9d8a6ed28ac99ae9fc03cf19c4177f53c71a8065d9a85bfe1",
         "references/domain-index/module-8562638.md": "1ff991cdbf67835b413f53affe2696b6300583c8cd9e8d43ff029a1abcada329",
         "references/domain-index/module-8566367.md": "adc8cb895c7f4de7984017ad8a5d188b1041851dbb5d85bcaab29ca963a2708d",
@@ -64,13 +64,13 @@
     },
     {
       "name": "sino-bc-biz-line",
-      "description": "查询或操作 BeyondClick 业务线、已有周策略、投放品类、策略标签、关联项目及 SSO 组别。完整的策略生成并导出 Excel 任务使用 biz-line-strategy-generate。",
+      "description": "查询或操作 BeyondClick 业务线、已有周策略、投放品类、策略标签、关联项目。完整的策略生成并导出 Excel 任务使用 biz-line-strategy-generate。",
       "role": "api-domain",
       "layer": "oapi",
       "sourcePath": "skills/oapi/sino-bc-biz-line",
       "entryPath": "skills/sino-bc-cli/domains/sino-bc-biz-line/SKILL.md",
       "files": {
-        "SKILL.md": "64cb4babd083dfd3d9dc6f96639f6119baa9e47964686f5bd1e41a703afdb79a",
+        "SKILL.md": "80653d249159d8d6b69850dc3c1ad49268acb71b28f5b1466ffdb4d2c45b366c",
         "references/common-mistakes.md": "3b8a4fbe77618e5564a7ac7800f54f8787f15e3c05a318c609df7055b0ab3d51",
         "references/enums.md": "5746d8b0475cd7e6af0b0a0648ef2e090b1751aade03e4e5cf0cce99c4c1661f"
       }
@@ -242,6 +242,17 @@
         "SKILL.md": "acc85cc8cc916d650dc416e1e05bb7e4ad89a3587bc75ab0c7b090f4b8ca580f"
       }
     },
+    {
+      "name": "sino-bc-sso-team-group",
+      "description": "查询或操作 BeyondClick 优化组别选项、组长、成员与行业信息（sso-team-group 域），用于本域 Shortcut 或 schema/API 调用。",
+      "role": "api-domain",
+      "layer": "oapi",
+      "sourcePath": "skills/oapi/sino-bc-sso-team-group",
+      "entryPath": "skills/sino-bc-cli/domains/sino-bc-sso-team-group/SKILL.md",
+      "files": {
+        "SKILL.md": "1642554c99dea33c49dbe2369df0ab4dc2c49d13ce8d1681baf5af9b48420404"
+      }
+    },
     {
       "name": "sino-bc-task",
       "description": "查询或操作 BeyondClick 营销协同任务：交付闭环与操作日志（task 域），用于本域 Shortcut 或 schema/API 调用。",
@@ -273,7 +284,7 @@
       "sourcePath": "skills/oapi/sino-bc-user",
       "entryPath": "skills/sino-bc-cli/domains/sino-bc-user/SKILL.md",
       "files": {
-        "SKILL.md": "7e8b54afc23e96aad1f6f504c472b1bfe815fa566ed812d4fba322d091bc815a"
+        "SKILL.md": "dd1e7ddce8dddffc54f68851e64c44473b4a9f0c687246a94696fe08b28218a6"
       }
     },
     {
@@ -297,10 +308,10 @@
       "files": {
         "SKILL.md": "d7e961b2e2df03b40099a9f7467d1016f2a31fb0c3bbb5bfba1c1bc9cd301072",
         "references/ai-strategy-prompt.md": "f7529bbed0638de4d69fe440803bb2421cd681b528dd83665973b0557c66cde0",
-        "references/api-flow.md": "21c245379d7c82eb3d49f57eed6bcb2b00f54401b0bcba62e2a943af842006bd",
+        "references/api-flow.md": "c98ffddc9f5a9022cfd2f4f9046670e1c7ff2f4292ebe47c5ca8d5d17a71e243",
         "references/four-strategies.md": "3bf1cf21a378dd292068abe3fc5d041df17b11f01714eece441a41f8315c07d3",
         "references/metrics.md": "6580dd77493599b33f31b5769f0933274636b382b5d156e0b2caca1201e29f89",
-        "references/output-excel.md": "c9634a578f82b7b983c66d356bef23bb31c571672a7a15c748cd52d842fb7382",
+        "references/output-excel.md": "df362020644ffe3b553c22358c434b7a8f61efc4079bf7c162ee136f16afa24a",
         "references/runtime.md": "74245409a2a429ff9efe177fcfa5b3660bf88a6a3863e1f630e96c4eca613079",
         "references/spec.md": "bc10054168404e079bb874df31ffebcd8a86372c63b925997d57e72a2699f273",
         "scripts/ai_strategy.py": "6f6e9c570e68de47ede283083cb7a66b59751aaa19e88fa1dd206fe793b31eb6",

package/dist/skills/biz-line-strategy-generate/references/api-flow.md

@@ -16,7 +16,7 @@ sino-bc-cli biz-line api biz-line-list --data '{"pageNum":1,"pageSize":10,"sortT
 - **本接口出参很全，后续多数字段不用再查别的接口**，直接取用：
   - `id`、`name`：业务线 ID 与名称
   - `adCategoryIndustryIds`：所属行业 ID 列表，只取第一个作为标签查询 filterCondition
-  - `ssoTeamCodeName`：**组别名称**，已直接返回，不需要再用 `ssoTeamCode` 去 `biz-line +group-list` 反查
+  - `ssoTeamCodeName`：**组别名称**，已直接返回，不需要再用 `ssoTeamCode` 去 `sso-team-group +group-list` 反查
   - `periodStart` / `periodEnd`、`prevPeriodStart` / `prevPeriodEnd`：平台策略周期，仅作业务背景，不用于本次分析日期（本次范围见第 5 步）
   - `coreIndex`：业务线核心指标（自由文本，来源 `t_biz_line.core_index`，未配置时为 null）。注意与 `coreEffectIndex`（当期核心效果指标，策略回顾字段）**不是同一字段**，识别 KPI 时用 `coreIndex`
   - `pmUserNames`：业务线级 PM 姓名列表（当前 Excel 不输出 PM 列，见下方说明）

package/dist/skills/biz-line-strategy-generate/references/output-excel.md

@@ -6,7 +6,7 @@
 
 | 列名 | 取值来源 |
 | --- | --- |
-| 组别 | `biz-line-list` 出参 `ssoTeamCodeName`（组别名称，已直接返回，**不需要**再用 `ssoTeamCode` 去 `biz-line +group-list` 反查） |
+| 组别 | `biz-line-list` 出参 `ssoTeamCodeName`（组别名称，已直接返回，**不需要**再用 `ssoTeamCode` 去 `sso-team-group +group-list` 反查） |
 | 业务线 | `biz-line-list` 出参 `name` |
 | 本期/上期 | 本次请求实际使用的时间范围，**写在同一单元格内，并附实际覆盖范围**：`本期：yyyy-MM-dd～yyyy-MM-dd` + 换行 + `上期：yyyy-MM-dd～yyyy-MM-dd`。用户指定了就用用户的；未指定时本期为上周一至周日、上期为上上周一至周日，以本次 `periods.json` 为准，不使用业务线返回周期 |
 | 项目名称 | `biz-line-project-list` 出参 `result[].projectName`；一个业务线的多个项目**写在同一单元格内，一个项目一行**（用 `\n` 分隔） |

package/dist/skills/sino-bc-cli/SKILL.md

@@ -34,7 +34,7 @@ API 调用前先读[共用规则：sino-bc-shared](../sino-bc-shared/SKILL.md)
 
 | 意图 | 业务域 |
 | --- | --- |
-| 业务线、周策略、投放品类、策略标签、关联项目与 SSO 组别；广告策略维度与成效数据；优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出；AI 策略保存、历史记录、使用日志与正式策略快照 | [优化工作台](references/domain-index/module-8534789.md) |
+| 业务线、周策略、投放品类、策略标签与关联项目；广告策略维度与成效数据；优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出；AI 策略保存、历史记录、使用日志与正式策略快照；优化组别选项、组长、成员与行业信息 | [优化工作台](references/domain-index/module-8534789.md) |
 | 营销协同项目生命周期、成员、阶段、项目文档、投放阶段Tab及群关系；营销协同任务：交付闭环与操作日志；营销协同文档中心、文件上传与对象存储记录；营销协同看板：预算分布、项目分布与关键项目时间轴；组织架构、团队成员与当前用户；营销协同飞书群消息；营销协同通用字典：按用途查询场景与按场景查询条目；营销协同Campaign归集、投放阶段指标、花费、KPI与维度下钻 | [营销协同](references/domain-index/module-8551546.md) |
 | 签约主体 | [租户](references/domain-index/module-8562638.md) |
 | 身份令牌与浏览器授权 | [认证及授权](references/domain-index/module-8566367.md) |

package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sino-bc-biz-line
-description: "查询或操作 BeyondClick 业务线、已有周策略、投放品类、策略标签、关联项目及 SSO 组别。完整的策略生成并导出 Excel 任务使用 biz-line-strategy-generate。"
+description: "查询或操作 BeyondClick 业务线、已有周策略、投放品类、策略标签、关联项目。完整的策略生成并导出 Excel 任务使用 biz-line-strategy-generate。"
 metadata:
   requires:
     bins:
@@ -14,7 +14,7 @@ metadata:
 
 ## Core Concepts
 
-业务线字典按 `sceneCode` 查询；周策略管理、业务线关联项目与 SSO 组别归本域。
+业务线字典按 `sceneCode` 查询；周策略管理与业务线关联项目归本域；组别选项、管理列表和详情使用 sso-team-group 域。
 
 - `+categories` 必填 `sceneCode`。投放品类用 `PLACEMENT_CATEGORY`，客户类型用 `CUSTOMER_TYPE`。三类策略标签分别用 `BUDGET_STRATEGY` / `MEDIA_STRATEGY` / `AUDIENCE_STRATEGY`，且必须带非空 `filterCondition`（实际字典配置值，不是业务线 ID 或场景名）；缺它会得到 `[]`，不要据此判断没有标签。
 - 周策略新建用 `+strategy-save`；标签字段只传字典 `id`，不传 `name` / `itemCode`。
@@ -44,7 +44,6 @@ metadata:
 | 新建投放策略 | `biz-line-strategy-save` | 角色：sso/system |
 | 更新投放策略 | `biz-line-strategy-update` | 角色：sso/system |
 | 查询业务线字典和策略标签 | `biz-line-open-dict-items` | 角色：sso/system |
-| 查询组别列表 | `sso-team-group-list` | 角色：sso/system |
 | 查询业务线关联项目和广告账号 | `biz-line-project-list` | 角色：sso/system |
 | 查询项目分页列表 | `optimize-project-query-by-page` | 角色：sso/system |
 

package/dist/skills/sino-bc-cli/domains/sino-bc-sso-team-group/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: sino-bc-sso-team-group
+description: "查询或操作 BeyondClick 优化组别选项、组长、成员与行业信息（sso-team-group 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli sso-team-group --help
+---
+
+# 优化组别
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+# 优化组别查询
+
+- 只需组别 code/name 作为业务线筛选或保存参数时，使用 `sso-team-group +group-list`，无需请求体。
+- 查询组长、行业、优化师人数和更新时间时，使用 `sso-team-group +list --data '{}'`；可传 `leaderUserName`、`industryList` 筛选，返回全量列表，不分页。
+- 按 code 查询组长及在职优化师成员时，使用 `sso-team-group +detail --data '{"code":"<组别code>"}'`；组别不存在时结果可以为 null，成员排除组长。
+- 三个接口仅限 sso/system 角色，不要求签约主体。组别 code 是业务字段，不是签约主体 ID。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli sso-team-group +<shortcut>`。WHEN 见 `affordance/sso-team-group.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli sso-team-group api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 优化组别列表 | `sso-team-group-manage-list` | 角色：sso/system |
+| 优化组别详情 | `sso-team-group-manage-detail` | 角色：sso/system |
+| 优化组别选项列表 | `sso-team-group-list` | 角色：sso/system |
+
+```bash
+sino-bc-cli sso-team-group +list --data '<json>'
+sino-bc-cli sso-team-group api sso-team-group-manage-list --data '<json>'
+```

package/dist/skills/sino-bc-cli/domains/sino-bc-user/SKILL.md

@@ -20,7 +20,7 @@ SSO 用户与签约主体（租户）用户资料查询。文案里的签约主
 - `+sso-list`：按 `userIdList` 或名称模糊 `userName` 查 SSO 用户列表，两者至少传一个；返回列表无分页，字段含 `userDisplayName` / `email`，不要和 `+sso-info` 的单条资料结构混用。当前登录用户走 `organization +info` 或资料补查，不要用 `+sso-list` 回填身份槽。
 - `+tenant-info` / `+tenant-info-batch`：签约主体用户，`--data` 必须带 `corporationId` 与 `userId`/`userIdList`。本接口 `tenant=false`，主体 ID 放在请求体，不要用 `--corporation-id` 头代替。
 - `system` 角色可按接口角色范围显式查询目标用户资料；这两类接口不用于查询或自动补查系统身份本人的资料。
-- 可选主体列表走 `tenant +list` / `/tenant list`；组织树与团队成员走 `organization`；SSO 组别走 `biz-line +group-list`。不要和本域资料查询混用。
+- 可选主体列表走 `tenant +list` / `/tenant list`；组织树与团队成员走 `organization`；SSO 组别走 `sso-team-group +group-list`。不要和本域资料查询混用。
 - catalog 若声明 `roleScope`，CLI 在发请求前按 JWT `user_type` 拦截；未声明则不因角色拦截。
 - CLI 会把资料缓存在本机 `identity-cache.json`（passport 按主体 ID 分槽，没有「当前主体」）。这不是会话源：不要用缓存填 `--corporation-id`；对话里仍须成对保存 `--corporation-id` 与 `--auth-context-id`。
 

package/dist/skills/sino-bc-cli/references/domain-index/module-8534789.md

@@ -4,20 +4,21 @@
 
 | 意图 | 子技能 |
 | --- | --- |
-| 查询、新建或更新业务线及其状态；管理已有周策略，查看策略消耗、投放品类与策略标签、关联优化项目和广告账号，以及 SSO 组别。 | [sino-bc-biz-line](../../domains/sino-bc-biz-line/SKILL.md) |
+| 查询、新建或更新业务线及其状态；管理已有周策略，查看策略消耗、投放品类与策略标签、关联优化项目和广告账号。 | [sino-bc-biz-line](../../domains/sino-bc-biz-line/SKILL.md) |
 | 查询 Facebook（Meta）、Google、TikTok 的广告策略维度配置与成效数据，包括目标、出价、定向及对应效果；业务线与正式周策略管理使用 biz-line。 | [sino-bc-biz-line-metrics](../../domains/sino-bc-biz-line-metrics/SKILL.md) |
 | 分析优化项目月度汇总、项目列表、消耗与工时趋势、单位工时消耗和优化师人效，导出项目/工时/人效 Excel；也可分页查询工时系统项目、任务和工时原始表，两套时间口径不可混用。 | [sino-bc-project-analysis](../../domains/sino-bc-project-analysis/SKILL.md) |
 | 保存已生成的业务线 AI 策略，分页查询已保存策略、使用日志及用户填写的策略快照；不负责生成新策略或导出 Excel，也不等同于正式周策略的新建和更新。 | [sino-bc-biz-line-ai-strategy](../../domains/sino-bc-biz-line-ai-strategy/SKILL.md) |
+| 获取组别 code/name 选项；按组长名称或行业筛选组别管理列表，查询组长、优化师人数和组别成员详情。 | [sino-bc-sso-team-group](../../domains/sino-bc-sso-team-group/SKILL.md) |
 
 ## 选用提示
 
 ### 业务线策略
 
-关键词：业务线、周策略、品类、策略标签、组别、biz-line
+关键词：业务线、周策略、品类、策略标签、biz-line
 
-选用提示：业务线和正式周策略使用本域；广告策略成效看 biz-line-metrics，已保存的 AI 策略看 biz-line-ai-strategy。
+选用提示：业务线和正式周策略使用本域；广告策略成效看 biz-line-metrics，已保存的 AI 策略看 biz-line-ai-strategy；组别选项、组长及成员信息看 sso-team-group。
 
-相关域：[业务线策略广告成效数据](../../domains/sino-bc-biz-line-metrics/SKILL.md)、[业务线AI策略](../../domains/sino-bc-biz-line-ai-strategy/SKILL.md)
+相关域：[业务线策略广告成效数据](../../domains/sino-bc-biz-line-metrics/SKILL.md)、[业务线AI策略](../../domains/sino-bc-biz-line-ai-strategy/SKILL.md)、[优化组别](../../domains/sino-bc-sso-team-group/SKILL.md)
 
 ### 业务线策略广告成效数据
 
@@ -42,3 +43,11 @@
 选用提示：已生成的 AI 策略保存与记录查询使用本域；正式周策略管理看 biz-line。
 
 相关域：[业务线策略](../../domains/sino-bc-biz-line/SKILL.md)
+
+### 优化组别
+
+关键词：优化组别、组别选项、组长、优化师、行业、sso-team-group
+
+选用提示：只需 code/name 时使用组别选项列表；查组长、人数或行业用管理列表，查成员用详情；业务线和周策略看 biz-line。
+
+相关域：[业务线策略](../../domains/sino-bc-biz-line/SKILL.md)、[用户信息](../../domains/sino-bc-user/SKILL.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sino-bc-cli",
-  "version": "1.8.31",
+  "version": "1.8.32",
   "description": "BeyondClick CLI - 命令行工具集合，提供快捷访问 BeyondClick 平台的命令行接口",
   "preferGlobal": true,
   "bin": {