前言¶
接騰訊營銷 DataNexus 數據採集 SDK，常見卡點不在「能不能搜到文檔」，而在流程長、端型多：要先選對小程序 / 小遊戲 / APP（iOS、Android、鴻蒙）或 JS SDK，再完成初始化、事件埋點、必報事件與 action_type 合規，最後還要聯調、對賬、看質量看板，報錯時還要對着 code 51000、data not valid 等碼排查。團隊裏若缺少統一 checklist，很容易在 user_action_set_id、secret_key、數據源 ID 等配置上反覆試錯。
下面介紹 SkillHub 上的企業級 Skill「騰訊營銷 datanexus sdk 接入助手」，由騰訊營銷 DataNexus 團隊發佈，把上述環節收斂爲可在 AI IDE 裏按步驟推進的助手能力；其中面向 AI IDE 的自動化接入標註爲 Beta，已接入項目還可做接入體檢。
這是什麼¶
一句話定位：DataNexus 數據採集 SDK 的接入與治理助手，覆蓋從選型到問題排查的完整鏈路，並支持在對話中觸發「自動接入」「接入審計 / 體檢」類訴求。
- 座標：
@tencent-adm/datanexus-sdk-skills - 當前版本：1.0.2（SkillHub 頁面展示爲 v1.0.2）
- 來源：enterprise
- 分類：business-ops
- 發佈者：騰訊營銷 DataNexus 團隊
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/datanexus-sdk-skills
- 技能包地址：https://api.skillhub.cn/tencent-adm/datanexus-sdk-skills
- 標籤：
requires_api_key=false（按 SkillHub 元數據，安裝本 Skill 本身不要求配置 API Key）
核心功能¶
資料中明確列出的能力如下，分六塊主線與兩項擴展：
- SDK 選型：在小程序 SDK、小遊戲 SDK、APP SDK（含 iOS、Android、鴻蒙）、JS SDK 等場景下協助判斷該用哪類 SDK。
- 接入開發：圍繞 SDK 初始化、接入流程、生成或整理接入代碼等開發步驟給出可執行指引。
- 事件埋點：與事件上報、埋點、
action_type、行爲清單，以及START_APP、PURCHASE、REGISTER等事件語義相關的實現與覈對。 - 聯調對賬：對接 SDK 接入流程中的聯調、數據對賬，以及與 SDK 質量看板相關的核對思路。
- 質量評估：涉及必報事件、事件覆蓋率、SDK 合規、埋點質量檢查等評估維度。
- 問題排查：針對 SDK 報錯、上報異常等場景協助定位（資料中舉例包括
code 51000、data not valid等表述）。
擴展能力：
- 面向 AI IDE 的自動化接入（Beta）：在用戶提出「接入 SDK」「自動接入」「幫我接入」「生成接入代碼」等意圖時，由助手按 Skill 內規範推進。
- 已接入項目接入體檢：對應「檢查接入」「審計接入」「audit」「體檢」等訴求，對已接入工程做接入側檢查與審計向的協助。
Skill 的觸發詞在官方簡介中寫得很全：除上述能力外，當對話中出現「小程序SDK」「數據源ID」「SDK質量看板」「事件覆蓋率」等關鍵詞，或明確要選擇 SDK 類型、排查上報問題、檢查埋點質量時，Agent 應優先啓用該 Skill。
安裝與啓用¶
安裝方式以 SkillHub 官方說明爲準：先按 SkillHub 安裝與優先源配置 準備 skillhub CLI，再把技能裝到當前 Agent 實際讀取的 skills 目錄（裝錯目錄會導致 Agent 識別不到，文檔要求使用 --dir）。
1、檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝，可使用官方安裝腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
skillhub install @tencent-adm/datanexus-sdk-skills --dir <當前 Agent 的 skills 目錄>
SkillHub 頁面也給出了面向 AI 的提示詞式安裝說明：讓 Agent 根據 https://skillhub.cn/install/skillhub.md 安裝 @tencent-adm/datanexus-sdk-skills。
3、各客戶端 skills 目錄（節選）¶
以下路徑來自 SkillHub 安裝文檔，安裝時請替換爲你的環境實際目錄：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或項目下的 .windsurf/skills/ |
安裝後按你所用 Agent 的慣例重啓或刷新技能索引，使新 Skill 生效。
典型用法¶
本 Skill 以對話與項目上下文驅動，沒有單獨列出與業務無關的「Hello World」命令；典型用法是在已打開工程的前提下，用自然語言對齊 DataNexus 接入任務，讓助手按 Skill 內流程展開。
選型與接入開發
在對話中說明端型與目標，例如：「要在微信小程序裏接入 DataNexus，幫我選擇 SDK 類型並梳理 SDK 初始化步驟。」或：「生成 iOS SDK 接入代碼骨架，需要配置 user_action_set_id 和 secret_key。」
埋點與必報事件
例如：「按行爲清單補全 PURCHASE 和 REGISTER 的 action_type 埋點，並覈對必報事件是否齊全。」
聯調、對賬與質量
例如：「走一遍 SDK 接入流程裏的聯調和對賬，並對照 SDK 質量看板看事件覆蓋率。」
排錯
例如：「事件上報失敗，報錯裏有 code 51000 / data not valid，幫我排查 SDK 上報問題。」
自動化接入（Beta）與體檢
例如：「幫我自動接入 DataNexus JS SDK。」或：「對當前倉庫做一次 SDK 接入體檢 / audit。」
以上句式與官方簡介中的 Use when 列表一致；實際輸出仍依賴你倉庫裏的代碼結構與 DataNexus 控制台側配置，助手負責按 Skill 規範引導步驟而非替代官方控制台操作。
適用場景與注意¶
適合誰
- 正在或計劃接入 DataNexus 數據採集 SDK 的前端、客戶端、小遊戲 / 小程序開發者。
- 需要在多端（iOS、Android、鴻蒙、JS、小程序、小遊戲）之間統一接入話術與檢查項的團隊。
- 已接入但要做埋點質量、合規、覆蓋率復盤，或要對老項目做接入審計 / 體檢的工程。
使用上需注意
- 自動化接入爲 Beta：生成或改動代碼前應在版本管理中自行 review，並在測試環境完成聯調與對賬。
- 敏感配置：
secret_key、user_action_set_id、數據源 ID 等只應來自你的 DataNexus / 營銷側控制台，勿寫入公開倉庫；Skill 元數據標明requires_api_key=false指的是本 Skill 安裝項本身，不表示業務上報不需要密鑰。 - 數據以官方爲準：SkillHub 上該 Skill 評分與下載量會隨時間變化（頁面統計與商店列表可能不完全一致），接入行爲與事件定義仍以騰訊營銷 DataNexus 官方文檔與控制台爲準。
- 安裝路徑：務必
skillhub install ... --dir指向當前 IDE Agent 的 skills 目錄，避免裝到默認./skills/導致不生效。
結尾¶
「騰訊營銷 datanexus sdk 接入助手」把 DataNexus SDK 選型、接入開發、事件埋點、聯調對賬、質量評估、問題排查串成一條可在 AI IDE 裏執行的助手鍊路，並補充 Beta 級自動接入與接入體檢能力。若你正在處理 SDK 初始化、埋點、action_type 或上報報錯，可在安裝 @tencent-adm/datanexus-sdk-skills 後直接用語義明確的接入 / 審計訴求喚起該 Skill。
- SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/datanexus-sdk-skills
- 技能包地址：https://api.skillhub.cn/tencent-adm/datanexus-sdk-skills
- 安裝說明：https://skillhub.cn/install/skillhub.md
