sino-bc-cli 1.0.0-beta.0

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

@@ -0,0 +1,62 @@
+---
+name: sino-bc-cli
+description: 查找 BeyondClick API 能力或区分相近业务域时使用；也用于 CLI 环境检查、技能安装与刷新。已核实目标 API Skill 时可直接读取该 Skill。
+metadata:
+  requires:
+    bins: ["sino-bc-cli"]
+---
+
+# sino-bc-cli
+
+BeyondClick 的全局 CLI。本入口帮助你根据业务对象和期望结果找到合适的 API Skill，并提供环境检查与初始化说明。下面的业务域页面列出具体功能模块及其完整 Skill；API Skills 位于安装目录的 `domains/sino-bc-<domain>/`。
+
+## 按任务读取
+
+- 已通过当前依赖说明、CLI 帮助或 schema 核实目标域及能力：直接读取完整域 Skill，无需先读分类页。
+- 目标域未知：先识别用户要处理的对象、动作和结果，再按下表选择业务域；读取候选页面的能力摘要和选用提示，确定功能模块后读取其完整 `SKILL.md`。只读当前任务相关的候选页，无需遍历全部 Skill。
+- 出现“项目”“消耗”“用户”“文件”等多个域共用的词时，结合下方区分线索及候选页的选用提示判断。已有上下文足够时直接选择；仍有会改变选路的歧义时，只询问缺少的业务对象或结果要求。
+- 能力摘要用于定位候选入口。具体操作是否支持、接口名和参数是什么，要在完整 Skill、CLI 帮助或 schema 中核实；不要从相似关键词推导命令。任务包含多个业务步骤时，分别核对所需能力。
+- 调用 API 前读取 shared 轻量入口，再按命中条件读取其 references，当前上下文已读且仍适用时可复用；参数、风险和权限以 CLI 帮助及 `/schema <name>` 为准。禁止自行拼网关 HTTP。
+
+相近意图优先区分：
+
+- **项目、消耗、报表**：优化项目的月度消耗、工时与人效，营销协同项目的投放阶段花费与 KPI，以及预算分布、项目分布和时间轴，是不同能力；“查看项目数据”本身不足以确定入口。
+- **用户、成员、主体**：按姓名或 ID 查个人资料、查看组织架构和团队成员、查询可访问的签约主体，分别按查询对象选择；“租户用户资料”仍是查用户，不能只因含“租户”就选主体查询。
+- **文件、上传、下载**：结合文件用途区分项目文档、文档中心、财务对账或发票文件；已知 storageKey 获取下载链接，或无特定业务归属的通用上传，再查通用文件能力。
+- **策略、成效、媒体**：区分已有周策略或 AI 策略记录、广告策略维度及成效、投放渠道字典；“AI 策略记录”的存取能力不代表支持生成新策略，“媒体字典”也不代表支持查询广告成效。
+
+索引只用于 API 能力路由，不是安装清单。`sino-bc-cli /skill` 才列出同包的全部完整入口及职责。
+
+## 业务域
+
+<!-- skill-index:start -->
+API 调用前先读[共用规则：sino-bc-shared](../sino-bc-shared/SKILL.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) |
+| SSO 用户资料、按姓名模糊列表与签约主体（租户）用户资料 | [用户](references/domain-index/module-8581524.md) |
+| 广告投放媒体：投放渠道等媒体字典 | [广告投放媒体](references/domain-index/module-8601540.md) |
+| 财务对账单查询；发票结算单与发票文件下载；月度对账文件与邮件记录；后付额度查询；预付钱包、充值与流水查询 | [财务&钱包](references/domain-index/module-8614891.md) |
+| 通用文件上传与按 storageKey 取下载链接 | [通用功能](references/domain-index/module-8621792.md) |
+<!-- skill-index:end -->
+
+## 安装与查看
+
+运行环境为 Node.js >= 24。先检查当前执行环境中的 `sino-bc-cli` 是否可用；未安装时使用 `npm i sino-bc-cli@latest -g`。
+
+```bash
+sino-bc-cli /init
+sino-bc-cli /skill
+sino-bc-cli /skill target list
+sino-bc-cli /update
+```
+
+`/init` 安装同包的全部技能。默认目标为 `~/.agents/skills`；存在 `~/.claude` 时另装到 `~/.claude/skills`。额外目标通过 `/skill target add|remove|list` 管理。技能未出现时执行 `/init`；`/update` 安装 latest 后自动刷新。刷新会整目录替换 `sino-bc-cli`、`sino-bc-shared`；专家按有效旧名单与当前名单的并集清理并安装当前包，旧名单缺失、损坏、不可读或无法识别时改用当前包名单。同名技能里的本地修改会被替换，其它技能保留。新通用目标成功后，未登记的旧 Codex/Cursor 位置按相同固定目录及专家名单规则清理，不重新安装；已登记或实际路径属于生效目标的目录只刷新。详细配置与执行规则见 shared。
+
+仅 `high-risk-write` 需要业务确认，普通 `write` 在必要校验通过后直接执行；`--yes` 不能绕过身份或主体校验。主体绑定、确认与鉴权恢复的完整流程见上方索引中的 shared。
+
+配套使用最新 CLI 与随包 Skill。需要查看状态时执行 `sino-bc-cli /auth status --json`，从成功信封的 `data.localStatus`、`data.message` 和 `data.authContextId` 读取本地状态、解释和认证上下文。它不验证服务器是否仍接受令牌；正常业务由 CLI 自动尝试续期，无需每次先查状态或重新登录。配置文件缺失、本人资料为空或过期均不代表未登录。状态含义及最终 `error.params[].reason` 的恢复规则见上方 shared 入口按条件引用的参考。

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

@@ -0,0 +1,36 @@
+---
+name: sino-bc-auth
+description: "查询或操作 BeyondClick 身份令牌与浏览器授权（auth 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli auth --help
+---
+
+# 访问凭证管理
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli auth +<shortcut>`。WHEN 见 `affordance/auth.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli auth api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 获取授权链接地址 | `auth-cli-device-oauth-code` |  |
+| 获取访问凭证accessToken和刷新凭证refreshToken | `auth-cli-device-oauth-exchange` |  |
+| 通过刷新凭证refreshToken获取访问凭证accessToken | `auth-cli-device-oauth-refresh` |  |
+
+```bash
+sino-bc-cli auth +code --data '<json>'
+sino-bc-cli auth api auth-cli-device-oauth-code --data '<json>'
+```

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

@@ -0,0 +1,48 @@
+---
+name: sino-bc-bill
+description: "查询或操作 BeyondClick 财务对账单查询（bill 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli bill --help
+---
+
+# 对账单
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+对账单是可开票的账单聚合；月度对账文件另见 reconciliation。列表若响应再包一层 `xxxPage`，不要开启 CLI 翻页；未注册的汇总字段 `collectFlag` 不生效。
+
+全部接口 `tenant=true`，每次调用成对传 `--corporation-id` 与 `--auth-context-id`；角色支持 `passport` / `system`。请求体不要自行添加 `corporationId`，字段与分页能力按 `/schema <name>`。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli bill +<shortcut>`。WHEN 见 `affordance/bill.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli bill api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 对账单列表 | `bill-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 对账单基本信息 | `bill-detail-basic` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 对账单明细 | `bill-original-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 对账单操作历史 | `bill-operate-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 对账单与发票枚举 | `bill-invoice-enum` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli bill +bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli bill api bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,58 @@
+---
+name: sino-bc-biz-line
+description: "查询或操作 BeyondClick 业务线、已有周策略、投放品类、策略标签、关联项目。完整的策略生成并导出 Excel 任务使用 biz-line-strategy-generate。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli biz-line --help
+---
+
+# 业务线策略
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+业务线字典按 `sceneCode` 查询；周策略管理与业务线关联项目归本域；组别选项、管理列表和详情使用 sso-team-group 域。
+
+- `+categories` 必填 `sceneCode`。投放品类用 `PLACEMENT_CATEGORY`，客户类型用 `CUSTOMER_TYPE`。三类策略标签分别用 `BUDGET_STRATEGY` / `MEDIA_STRATEGY` / `AUDIENCE_STRATEGY`，且必须带非空 `filterCondition`（实际字典配置值，不是业务线 ID 或场景名）；缺它会得到 `[]`，不要据此判断没有标签。
+- 周策略新建用 `+strategy-save`；标签字段只传字典 `id`，不传 `name` / `itemCode`。
+- 广告维度与成效读取 [biz-line-metrics](../sino-bc-biz-line-metrics/SKILL.md)；AI 策略保存、历史和日志读取 [biz-line-ai-strategy](../sino-bc-biz-line-ai-strategy/SKILL.md)。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli biz-line +<shortcut>`。WHEN 见 `affordance/biz-line.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli biz-line api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 查询业务线分页列表 | `biz-line-list` | 角色：sso/system |
+| 业务线详情 | `biz-line-detail` | 角色：sso/system |
+| 新建业务线 | `biz-line-save` | 角色：sso/system |
+| 更新业务线 | `biz-line-update` | 角色：sso/system |
+| 更新业务线状态 | `biz-line-status-update` | 角色：sso/system |
+| 查询投放策略分页列表 | `biz-line-strategy-list` | 角色：sso/system |
+| 查询投放策略消耗信息 | `biz-line-strategy-spend` | 角色：sso/system |
+| 新建投放策略 | `biz-line-strategy-save` | 角色：sso/system |
+| 更新投放策略 | `biz-line-strategy-update` | 角色：sso/system |
+| 查询业务线字典和策略标签 | `biz-line-open-dict-items` | 角色：sso/system |
+| 查询业务线关联项目和广告账号 | `biz-line-project-list` | 角色：sso/system |
+| 查询项目分页列表 | `optimize-project-query-by-page` | 角色：sso/system |
+
+## 业务参考
+
+- [Common Mistakes](references/common-mistakes.md)
+- [业务线枚举口径](references/enums.md)
+
+```bash
+sino-bc-cli biz-line +list --data '<json>'
+sino-bc-cli biz-line api biz-line-list --data '<json>'
+```

package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/references/common-mistakes.md

@@ -0,0 +1,7 @@
+# Common Mistakes
+
+| 错误 | 正确做法 |
+| --- | --- |
+| 自己用 curl 拼网关请求 | 走 `biz-line +<shortcut>`，没有就用 `biz-line api <name>` |
+| 把 `exprot-all` 改成 `export-all` | 按服务端拼写调用 |
+| 把详情接口的示例 ID 直接当真实业务线 | 先 `+list --data '{"name":"..."}'` 拿到 `id`；`biz-line-detail` 的 `--data` 形如 `{ "id": <bizLineId> }` |

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

@@ -0,0 +1,13 @@
+# 业务线枚举口径
+
+- 红绿灯（`TrafficLightEnum`）：
+  - `1` 绿灯，KPI 达标
+  - `2` 黄灯，距 KPI GAP 20% 内
+  - `3` 红灯，距 KPI GAP 20% 以上
+  - `4` 红灯，已暂停
+  - `5` 黄灯，存在风险
+  - `6` 绿灯，KPI 达标且项目顺利
+- 客户满意度：`1` 满意，`2` 不满意。
+- 业务线状态：`1` 进行中 / `2` 已完成 / `3` 已暂停。
+
+字段含义与请求体形状以 `src/api-doc/oapi/biz-line.md` 为准（全局安装为 `dist/api-doc/oapi/`）。

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

@@ -0,0 +1,46 @@
+---
+name: sino-bc-biz-line-ai-strategy
+description: "查询或操作 BeyondClick AI 策略保存、历史记录、使用日志与正式策略快照（biz-line-ai-strategy 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli biz-line-ai-strategy --help
+---
+
+# 业务线AI策略
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+AI 策略落库与正式周策略新建/更新是不同接口。
+
+- 保存走 `biz-line-ai-strategy +ai-strategy-save`。Excel 先 `common-file +upload`，把 `storageKey` 填进 `fileStorageKey`；标签只传字典 `id`。
+- 查询已保存策略、使用日志和正式策略快照，分别用 `api biz-line-ai-strategy-list`、`api biz-line-ai-strategy-use-log-list`、`api biz-line-ai-strategy-snapshot-list`。三者为非租户只读接口，支持 `sso` / `system` / `passport`；列表查询不会记录获取日志。
+- 三个列表筛选均可选，使用 `pageNum` / `pageSize`（默认 1 / 10），固定按 ID 倒序；继承的排序字段、`pagination` / `count` 不生效。按 `/schema <name>` 核对筛选与分页能力，不用 `pagination:false` 获取全量。
+- 正式周策略与策略标签字典见 [biz-line](../sino-bc-biz-line/SKILL.md)。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli biz-line-ai-strategy +<shortcut>`。WHEN 见 `affordance/biz-line-ai-strategy.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli biz-line-ai-strategy api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 保存业务线AI策略 | `biz-line-ai-strategy-save` | 角色：sso/system |
+| 业务线AI策略分页列表 | `biz-line-ai-strategy-list` | 角色：sso/system/passport |
+| 业务线AI策略使用日志分页列表 | `biz-line-ai-strategy-use-log-list` | 角色：sso/system/passport |
+| 用户填写原始策略快照分页列表 | `biz-line-ai-strategy-snapshot-list` | 角色：sso/system/passport |
+
+```bash
+sino-bc-cli biz-line-ai-strategy +list --data '<json>'
+sino-bc-cli biz-line-ai-strategy api biz-line-ai-strategy-list --data '<json>'
+```

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

@@ -0,0 +1,46 @@
+---
+name: sino-bc-biz-line-metrics
+description: "查询或操作 BeyondClick 广告策略维度与成效数据（biz-line-metrics 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli biz-line-metrics --help
+---
+
+# 业务线策略广告成效数据
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+查询 Facebook（Meta）、Google、TikTok 的广告策略维度与成效。维度接口返回配置（目标、出价、定向）；成效使用对应 metrics 接口。
+
+- `country_code` 必须单独传入，不要只放进筛选对象。请求字段与分页能力逐接口读取 `/schema <name>`。
+- 业务线、关联项目和正式周策略见 [biz-line](../sino-bc-biz-line/SKILL.md)。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli biz-line-metrics +<shortcut>`。WHEN 见 `affordance/biz-line-metrics.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli biz-line-metrics api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| Facebook广告策略维度数据 | `icenter-strategy-dimension-facebook` | 角色：sso/system |
+| Google广告策略维度数据 | `icenter-strategy-dimension-google` | 角色：sso/system |
+| TikTok广告策略维度数据 | `icenter-strategy-dimension-tiktok` | 角色：sso/system |
+| Facebook广告策略成效数据 | `icenter-strategy-metrics-facebook` | 角色：sso/system |
+| Google广告策略成效数据 | `icenter-strategy-metrics-google` | 角色：sso/system |
+| TikTok广告策略成效数据 | `icenter-strategy-metrics-tiktok` | 角色：sso/system |
+
+```bash
+sino-bc-cli biz-line-metrics +facebook-dimension --data '<json>'
+sino-bc-cli biz-line-metrics api icenter-strategy-dimension-facebook --data '<json>'
+```

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

@@ -0,0 +1,44 @@
+---
+name: sino-bc-common-file
+description: "查询或操作 BeyondClick 通用文件上传与按 storageKey 取下载链接（common-file 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli common-file --help
+---
+
+# 文件管理
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+通用对象存储：上传拿 `storageKey`，再用 key 换临时下载链接。不要和营销协同 `document` 域（`/sino-bc-nexus/file/*`）混用。
+
+- 上传走 `common-file +upload`（multipart，`file` 填本地路径；`serviceName` 可空，默认 `bc-business-pu`）。保存返回的 `storageKey`，不要把临时 `url` 当长期标识。
+- 换链走 `common-file +url`，`--data` 只传上传返回的 `storageKey`。
+- 本域 `tenant=false`，不要传 `--corporation-id`。角色限 `sso` / `system`。
+- 业务线 AI 策略 Excel 的 `fileStorageKey` 用本域上传结果，不要填下载 URL。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli common-file +<shortcut>`。WHEN 见 `affordance/common-file.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli common-file api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 上传文件 | `common-file-upload` | 角色：sso/system |
+| 获取文件下载链接 | `common-file-download-url` | 角色：sso/system |
+
+```bash
+sino-bc-cli common-file +url --data '<json>'
+sino-bc-cli common-file api common-file-download-url --data '<json>'
+```

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

@@ -0,0 +1,50 @@
+---
+name: sino-bc-dashboard
+description: "查询或操作 BeyondClick 营销协同看板：预算分布、项目分布与关键项目时间轴（dashboard 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli dashboard --help
+---
+
+# 看板
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+按当前可见项目聚合预算、分布和关键项目时间轴。筛选条件以 `/schema` 为准，不要把单个项目的投放指标接口当成看板。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli dashboard +<shortcut>`。WHEN 见 `affordance/dashboard.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli dashboard api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 营销目标预算分布 | `dashboard-budget-by-marketing-goal` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 媒体预算占比 | `dashboard-budget-by-media` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 项目类型预算分布 | `dashboard-budget-by-project-type` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 区域预算占比 | `dashboard-budget-by-region` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 预算排行榜 | `dashboard-budget-rank` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 预算来源占比 | `dashboard-budget-source-ratio` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 关键项目时间轴 | `dashboard-key-project-timeline` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 核心卡片指标 | `dashboard-metrics` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 项目分布 | `dashboard-project-distribution` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli dashboard +budget-by-marketing-goal --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli dashboard api dashboard-budget-by-marketing-goal --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,48 @@
+---
+name: sino-bc-dict
+description: "查询或操作 BeyondClick 营销协同通用字典：按用途查询场景与按场景查询条目（dict 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli dict --help
+---
+
+# 通用字典
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+营销协同的通用字典包含场景定义和场景下的启用条目。
+
+- `dict +scenes` 查询场景；`bizScope` 可筛选 PROJECT、TASK 等用途，省略时不筛选，不默认 PROJECT，也不是项目表单 schema。
+- `dict +items` 按必填 `sceneCodes` 数组查询，传入 `--data '{"sceneCodes":["<场景编码>"]}'`，CLI 编码为 GET query。响应为以 sceneCode 为 key 的 Map；条目按场景配置返回扁平列表或 children 树。
+- 条目优先使用当前主体的私有字典，无私有条目时整体回落全局字典；上下文通过两个主体 flag 传递，不额外传业务 corporationId。
+- 下拉提交编码用 `itemCode`；`itemValue` 是业务配置值，不能混用。业务线投放品类与策略标签仍使用 `biz-line +categories` 的 sceneCode 单数参数及原返回约定。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli dict +<shortcut>`。WHEN 见 `affordance/dict.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli dict api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 按场景查询字典条目 | `dict-items` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 按作用域查询字典场景 | `dict-scenes` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli dict +items --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli dict api dict-items --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,53 @@
+---
+name: sino-bc-document
+description: "查询或操作 BeyondClick 营销协同文档中心、文件上传与对象存储记录（document 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli document --help
+---
+
+# 营销协同文档
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+营销协同文档中心（`document-*`）和物理文件上传、对象存储记录（`file-*`）。业务侧用文件唯一标识关联，不要直连存储地址拼下载。
+
+- 文档类型（`DocTypeEnum`）：`PROJECT` 项目文档，`PROJECT_STAGE` 阶段归属标记，`PROJECT_ATTACHMENT` 项目信息附件，`TASK` 任务文档，`TASK_DELIVERY` 交付附件，`TASK_DELIVERY_REVIEW_REJECT` 审核驳回附件，`TASK_DELIVERY_REJECT` 客户驳回附件。
+- 通用物理上传用 `file-upload`（multipart）；查询用 `file-upload-info` / `file-upload-info-by-record` / `file-url`。
+- 项目文档关系及 `project-document-upload` 见 [project](../sino-bc-project/SKILL.md)，不要和本域文件上传混用。
+- 跨服务通用上传（策略 Excel 等）见 [common-file](../sino-bc-common-file/SKILL.md)。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli document +<shortcut>`。WHEN 见 `affordance/document.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli document api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 协同文档详情 | `document-detail` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 协同文档列表（全量） | `document-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 协同文档列表（分页） | `document-page` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 根据上传记录ID获取上传文件信息 | `file-upload-info-by-record` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 获取上传文件信息 | `file-upload-info` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 文件上传 | `file-upload` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 获取上传文件链接 | `file-url` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli document +detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli document api document-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,62 @@
+---
+name: sino-bc-im
+description: "查询或操作 BeyondClick 营销协同飞书群消息（im 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli im --help
+---
+
+# 飞书IM
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+查询任务或项目关联的飞书群消息、成员、回复链，以及机器人发卡片、员工通知和项目告警。不包含定时同步 Job 和 mq-mock。
+
+- 群消息发送使用 `lark-im-message-send`；员工通知使用 `im +notify`（`lark-im-message-notify`），不要混用收件人和群 ID。
+- 员工通知需提供 `msgType`、对象形式的 `content` 和 `requestId`。收件人及分阶段规则以 `/schema lark-im-message-notify` 为准；逐人检查 `recipients` 与成功/失败计数，不能把部分成功当作全部送达。相同内容重试沿用 requestId，变更内容须换新标识；结果未知时先核实发送状态，不自动重复通知。
+- 群无法匹配项目时使用 `im +alert`（`lark-im-chat-project-unmatched-alert`），请求体必填 `chatId`，可选 `description`（报警描述），允许 SSO / System，不传主体上下文。成功且 result 为空仅表示服务处理成功，不保证飞书已送达。
+- `im +switch`（`lark-im-chat-summary-switch`）只查询群自动汇总全局开关，读取 `enabled`；不能用它开启或关闭汇总。
+
+- `im +task-config` 按 `projectId` 查询项目通知对象及自动创建任务配置，只读；仅允许 SSO / Passport，不传主体上下文。
+
+发消息、通知和告警均是写操作。调用前核实目标和内容，并按 shared 读取适用的身份与主体规则。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli im +<shortcut>`。WHEN 见 `affordance/im.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli im api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 查询会话成员 | `lark-im-chat-members` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询任务或项目日志关联的飞书聊天记录 | `lark-im-lark-chat-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 锚点翻页查询群消息 | `lark-im-message-cursor` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 按 chatId + messageId 查询消息明细 | `lark-im-message-detail` | 角色：sso/passport/system |
+| 分页查询群消息 | `lark-im-message-page` | 角色：sso/passport/system |
+| 按引用链根查询根消息及全部回复 | `lark-im-message-replies` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询消息归属（主群或话题） | `lark-im-message-scope` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 应用机器人发送消息（卡片） | `lark-im-message-send` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 机器人通知飞书员工 | `lark-im-message-notify` | 角色：sso/system |
+| 查询群自动汇总全局开关 | `lark-im-chat-summary-switch` | 角色：sso/passport/system |
+| 业务项目告警 | `lark-im-chat-project-unmatched-alert` | 角色：sso/system |
+| 查询项目通知及自动创建任务配置 | `lark-im-chat-summary-task-config` | 角色：sso/passport |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli im +members --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli im api lark-im-chat-members --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,48 @@
+---
+name: sino-bc-invoice
+description: "查询或操作 BeyondClick 发票结算单与发票文件下载（invoice 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli invoice --help
+---
+
+# 发票结算单
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+查询发票结算单，发票多文件下载用 `+invoice-download`。
+
+全部接口 `tenant=true`，每次调用成对传 `--corporation-id` 与 `--auth-context-id`；角色支持 `passport` / `system`。请求体不要自行添加 `corporationId`，字段与分页能力按 `/schema <name>`。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli invoice +<shortcut>`。WHEN 见 `affordance/invoice.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli invoice api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 对账单关联结算单 | `bill-settlement-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 发票结算单列表 | `invoice-settlement-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 发票结算单详情 | `invoice-settlement-detail` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 下载发票 | `invoice-download` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+| 结算单还款记录 | `invoice-settlement-payment-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli invoice +bill-settlements --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli invoice api bill-settlement-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```