sino-bc-cli 1.8.28 → 1.8.30

package/dist/affordance/quota.md

@@ -0,0 +1,19 @@
+# quota 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +credit
+
+- **WHEN**：后付信用额度
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli quota +credit --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli quota api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/reconciliation.md

@@ -0,0 +1,41 @@
+# reconciliation 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +reconciliation
+
+- **WHEN**：月度对账单列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli reconciliation +reconciliation --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +reconciliation-log
+
+- **WHEN**：月度对账单发送记录
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli reconciliation +reconciliation-log --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +reconciliation-preview
+
+- **WHEN**：对账邮件预览
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli reconciliation +reconciliation-preview --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +reconciliation-url
+
+- **WHEN**：月度对账单下载链接
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli reconciliation +reconciliation-url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli reconciliation api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/report.md

@@ -0,0 +1,75 @@
+# report 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +detail-choose-list
+
+- **WHEN**：查询项目维度筛选列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +detail-choose-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +detail-list
+
+- **WHEN**：查询项目成效列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +detail-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +dimension-module
+
+- **WHEN**：维度分布
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +dimension-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +kpi-module
+
+- **WHEN**：KPI 进度与走势
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +kpi-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +spend-module
+
+- **WHEN**：消耗分析
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +spend-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +core-metrics
+
+- **WHEN**：核心指标卡
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +core-metrics --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +campaign-page
+
+- **WHEN**：分页查询项目自动归集广告系列
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +campaign-page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +campaign-get
+
+- **WHEN**：查询广告系列设置
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +campaign-get --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +campaign-save
+
+- **WHEN**：保存广告系列设置
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli report +campaign-save --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli report api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/task.md

@@ -2,54 +2,56 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +action-log
 
 - **WHEN**：任务操作日志列表（全量）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +action-log --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +adjust
 
 - **WHEN**：调整任务(编辑任务基本信息、成员等，状态重新流转)
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +adjust --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +approve-review
 
 - **WHEN**：审核通过
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +approve-review --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +confirm
 
 - **WHEN**：确认通过
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +confirm --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +create
 
 - **WHEN**：创建任务
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +create --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +delete
 
 - **WHEN**：删除任务
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +delete --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +detail
 
 - **WHEN**：协同任务详情
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +edit
@@ -57,53 +59,53 @@
 - **WHEN**：编辑任务（修改基本信息、所属阶段、成员、附件，状态不变更，仅限待执行/待确认）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +edit --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +list
 
 - **WHEN**：协同任务列表（全量）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +page
 
 - **WHEN**：协同任务列表（分页）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +pause
 
 - **WHEN**：暂停任务
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +pause --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +reject-modify
 
 - **WHEN**：需修改（驳回）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +reject-modify --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +reject-review
 
 - **WHEN**：审核需修改
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +reject-review --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +submit-delivery
 
 - **WHEN**：去完成（提交交付）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +submit-delivery --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli task api <name> --data '{...}'`
-- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/tenant.md

@@ -2,6 +2,8 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +list
 
 - **WHEN**：查询用户签约主体列表

package/dist/affordance/user.md

@@ -2,6 +2,8 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +tenant-info-batch
 
 - **WHEN**：批量查询租户用户信息

package/dist/affordance/wallet.md

@@ -2,128 +2,21 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
-## +bill-list
-
-- **WHEN**：对账单列表
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +bill-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +bill-detail
-
-- **WHEN**：对账单基本信息
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +bill-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-
-## +bill-original
-
-- **WHEN**：对账单明细
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +bill-original --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +bill-operate
-
-- **WHEN**：对账单操作历史
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +bill-operate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +bill-enum
-
-- **WHEN**：对账单与发票枚举
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +bill-enum --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +bill-settlements
-
-- **WHEN**：对账单关联结算单
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +bill-settlements --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-
-## +invoice-list
-
-- **WHEN**：发票结算单列表
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +invoice-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +invoice-detail
-
-- **WHEN**：发票结算单详情
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +invoice-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-
-## +invoice-download
-
-- **WHEN**：下载发票
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +invoice-download --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +invoice-payments
-
-- **WHEN**：结算单还款记录
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +invoice-payments --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +reconciliation
-
-- **WHEN**：月度对账单列表
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +reconciliation --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +reconciliation-log
-
-- **WHEN**：月度对账单发送记录
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +reconciliation-log --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +reconciliation-preview
-
-- **WHEN**：对账邮件预览
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +reconciliation-preview --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-
-## +reconciliation-url
-
-- **WHEN**：月度对账单下载链接
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +reconciliation-url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-
-## +credit
-
-- **WHEN**：后付信用额度
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli wallet +credit --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 
 ## +own
 
 - **WHEN**：钱包首页
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +own --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +change-recent
 
 - **WHEN**：最近钱包流水
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +change-recent --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +recharge-recent
@@ -131,7 +24,7 @@
 - **WHEN**：最近充值记录
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +recharge-recent --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +currency
@@ -139,56 +32,56 @@
 - **WHEN**：钱包币种列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +currency --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +cash-accounts
 
 - **WHEN**：现金账务类型
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +cash-accounts --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +cash-change
 
 - **WHEN**：现金收支明细
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +cash-change --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +change-accounts
 
 - **WHEN**：钱包账务类型
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +change-accounts --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +quota-type
 
 - **WHEN**：钱包额度类型
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +quota-type --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +change
 
 - **WHEN**：钱包消费明细
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +change --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +recharge
 
 - **WHEN**：充值明细
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +recharge --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +currency-amount
 
 - **WHEN**：币种可用额度
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +currency-amount --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +exchange-rate
@@ -196,7 +89,7 @@
 - **WHEN**：币种汇率
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli wallet +exchange-rate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## api
@@ -204,4 +97,4 @@
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli wallet api <name> --data '{...}'`
-- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/api-doc/README.md

@@ -12,27 +12,36 @@
 
 同名文档按 custom → oapi → 目录根解析。custom 同名文件会优先展示，只有确需完整覆盖生成文档时才使用。这是接口文档的按文件查找，不是技能安装方式。域工作流写在 `src/catalog/sync/domains/`（同步进 `skills/oapi/`）；额外专家技能放 `skills/custom/<技能名>/`，必须自带完整 `SKILL.md`。
 
-## 按业务域查看
+Skill 安装保留三类职责：shared 管共用规则，API 域管单域能力，专家编排已有能力形成任务产物。完整 custom 可整域替换 oapi；独立专家顶层分发，依赖域位于导航 domains 内，不替换依赖域。根 Skill 只概览、shared 和非空 Apifox 模块；模块页列一级目录对应的 API Skill 能力，已核实域及能力可直读完整域。专家不进业务导航，`/skill` 列出全部入口。
 
-| 域 | 用途 | 接口文档 |
+## 按功能模块查看
+
+Apifox 模块组织业务域导航，一级目录对应下表的 API Skill 与命令域，子目录在 Skill 内作为功能分组。
+
+| 命令域 | 用途 | 接口文档 |
 | --- | --- | --- |
-| biz-line | 业务线、周策略、品类、策略标签、AI策略、优化项目及广告成效 | [查询](oapi/biz-line-query.md)、[策略](oapi/biz-line-strategy.md)、[AI策略](oapi/biz-line-ai-strategy.md) |
-| common-file | 通用文件上传与按 storageKey 取下载链接 | [通用文件](oapi/common-file.md) |
-| project-analysis | 优化项目月度分析、消耗/工时趋势、人效与 Excel 导出 | [项目分析](oapi/project-analysis.md) |
-| sso | SSO 组别 | [SSO](oapi/sso.md) |
-| project | 营销协同项目、成员、分组 | [项目](oapi/project.md) |
-| project-stage | 营销协同项目阶段 | [阶段](oapi/project-stage.md) |
-| task | 营销协同任务 | [任务](oapi/task.md) |
-| document | 文档中心与项目文档 | [文档](oapi/document.md) |
-| file | 营销协同文件上传与对象存储记录 | [文件](oapi/file.md) |
-| wallet | 对账单、发票结算、月度对账、后付额度与预付钱包 | [对账单](oapi/wallet-bill.md)、[发票](oapi/wallet-invoice.md)、[月度对账](oapi/wallet-reconciliation.md)、[额度](oapi/wallet-quota.md)、[钱包](oapi/wallet-prepaid.md) |
-| delivery | Campaign 归集与投放阶段指标 | [投放](oapi/delivery.md) |
-| dashboard | 看板 | [看板](oapi/dashboard.md) |
-| organization | 组织架构、团队成员与当前用户 | [组织用户](oapi/organization.md) |
-| user | SSO 与签约主体（租户）用户资料 | [用户信息](oapi/user.md) |
-| im | 飞书群消息 | [消息](oapi/im.md) |
-| tenant | 用户签约主体列表 | [租户](oapi/tenant.md) |
-| auth | CLI 设备授权协议；日常登录优先 `/auth login` | [授权](oapi/auth.md) |
+| biz-line | 业务线、周策略、投放品类、策略标签、关联项目与 SSO 组别 | [接口文档](oapi/biz-line.md) |
+| biz-line-metrics | 广告策略维度与成效数据 | [接口文档](oapi/biz-line-metrics.md) |
+| project-analysis | 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出 | [接口文档](oapi/project-analysis.md) |
+| biz-line-ai-strategy | AI 策略保存、历史记录、使用日志与正式策略快照 | [接口文档](oapi/biz-line-ai-strategy.md) |
+| project | 营销协同项目生命周期、成员、阶段、项目文档、投放阶段Tab及群关系 | [接口文档](oapi/project.md) |
+| task | 营销协同任务：交付闭环与操作日志 | [接口文档](oapi/task.md) |
+| document | 营销协同文档中心、文件上传与对象存储记录 | [接口文档](oapi/document.md) |
+| dashboard | 营销协同看板：预算分布、项目分布与关键项目时间轴 | [接口文档](oapi/dashboard.md) |
+| organization | 组织架构、团队成员与当前用户 | [接口文档](oapi/organization.md) |
+| im | 营销协同飞书群消息 | [接口文档](oapi/im.md) |
+| dict | 营销协同通用字典：按用途查询场景与按场景查询条目 | [接口文档](oapi/dict.md) |
+| report | 营销协同Campaign归集、投放阶段指标、花费、KPI与维度下钻 | [接口文档](oapi/report.md) |
+| tenant | 签约主体 | [接口文档](oapi/tenant.md) |
+| auth | 身份令牌与浏览器授权 | [接口文档](oapi/auth.md) |
+| user | SSO 用户资料、按姓名模糊列表与签约主体（租户）用户资料 | [接口文档](oapi/user.md) |
+| media | 广告投放媒体：投放渠道等媒体字典 | [接口文档](oapi/media.md) |
+| bill | 财务对账单查询 | [接口文档](oapi/bill.md) |
+| invoice | 发票结算单与发票文件下载 | [接口文档](oapi/invoice.md) |
+| reconciliation | 月度对账文件与邮件记录 | [接口文档](oapi/reconciliation.md) |
+| quota | 后付额度查询 | [接口文档](oapi/quota.md) |
+| wallet | 预付钱包、充值与流水查询 | [接口文档](oapi/wallet.md) |
+| common-file | 通用文件上传与按 storageKey 取下载链接 | [接口文档](oapi/common-file.md) |
 
 接口名称和数量以 `src/generated/api-catalog.json` 为唯一运行时依据；name 来自 OpenAPI 的 `x-cli-name`，不能从路由自行拼造。新开发者接入流程见 [bc-develop](../../.agents/skills/bc-develop/SKILL.md)，完整样例见 [项目分析接入](../../developer-doc/07-project-analysis-onboarding.md)。
 
@@ -48,6 +57,8 @@ CLI 从平台密钥存储读取身份令牌（macOS/Linux 为 AES 密文，Windo
 
 TTY 默认表格，非 TTY 默认 JSON 信封。成功 stdout，失败 stderr；参数/配置错误退出码 2，一般 API 错误 1。上游响应由 CLI 解包到 data，不需要调用者重复解包。
 
+先读 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取主体绑定、高风险写确认或鉴权恢复等 references；`--yes` 不绕过身份或主体校验。可用 `sino-bc-cli /skill` 查询 shared 的真实文件路径。
+
 ## 维护同步
 
-运行 `npm run sync-api-doc`，自动发现所有模块，分别导出、解析 OpenAPI，全部成功后统一替换生成物。token 只取环境变量 `APIFOX_TOKEN`；禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证，不能只看 catalog 新增数量。
+运行 `npm run sync-api-doc`，自动发现所有模块，分别读取并核对 OpenAPI 和原生目录树，全部成功后同事务替换目录索引与生成物。token 只取环境变量 `APIFOX_TOKEN`；禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证，不能只看 catalog 新增数量。