sino-bc-cli 1.0.0-beta.0

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

@@ -0,0 +1,40 @@
+---
+name: sino-bc-media
+description: "查询或操作 BeyondClick 广告投放媒体：投放渠道等媒体字典（media 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli media --help
+---
+
+# 媒体字典
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+投放渠道字典：按 `channelId`、`channelName` 对照渠道，响应里还有 `logoUrl`。
+
+- 列表走 `media +channels`。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli media +<shortcut>`。WHEN 见 `affordance/media.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli media api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 查询投放渠道列表 | `media-channels` | 角色：sso/system/passport |
+
+```bash
+sino-bc-cli media +channels
+sino-bc-cli media api media-channels --data '<json>'
+```

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

@@ -0,0 +1,46 @@
+---
+name: sino-bc-organization
+description: "查询或操作 BeyondClick 组织架构、团队成员与当前用户（organization 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli organization --help
+---
+
+# 组织与用户
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+人员架构树、团队成员和当前登录用户信息（`organization +info`）。按 userId 查 SSO 或签约主体（租户）用户姓名走 `user` 域。签约主体列表若走 CLI 身份面，优先 `/tenant list`，不要和本域人员查询混用。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli organization +<shortcut>`。WHEN 见 `affordance/organization.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli organization api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 获取用户可以查看的签约主体列表 | `corporation-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 人员架构树 | `org-member-tree` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 团队成员列表 | `team-member-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 获取当前用户信息 | `user-info` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 根据用户来源类型获取用户列表（包含SSO用户则只返回前10条） | `user-listBySourceType` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli organization +list --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli organization api corporation-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,112 @@
+---
+name: sino-bc-project
+description: "查询或操作 BeyondClick 营销协同项目生命周期、成员、阶段、项目文档、投放阶段Tab及群关系（project 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli project --help
+---
+
+# 营销协同项目
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+对客项目的生命周期、成员、分组、预算字段和操作日志。建项主路径是动态表单（`project-form-create` / `project-form-update`）；固定字段 `project-create` 仍可用，但不写表单扩展。
+
+
+动态表单创建与编辑是写操作。提交 `project-form-create` / `project-form-update` 前，先调用 `corp-project-form-template-form-schema` 获取适用模板并解析 `dslJson`，按动态表单选择字段，再用 `/schema` 核对提交结构。请求 schema 只列当前字段样例，并非完整字段清单；不要把静态样例当作全部可用字段或完整必填规则。创建静态必填 `name`，编辑静态必填 `id`；创建和编辑提交的 `templateType` 缺省为 `PROJECT`，动态字段及约束以适用表单为准。
+
+编辑采用整体替换，不是只修改传入字段。先用 `project-detail` 读取项目详情，以现有可写业务字段为基础合并本次修改，保留未修改的普通字段、动态扩展字段、完整成员和附件列表；不要直接回传权限、审计等只读字段，也不要仅提交 `id` 和变更字段。预算、投放阶段等字段另有未传、null、空列表处理规则时，以 `/schema` 对应字段说明为准。
+
+编辑前明确核对 `mpLink`：仅修改其他字段时保留原链接。已有链接被漏传或清空会按删除处理；删除或更换已有链接会清理原投放阶段及其 KPI、预算明细，不清空项目总预算金额。换链后再异步解析新文档，删除链接不会重新解析；不得因遗漏原值触发用户未要求的清理。
+
+- 项目状态（`ProjectStatusEnum`）：`PENDING` 待启动，`IN_PROGRESS` 进行中，`FINISHED` 已结束。
+- 成员、分组、阶段、项目文档及投放阶段 Tab 均在本域；投放阶段指标见 report。
+- 按业务场景查询字典用 `dict +scenes` / `dict +items`；下拉提交编码取 `itemCode`，展示名称取 `name`，不要发明枚举值。
+- 创建或编辑项目的动态表单用 `corp-project-form-template-form-schema`，查询时 `templateType` 必填；新建可省略 `refId`，编辑应传 `refId=项目ID`，以优先获取项目已绑定模板，避免取到主体当前的新建模板。项目操作权限汇总用 `project-actions`，返回权限资格，执行操作时仍由服务端校验业务条件。
+- `project +chats`（`project-chat-chats`）查询当前身份所属飞书租户中机器人仍在的群，不分页，不按项目或关键词筛选；群列表不代表调用者具有项目权限或群已满足绑定资格。
+- 项目飞书群关系归本域：`project-chat-bindings` 查已绑定群，`project-chat-eligible` 分页查候选群；绑定、解绑、换绑分别用 `project-chat-bind` / `project-chat-unbind` / `project-chat-replace`。群消息查询仍走 `im` 域。
+- `project +chats`、`project +chat-projects`、`project +system-page` 与 `project +system-detail` 不传主体上下文；上述其他项目接口仍需成对传 `--corporation-id` / `--auth-context-id`。群绑定接口支持 `sso` / `system`。以 `/schema <name>` 核对请求字段和角色，解绑、换绑使用查询得到的 `bindingId`，不要把 `chatId` 当绑定关系 ID。
+- `project +system-page`（`project-system-page`）仅供 `system` 身份分页查询项目；请求体 `corporationId` 可选，未传或去除首尾空格后为空时查询全部主体。单页查询用 `pageNum` / `pageSize` 指定页码与条数；查询全部项目用 `--page-all`，限页查询用 `--page-limit`，完整性与截断判断按 shared 输出参考执行。服务端固定按项目变更时间倒序，传入的 `sortType` / `sortDirection` 会被覆盖。
+- `project +system-detail`（`project-system-detail`）仅供 `system` 身份按项目 `id` 查询详情；`id` 经 `--data` 传入，由 CLI 编码为 GET query，签约主体由服务端从项目记录获取。
+- 群绑定契约建议将大整数 ID 作为十进制字符串传递，避免 JSON 数字精度丢失。`project-actions` 的原始 JSON 数字文本也会经 CLI 解析，不能保证超过 `Number.MAX_SAFE_INTEGER` 的项目 ID 精确；字符串支持尚未核实，遇到这类 ID 先确认服务端契约。
+
+项目内阶段实例、排序和当前阶段。有任务的阶段不可删。
+
+- 阶段状态按该阶段未删除任务聚合（`ProjectStageStatusEnum`）：无任务为 `PENDING`（等待开始）；存在未收口任务为 `PROGRESSING`（进行中）；任务全部 `COMPLETED` 或 `PAUSED` 为 `COMPLETED`（已完成）。
+- 当前阶段取第一个仍有未完成且未暂停任务的阶段。
+- `OVERDUE` / `DUE_SOON` 是任务展示标签，不参与阶段落库状态。
+
+项目文档关系及上传归本域：已关联任务的项目文档不可删，先查 `project-document-linked-tasks`；上传使用 `project-document-upload`（multipart，`file` 填本地路径）。
+
+投放阶段 Tab 使用 `project-delivery-data-stage-tabs`；Campaign 归集规则及投放指标读取 [report](../sino-bc-report/SKILL.md)。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli project +<shortcut>`。WHEN 见 `affordance/project.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli project api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 按项目查询最新操作日志（分页倒序） | `project-action-log-page-by-project` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 预算分布动态字段配置（按签约主体解析：主体 > 行业 > 不展示） | `project-budget-field-config` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 创建对客项目 | `project-create` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 删除对客项目 | `project-delete` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 投放阶段列表 | `project-delivery-data-stage-tabs` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 对客项目详情 | `project-detail` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 删除项目文档 | `project-document-delete` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询项目文档已关联任务列表 | `project-document-linked-tasks` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询项目文档 | `project-document-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 修改项目文档所属阶段 | `project-document-update-stage` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 上传项目文档 | `project-document-upload` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 动态表单创建对客项目 | `project-form-create` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 动态表单编辑对客项目 | `project-form-update` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 批量修改项目分组（将指定项目移动到目标分组） | `project-group-batch-update-projects` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 创建项目分组 | `project-group-create` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 删除项目分组 | `project-group-delete` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 分组详情 | `project-group-detail` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 分组列表（全量） | `project-group-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 更新项目分组名称 | `project-group-update` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 对客项目列表（全量） | `project-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 邀请项目成员 | `project-member-invite` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 项目成员列表 | `project-member-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 指定用户关联项目列表（项目成员+任务成员） | `project-member-projects` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 移除项目成员 | `project-member-remove` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 项目成员参与任务 | `project-member-tasks` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 对客项目列表（分页） | `project-page` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询项目阶段列表（含可见任务数） | `project-stage-list-with-task-count` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询项目阶段列表 | `project-stage-listByProjectId` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 批量保存项目阶段 | `project-stage-save` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 项目阶段名称列表 | `project-stage-stage-name-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 更新对客项目状态 | `project-status-update` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 编辑对客项目 | `project-update` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 根据签约主体获取创建项目动态表单 | `corp-project-form-template-form-schema` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 项目操作权限汇总 | `project-actions` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询项目已绑定飞书群 | `project-chat-bindings` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/system |
+| 分页查询项目可绑定飞书群 | `project-chat-eligible` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/system |
+| 绑定项目飞书群 | `project-chat-bind` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/system |
+| 解绑项目飞书群 | `project-chat-unbind` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/system |
+| 换绑项目飞书群 | `project-chat-replace` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/system |
+| 按飞书群查询关联项目 | `project-chat-projects` | 角色：sso/system |
+| 查询机器人所在飞书群 | `project-chat-chats` | 角色：sso/system |
+| 系统身份查询对客项目列表（分页） | `project-system-page` | 角色：system |
+| 项目详情（系统） | `project-system-detail` | 角色：system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli project +page-by-project --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli project api project-action-log-page-by-project --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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

@@ -0,0 +1,61 @@
+---
+name: sino-bc-project-analysis
+description: "查询或操作 BeyondClick 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出（project-analysis 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli project-analysis --help
+---
+
+# 优化项目分析
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+优化项目月度分析与工时系统（ATW）原始表不是同一套接口。
+
+- `+summary` / `+projects` / 趋势 / 人效 / 导出：优化工作台月度分析，必填 `startMonth` / `endMonth`（`YYYY-MM`）。不要和 ATW 命令混用。
+- `+atw-projects` / `+atw-tasks` / `+atw-timesheets`：工时系统单表分页，路径在 `/sino-opti-hive/atw/query/`。不要传分析接口的月份字段；工时归属用 `year` / `month`（`yyyyMM`）/ `week` / `entryDate`。
+- `+projects` 的 `projectId` 是优化项目 ID；ATW 的 `atwProjectId` / `atwTaskId` 是工时系统主键，不能互相替代。
+- ATW 三条都声明了分页 profile，可用 `--page-all`；分析侧只有项目数据列表声明了分页。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli project-analysis +<shortcut>`。WHEN 见 `affordance/project-analysis.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli project-analysis api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 导出优化师人效列表 | `project-analysis-export-member-hre` | 角色：sso/system |
+| 导出优化师工时列表 | `project-analysis-export-member-timesheets` | 角色：sso/system |
+| 导出项目数据列表 | `project-analysis-export-projects` | 角色：sso/system |
+| 查询优化师人效列表 | `project-analysis-member-hre` | 角色：sso/system |
+| 查询优化师消耗趋势 | `project-analysis-member-spend` | 角色：sso/system |
+| 查询优化师工时趋势 | `project-analysis-member-timesheet-trend` | 角色：sso/system |
+| 查询优化师工时列表 | `project-analysis-member-timesheets` | 角色：sso/system |
+| 查询项目数据列表 | `project-analysis-projects` | 角色：sso/system |
+| 查询单位工时消耗趋势 | `project-analysis-spend-per-hour` | 角色：sso/system |
+| 查询消耗与工时趋势 | `project-analysis-spend-timesheet` | 角色：sso/system |
+| 查询分析汇总 | `project-analysis-summary` | 角色：sso/system |
+| 查询工时系统项目列表（分页） | `atw-project-page` | 角色：sso/system |
+| 查询工时系统项目任务列表（分页） | `atw-task-page` | 角色：sso/system |
+| 查询工时系统工时明细（分页） | `atw-timesheet-page` | 角色：sso/system |
+
+## 业务参考
+
+- [项目分析工作流](references/analysis-workflow.md)
+- [项目分析的筛选与指标](references/filters-and-metrics.md)
+
+```bash
+sino-bc-cli project-analysis +member-hre --data '<json>'
+sino-bc-cli project-analysis api project-analysis-member-hre --data '<json>'
+```

package/dist/skills/sino-bc-cli/domains/sino-bc-project-analysis/references/analysis-workflow.md

@@ -0,0 +1,21 @@
+# 项目分析工作流
+
+## 月度复盘
+
+1. 先明确月份范围，以及用户是在看优化项目、某行业还是某组别。未知项目 ID 时先用 `biz-line +queryByPage --data '{"pageNum":1,"pageSize":20,"projectName":"用户给出的名称"}' --page-all` 查询，取返回的 `projectId` 并核对 `total`；有多个候选时按用户条件消歧，不自行选择第一条。
+2. 用 `project-analysis +summary --data '{"startMonth":"2026-08","endMonth":"2026-08"}'` 获取总体消耗、工时、人力和单位工时消耗。示例月份需换成用户指定月份。
+3. 用同一月份与筛选条件调用 `project-analysis +projects --data '{"startMonth":"2026-08","endMonth":"2026-08"}' --page-all` 读取完整项目明细。默认不带 `--page-all` 只取第一页，不能把它当成全部项目。
+4. 需要趋势时调用 `project-analysis +spend-timesheet --data '{"startMonth":"2026-08","endMonth":"2026-08"}'`；补上与汇总一致的 `projectIdList`、`industryList` 等筛选。比较人效再调用 `+member-hre`；分析任务工时占比用 `+member-timesheets`。
+5. 结论先交代期间、筛选和数据是否完整，再说明趋势。没有记录时先检查月份、项目权限与筛选交集，不把空结果直接归因于零投放。
+
+## 导出报表
+
+用户明确需要 Excel 后，按对象选 `+export-projects`、`+export-member-hre` 或 `+export-member-timesheets`，使用同一组 `--data` 条件。
+
+三个导出接口会在服务端创建 Excel 文件，风险为普通 `write`，当前 CLI 不要求 `--yes`。输出数据是文件 URL，CLI 不自动下载，不应把返回 URL 称为“本地文件已保存”。项目导出会由后端覆盖请求分页，且最多导出 Excel 行数上限；若需按总条数完整分析，优先使用分页读取并核对 `total`。
+
+先检查请求可用 `--dry-run`；该参数不会查询业务数据，也不会创建导出文件。真实请求失败时保留 CLI 返回的错误信息与 `ddtraceId`；修正筛选或身份后再重试，不能通过改网关路径绕开权限。
+
+## 工时系统原始表
+
+用户要的是工时系统项目 / 任务 / 明细，而不是月度分析报表时，分别用 `+atw-projects`、`+atw-tasks`、`+atw-timesheets`。先按名称或优化项目 ID 筛 ATW 项目，再拿 `atwProjectId` 去查任务和工时。这三条都分页，完整拉取加 `--page-all`。不要用 `+projects` 或 `+member-timesheets` 代替。

package/dist/skills/sino-bc-cli/domains/sino-bc-project-analysis/references/filters-and-metrics.md

@@ -0,0 +1,30 @@
+# 项目分析的筛选与指标
+
+本域对应优化工作台的项目分析。营销协同项目的创建、成员、阶段等操作使用 `project` 域；这里的项目 ID 是优化项目 ID，不能直接拿营销协同项目 ID 代替。
+
+## 月份和筛选
+
+月度分析那 11 个接口（`+summary` / `+projects` / 趋势 / 人效 / 导出）都要求 `startMonth`、`endMonth`，格式为 `YYYY-MM`，包含起止月份。开始月份不能晚于结束月份。工时系统 `+atw-projects` / `+atw-tasks` / `+atw-timesheets` 不要传这对月份字段。本域 Shortcut 走薄 `--data`，把这些字段写进 JSON；不要再用 `--month` / `--from` / `--to`。
+
+| 业务条件 | 原始 JSON 字段与口径 |
+| --- | --- |
+| 行业 | `industryList` 字符串数组：APP、GAME、ECBR；ECBR 为 EC/BR 合并项 |
+| 项目 | `projectIdList`；用已查询到的优化项目 ID，示例值不可直接当真实项目 |
+| PM 所在组别 | `ssoTeamCodeList`；按这些组别下担任 PM 的成员筛项目 |
+| 签约主体筛选 | `corporationIdList`；业务查询筛选，与网关 `x-corporation-id` 不是同一个参数 |
+| 页码和大小 | 项目数据列表与 ATW 三条：`pageNum` / `pageSize` |
+
+项目分析由服务端按登录用户项目权限过滤，未声明需要 CLI 当前签约主体，因此 `tenant=false`；已配置的主体上下文不会自动写进请求头，也不会自动变成 `corporationIdList`。需要主体筛选时明确传业务条件。
+
+项目数据列表使用 `{total,result}` 分页，`--page-all` 从第一页取尽；`--page-limit` 可限制页数。原始请求虽然继承 `pagination`、`sortType` 等字段，该接口实际只读取 `pageNum/pageSize`，不要用 `pagination:false` 代替自动翻页。项目列表的 `projectIdList` 为 Java Integer，汇总和其他分析为 Long。
+
+## 指标阅读
+
+- `spend`、`serviceFee`：服务端四舍五入为整数；不要误认为原始精度金额。
+- `timesheet`、`fullTimeEquivalent`：工时及折算人力，常保留一位小数；空值和零值需区分。
+- `spendPerHour`：单位工时消耗；`spendPerHourOfIndustry` 是行业基准。不要把比值直接解释为人员绩效结论。
+- `timesheetRatio`：工时占比已乘以 100，不能再次乘 100。
+- 角色 `roleType`：1=PM、2=主优化师、3=其他优化师。渠道可用 `media +channels` 查询 ID 与名称。
+- 趋势 `dateDisplay`：粒度由后端配置决定，源码默认不超过两个月按周，否则按月。以返回标签为准，不能固定假设每日数据。
+
+查字段类型和嵌套渠道、角色、任务结构使用完整 endpoint name，例如 `/schema project-analysis-summary` 或 `/schema project-analysis-member-timesheets`。CLI 返回的是上游 `result`，不需要再手动剥一层业务包装。

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

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

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

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

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

@@ -0,0 +1,53 @@
+---
+name: sino-bc-report
+description: "查询或操作 BeyondClick 营销协同Campaign归集、投放阶段指标、花费、KPI与维度下钻（report 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli report --help
+---
+
+# 报表相关
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+按营销协同投放阶段时间窗查询指标。
+
+- 指标卡、花费、KPI、维度下钻走 `project-delivery-data-*`；阶段 Tab 属于 project 域。
+- Campaign 归集规则也在本域：先 `+campaign-get` 看已有规则，再决定是否 `+campaign-save`；候选 Campaign 用 `+campaign-page`。阶段 Tab 见 [project](../sino-bc-project/SKILL.md)。优化工作台消耗与工时分析见 [project-analysis](../sino-bc-project-analysis/SKILL.md)，两者口径不同。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli report +<shortcut>`。WHEN 见 `affordance/report.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli report api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 查询项目维度筛选列表 | `project-delivery-data-detail-choose-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询项目成效列表 | `project-delivery-data-detail-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 维度分布 | `project-delivery-data-dimension-module` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| KPI 进度与走势 | `project-delivery-data-kpi-module` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 消耗分析 | `project-delivery-data-spend-module` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 核心指标卡 | `project-delivery-data-core-metrics` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 分页查询项目自动归集广告系列 | `project-campaign-setting-campaign-page` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 查询广告系列设置 | `project-campaign-setting-get` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 保存广告系列设置 | `project-campaign-setting-save` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli report +detail-choose-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli report api project-delivery-data-detail-choose-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

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-task/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: sino-bc-task
+description: "查询或操作 BeyondClick 营销协同任务：交付闭环与操作日志（task 域），用于本域 Shortcut 或 schema/API 调用。"
+metadata:
+  requires:
+    bins:
+      - sino-bc-cli
+    cliHelp: sino-bc-cli task --help
+---
+
+# 营销协同任务
+
+**开始前 MUST 先用 Read 工具读取 [sino-bc-shared](../../../sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references**；当前上下文已读且仍适用时可复用。
+
+## Core Concepts
+
+任务交付闭环和操作日志。持久化状态（`TaskStatusTypeEnum`）：`PENDING_EXECUTION` 待执行，`PENDING_REVIEW` 待审核，`PENDING_CONFIRM` 待确认，`COMPLETED` 已完成，`PAUSED` 已暂停。`OVERDUE` / `DUE_SOON` 仅展示，不落库。
+
+系统身份使用 `task +system-create`、`+system-submit-delivery`、`+system-confirm`、`+system-approve-review`、`+system-page` 与 `+system-detail`；这六个接口仅允许 `system`，不传 `--corporation-id` / `--auth-context-id`。普通任务接口的角色与主体要求仍以各自 `/schema` 为准。
+
+- 创建、提交交付、确认和审核通过均为写操作，请求体必须显式传 `corporationId`，并与项目或任务所属主体一致。先从项目/任务查询结果取得真实 ID 和主体，不使用示例值；确认与审核通过还须传对应 `deliveryId`。
+- `task-system-create` 的必填字段、成员与附件按 `/schema` 提交；`skipPendingExecution` 未传时服务端默认 true；可选 `targetStatus` 优先于该字段，取值及异步状态推进规则以 `/schema task-system-create` 为准。
+- `task +system-page` 的请求体 `corporationId` 可选，未传或空白时查询全部主体；单页查询用 `pageNum` / `pageSize`；查询全部任务用 `--page-all`，限页查询用 `--page-limit`，完整性与截断判断按 shared 输出参考执行。服务端固定按创建时间倒序。
+- `task +system-detail` 通过 `--data` 传任务 `id`，CLI 编码为 GET query；主体由服务端从任务记录获取。
+- 写入失败或响应未知时按 shared 鉴权恢复参考处理，不盲目重复创建、交付、确认或审核。
+
+## Shortcuts（推荐优先使用）
+
+有手写 Shortcut 时优先 `sino-bc-cli task +<shortcut>`。WHEN 见 `affordance/task.md`。⚠️ 表示高风险写；确认流程见 shared，普通 `write` 直接执行。
+
+本域暂无手写 Shortcut，用下面 API Resources。
+
+## API Resources
+
+先用 `/schema <name>` 查看字段，再用 `sino-bc-cli task api <name> --data '<json>'`。`<name>` 取自 catalog，不要发明。GET 的 query 参数同样通过 `--data` 传入；multipart 文件字段填写本地文件路径，由 CLI 上传内容，`--dry-run` 只预览。
+
+### 直属接口
+
+| 用户在问 | name | 注意 |
+| --- | --- | --- |
+| 任务操作日志列表（全量） | `task-action-log-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 调整任务(编辑任务基本信息、成员等，状态重新流转) | `task-adjust` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 审核通过 | `task-approve-review` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 确认通过 | `task-confirm` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 创建任务 | `task-create` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 删除任务 | `task-delete` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 协同任务详情 | `task-detail` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 编辑任务（修改基本信息、所属阶段、成员、附件，状态不变更，仅限待执行/待确认） | `task-edit` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 协同任务列表（全量） | `task-list` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 协同任务列表（分页） | `task-page` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 暂停任务 | `task-pause` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 需修改（驳回） | `task-reject-modify` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 审核需修改 | `task-reject-review` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 去完成（提交交付） | `task-submit-delivery` | 主体必填：`--corporation-id` 与 `--auth-context-id`；角色：sso/passport/system |
+| 创建任务（系统） | `task-system-create` | 角色：system |
+| 提交交付（系统） | `task-system-submit-delivery` | 角色：system |
+| 确认通过（系统） | `task-system-confirm` | 角色：system |
+| 审核通过（系统） | `task-system-approve-review` | 角色：system |
+| 任务分页（系统） | `task-system-page` | 角色：system |
+| 任务详情（系统） | `task-system-detail` | 角色：system |
+
+## 业务参考
+
+- [任务状态机](references/state-machine.md)
+
+## 主体上下文
+
+仅标记“主体必填”的接口适用以下要求。主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+```bash
+sino-bc-cli task +action-log --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+sino-bc-cli task api task-action-log-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>
+```

package/dist/skills/sino-bc-cli/domains/sino-bc-task/references/state-machine.md

@@ -0,0 +1,18 @@
+# 任务状态机
+
+口径来自 `TaskStatusTransitionEnum`。是否跳过审核/确认以接口报错和任务成员配置为准，不要按页面文案猜测。
+
+| 事件 | 允许来源 | 目标 |
+| --- | --- | --- |
+| 创建 | 不校验来源 | `PENDING_EXECUTION` |
+| 提交交付 `submit-delivery` | `PENDING_EXECUTION` | `PENDING_REVIEW` |
+| 审核通过 `approve-review` | `PENDING_REVIEW` | `PENDING_CONFIRM` |
+| 审核需修改 `reject-review` | `PENDING_REVIEW` | `PENDING_EXECUTION` |
+| 确认 `confirm` | `PENDING_CONFIRM` | `COMPLETED` |
+| 需修改 `reject-modify` | `PENDING_CONFIRM` | `PENDING_EXECUTION` |
+| 暂停 `pause` | 待执行 / 待审核 / 待确认 | `PAUSED` |
+| 调整 `adjust` | `PAUSED` / `COMPLETED` | `PENDING_EXECUTION` |
+| 编辑 `edit` | 待执行 / 待审核 / 待确认 | 不改 status |
+| 删除 `delete` | 不校验来源 | 不改 status（删行） |
+
+系统还可自动创建已完成任务（`AUTO_CREATE_COMPLETED`），以及代理确认 / 自动确认；这些不是 CLI 上手写 Shortcut，需要时先 `/schema`。