前言¶
在 SkillHub 或本地技能庫裏仍掛着「三連廣告批量操作」相關 Skill 時,Agent 容易繼續按已下線的舊入口查文檔、拼接口。B 站三連廣告 OpenAPI 已按投放形態拆成廣告管理與創意投放兩條線,批量改計劃、單元、創意,以及 2.0 項目與媒體的批量能力,不再由單一「批量操作」Skill 承載。
下面介紹 Skill「B站三連廣告-批量操作廣告」(標識 sanlian-ads-batch-operations)的定位:它不是可繼續對接當前 API 的實現包,而是已退役(RETIRED)的兼容標記,用來把舊名稱和舊觸發詞導向正確的新 Skill。
這是什麼¶
一句話:面向「舊批量操作 Skill」的兼容與路由說明,不承載具體 MAPI 調用邏輯。
- 上架與索引:SkillHub,分類
business-ops;頁面地址見文末。 - 狀態:官方簡介標明 RETIRED,並寫明 Do not use it for current API work(不要用於當前 API 開發)。
- 解決的問題:歷史文檔、腳本或對話裏仍引用
sanlian-ads-batch-operations或中文「舊批量操作」表述時,讓 Agent 改走現行 Skill,而不是在已下線能力上繼續推理。
與仍提供完整接口說明與腳本的 bilibili-sanlian-ads-ad-management、bilibili-sanlian-ads-delivery 不同,本 Skill 的核心價值是指路,不是代調接口。
核心功能(已覈實)¶
依據 SkillHub 線索中的官方簡介,本 Skill 只做能力分流:
| 需求類型 | 應使用的 Skill |
|---|---|
| 舊版鏈路:計劃、單元、創意的批量操作,以及批量任務查詢 | bilibili-sanlian-ads-ad-management |
| 創意驅動 2.0:項目與媒體的批量操作 | bilibili-sanlian-ads-delivery |
中文側可用於觸發遷移說明的表述包括:舊批量操作 skill、已下線批量 skill、batch-operations 遷移(與官方線索一致)。
SkillHub 側可見的索引信息(來源:任務線索,非頁面正文):評分 98298,下載約 2426 次。這些數字只說明該條目曾被大量檢索或安裝,不代表仍應對接舊批量 API。
安裝與啓用¶
官方詳情頁 https://api.skillhub.cn/user_b0010d5c/sanlian-ads-batch-operations 在當前環境抓取失敗(HTTP 405),未能覈對 Cursor、Codex CLI、Claude Code 的安裝命令或目錄結構。
建議做法:
- 在 SkillHub 打開上述地址,按頁面展示的說明安裝或保留該兼容 Skill(若你仍需舊名稱被 Agent 識別)。
- 並行安裝真正承接 API 的兩個 Skill:
bilibili-sanlian-ads-ad-management與bilibili-sanlian-ads-delivery,並在團隊文檔裏把「批量操作」默認指向二者之一,而不是本兼容標記。 - 未在官方頁面覈實的安裝參數、環境變量或配置項,本文不列出,避免與現行文檔不一致。
典型用法(可復現的協作方式)¶
本 Skill 沒有可單獨復現的「批量改價 / 批量啓停」接口示例;典型用法是在對話或規則裏觸發遷移,由 Agent 讀取本 Skill 後改讀目標 Skill。
示例對話意圖(示意,非 API 調用):
- 用戶:「用舊批量操作 skill 查一下批量任務列表。」
- Agent 命中兼容 Skill 或觸發詞「已下線批量 skill」後,應停止在
sanlian-ads-batch-operations下構造請求,轉而打開bilibili-sanlian-ads-ad-management中與「查詢批量操作任務」相關的說明(如官方 references 中的任務列表、任務詳情類文檔)。 - 用戶:「創意 2.0 批量改媒體。」
- Agent 應路由到
bilibili-sanlian-ads-delivery,而不是廣告管理 Skill 下的舊計劃/單元/創意批量接口。
經過上面的步驟,舊倉庫名、舊書籤、舊 prompt 裏的 Skill 名可以保留一段時間,但執行路徑應對齊現行 OpenAPI 分包。
適用場景與注意¶
適合誰
- 曾安裝或引用
sanlian-ads-batch-operations的團隊,需要一段過渡期,避免 Agent 報「找不到 Skill」或誤用已下線說明。 - 在內部 Runbook 裏仍寫「三連批量 Skill」字樣,希望統一改成「按鏈路選 ad-management 或 delivery」的維護者。
限制與坑
- 不要把本 Skill 當作當前 B 站三連廣告批量 OpenAPI 的唯一來源;官方已明確不要用於 current API work。
- 計劃 / 單元 / 創意批量與 2.0 項目 / 媒體批量分屬不同 Skill,混用會導致接口版本或字段不匹配。
- 若 SkillHub 頁面與本地緩存的
SKILL.md不一致,以 SkillHub 上該條目的 RETIRED 說明及遷移指向爲準。
結尾¶
「B站三連廣告-批量操作廣告」的價值在於:保留舊名的可發現性,同時強制把批量相關工作導向 bilibili-sanlian-ads-ad-management 與 bilibili-sanlian-ads-delivery。新接入或重構腳本時,應直接依賴後兩者,本兼容 Skill 僅作遷移標記。
官方地址:https://api.skillhub.cn/user_b0010d5c/sanlian-ads-batch-operations