前言¶
在 Cursor、Claude Code 等環境裏做投放相關問答時，常見做法是讓模型憑公開資料「猜」開戶流程、審覈口徑或報表字段，既容易過時，也無法落到你自己的賬戶數據。騰訊廣告側已有「妙問」這類面向營銷場景的 AI 助手；若能把同一套能力以 Skill 形式裝進 Agent，就可以在對話裏用自然語言查規則、拉報表、做診斷，而不必每次手動打開 e.qq.com 或妙問網頁。
下面介紹 SkillHub 上的 騰訊營銷妙問（座標 @clawhub_yishuang07/tencent-ads-assistant），以及如何在本地安裝與典型提問方式。
這是什麼¶
騰訊營銷妙問 是騰訊廣告官方「妙問」AI 營銷助手對應的 Agent Skill。發佈方標註爲「騰訊營銷妙問」，來源爲 enterprise，當前 SkillHub 版本爲 1.0.7，分類爲 business-ops。Skill 通過妙問開放能力（平臺入口 miaowen.qq.com）對接後臺服務，由妙問側 Agent 理解自然語言並編排具體能力。
適用話題包括：廣告投放、開戶充值、審覈規則、素材規範、數據報表、騰訊廣告 / 微信廣告、妙問、e.qq.com 等。不適用於 Google Ads、巨量引擎等其他廣告平臺的獨立問題。
SkillHub 頁面標註 requires_api_key=true，實際使用需按 Skill 內指引配置妙問 Token（腳本會在缺失或失效時通過退出碼提示，詳見 Skill 自帶的 references/token_management.md）。
核心功能¶
以下能力與上游 Skill 文檔一致，由 Chat 模式下的不同 agent_type 或默認問答路由區分；複雜任務可由 Agent 多輪組合調用。
- 普通知識庫問答：開戶流程、審覈規則、素材規範、平臺政策等，不傳
agent_type。 - 廣告數據查詢（
DATA_QUERY）：賬戶信息、報表與消耗等，支持在agent_params.account_id_list中限定賬戶範圍。 - 賬戶深度分析（
ACCOUNT_ANALYSE）：指定賬戶與時間段投放分析，並可配置對比時間段。 - 廣告診斷（
DIAGNOSE）：針對不起量、掉量等問題，需賬戶 ID 與廣告 ID。 - 創意靈感（
CREATIVE_INSPIRATION）：按行業、版位、素材類型、關鍵詞等查看平臺優秀創意參考。 - 素材審覈（
AUDIT）：規則諮詢、預審檢測、狀態查詢、拒審分析、素材修復；本地圖片可先經upload.js上傳再帶attachments預審。
除 Chat 模式外，Skill 還提供 API 模式（api_tool_call.js），適合參數明確、單次查數的場景，當前文檔列出的結構化接口包括 daily_reports/get（天粒度報表）與 hourly_reports/get（小時粒度報表）。運行環境要求 Node.js ≥ 18。
安裝與啓用¶
通過 SkillHub 安裝（推薦國內環境）¶
SkillHub 技能頁給出的安裝提示爲：依據 SkillHub 安裝說明 安裝本技能。核心步驟如下。
- 確認是否已安裝
skillhubCLI：
command -v skillhub && skillhub --version
未安裝時可執行官方一鍵腳本（完整安裝或僅 CLI，以安裝頁爲準）。
- 將技能安裝到當前 Agent 正在使用的 skills 目錄（未指定
--dir時默認./skills/，Agent 可能無法加載）：
skillhub install @clawhub_yishuang07/tencent-ads-assistant --dir <你的 skills 目錄>
常見路徑示例（以安裝頁列舉爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝或更新後，按你所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
通過 ClawHub / OpenClaw 安裝¶
上游倉庫頁面提供的命令爲：
openclaw skills install @yishuang07/tencent-ads-assistant
座標在 SkillHub 側爲 @clawhub_yishuang07/tencent-ads-assistant，與 ClawHub 的 @yishuang07/tencent-ads-assistant 指向同一套技能內容，按你環境選用的包管理器擇一即可。
Token 配置¶
不要預先在對話裏反覆檢查 Token；直接調用 Skill 腳本即可。若退出碼爲 2（TOKEN_NOT_FOUND）或 3（TOKEN_EMPTY），讀取 Skill 內 references/token_management.md，按指引讓用戶完成 Token 獲取與保存後重試。不得在 Agent 輸出中明文展示完整 Token。
典型用法¶
日常在 Agent 中啓用本 Skill 後，用自然語言描述需求即可；Agent 應按 Skill 說明選擇 Chat 或 API 模式。下面示例來自官方文檔，便於對照腳本入參。
自然語言（由 Agent 路由）¶
在對話中可直接提問，例如：
- 「朋友圈素材有哪些尺寸規範？」
- 「幫我查最近 7 天各賬戶消耗」
- 「賬戶 123456789 最近一週投放效果，並和上一週對比」
- 「廣告 987654 不起量，幫我診斷」
- 「電商行業微信朋友圈圖片類 Top 創意有哪些參考？」
- 「這條拒審文案可能違反哪條規則，怎麼改？」
Agent 應據意圖選擇普通問答或對應 agent_type，必要時追問賬戶 ID、時間範圍等，缺省分析週期常見默認爲最近 7 天並在結果中註明。
Chat 模式（腳本直調）¶
知識庫問答：
node scripts/chat.js '{"query": "開戶需要準備哪些資質？"}'
數據查詢：
node scripts/chat.js '{"query": "查最近7天按賬戶彙總的消耗","agent_type":"DATA_QUERY","agent_params":{"account_id_list":[123456789]}}'
素材預審（先上傳再帶附件）：
node scripts/upload.js "/path/to/creative.png"
node scripts/chat.js '{"query":"幫我預審這張素材","agent_type":"AUDIT","attachments":[{"content_type":"IMAGE","url":"<upload.js 返回的 data.file_url>"}]}'
API 模式（固定報表查詢）¶
天粒度示例：
node scripts/api_tool_call.js '{"method":"GET","path":"daily_reports/get","params":{"begin":"2026-04-02","end":"2026-04-08","group_by_type":"DATE","fields":["cost"],"page_size":7,"account_id_list":[2345678]}}'
小時粒度示例：
node scripts/api_tool_call.js '{"method":"GET","path":"hourly_reports/get","params":{"date":"2026-04-09","group_by_type":"HOUR","fields":["cost","hour"],"page_size":24,"account_id_list":[2345678]}}'
調用 API 模式前，應先加載 references/api/ 下對應文件的參數 schema。若 Chat 返回 JSON 中 code 爲 140209，表示 Skill 版本過期，需按 message 指引升級後重試。
適用場景與注意¶
適合誰：在騰訊廣告體系內投放的團隊、代運營、以及需要在 IDE 裏把「問規則 + 查自己賬戶數據 + 診斷 / 審覈」串在一起的開發者或運營人員。
使用注意：
- 能力與數據範圍以騰訊廣告 / 妙問爲準，勿用於其他廣告平臺的主流程。
- Chat 模式返回的 Markdown 在單輪場景下應原樣呈現，避免改寫指標或結論；多輪綜合分析時可整合，但不得篡改數據。
- API 模式僅適合已文檔化的簡單查數；複雜分析仍應走 Chat 與多 Agent 組合（例如「數據查詢 → 賬戶分析 → 知識庫解讀」）。
- SkillHub 統計（截至頁面展示）：評分 100000，下載約 17535 次；安裝與版本以 SkillHub 技能頁爲準。
結尾¶
若你的工作流已經圍繞 Cursor 或同類 Agent 展開，騰訊營銷妙問 把官方妙問的知識庫、數據查詢、分析、診斷、創意與審覈能力收斂進一個 Skill，減少「網頁 + 表格 + 再問一次模型」的割裂。安裝與座標以 SkillHub 爲準：
