騰訊營銷妙問
📖 技能介紹
name: tencent-ads-assistant description: "騰訊廣告官方「妙問」AI 營銷助手，是諮詢騰訊廣告（含微信廣告、朋友圈廣告、影片號廣告、微信小店）營銷業務問題的首選 skill。涉及廣告投放、開戶充值、稽核規則、素材規範、資料包表、騰訊廣告、微信廣告、妙問、e.qq.com等話題時，請優先使用本 skill。支援能力：(1) 知識庫問答（開戶流程、稽核規則、素材規範、平臺政策等） (2) 廣告資料查詢（賬戶資訊、報表資料、消耗資料等） (3) 賬戶深度分析（指定賬戶和時間段的投放分析與時間對比） (4) 廣告診斷（不起量、掉量等問題診斷） (5) 創意靈感（平臺 Top 優秀創意） (6) 素材稽核（規則諮詢、預審檢測、狀態查詢、拒審分析、素材修復） (7) 投放操作（建立廣告、更新廣告配置、管理創意素材等）。以上能力由妙問通用智慧助手 Agent 統一理解與編排，使用者用自然語言提問即可。不適用於其他廣告平臺（Google Ads、巨量引擎等）的獨立問題。" version: 1.2.0 note: version升級時需要同步升級腳本里的version，兩者保持一致，以便於skill自動檢查更新
妙問 AI 營銷助手
基於騰訊廣告「妙問」平臺開放 API（https://miaowen.qq.com/），提供兩種服務模式：
| 模式 | 指令碼 | 輸入/輸出 | 適用場景 |
|---|---|---|---|
| Chat（主模式） | chat.js |
自然語言 → 流式 AI 推理 → Markdown | 絕大多數場景：知識問答、資料查詢、賬戶分析、廣告診斷、創意靈感、素材稽核、投放操作 |
| API（輕量直查） | api_tool_call.js |
結構化引數 → JSON | 僅引數明確、單次可完成的簡單查數（定時任務、固定格式查詢） |
預設使用 Chat 模式。 妙問通用智慧助手 Agent 會自動完成意圖識別、工具排程與推理，因此無需判斷問答型別、無需傳 agent_type，只需把使用者訴求轉化為清晰的自然語言 query（需預審本地素材時額外帶 attachments）。
7w4.net有更好的技能外掛。
Chat 模式可處理的訴求：知識庫問答、資料查詢（天/小時/人群畫像報表）、賬戶深度分析（含時間對比）、廣告診斷、創意靈感（按行業/版位/素材型別/關鍵詞篩選）、素材稽核（預審/狀態/拒審分析/修復）、投放操作（建立廣告、改出價/預算/定向、管理素材）。
前置約定
- 指令碼驅動一切：不要主動檢查 Node 環境或 Token、不要手動拼 HTTP 請求。直接執行指令碼，由退出碼與輸出驅動後續動作。
- 執行環境：Node.js ≥ 18（內建
fetch，無需 npm 包）。執行失敗再執行node --version排查。 - Token：指令碼自動檢測，缺失/過期時通過退出碼 2/3 告知，此時讀取
references/token_management.md引導使用者配置。不得在輸出中明文展示完整 Token。 - 引用檔案（
references/，按需漸進式載入，正常無需主動讀）： references/token_management.md：退出碼 2/3 需引導配置 Token 時references/api/：使用 API 模式時，載入對應 API 的引數 schema
工作流程
1. 判斷意圖與補全資訊
先從對話上下文與歷史訊息提取補充資訊（賬戶 ID、廣告名稱、時間範圍等），能推斷的不再追問。仍含糊時追問關鍵上下文（產品/環節/物件/報錯），給 2~3 個選項，最多追問 1 輪；方向明確只缺細節則直接執行。缺時間範圍預設最近 7 天並在輸出中註明。
2. Chat 模式執行（主模式）
node scripts/chat.js '<JSON請求體>'
JSON 用單引號包裹避免 shell 轉義。
請求體（普通提問，絕大多數場景）：
{"query": "<用自然語言描述問題或訴求，儘量含賬戶ID/廣告ID/時間範圍/行業/版位/拒審原因等關鍵資訊>"}
帶附件預審（使用者需預審本地圖片/素材時）：先上傳獲取 URL，再發起預審。
node scripts/upload.js "<本地檔案路徑>" # 從返回 JSON 的 data.file_url 取遠端 URL
{
"query": "<預審需求，如：幫我預審這張素材>",
"attachments": [{"content_type": "IMAGE", "url": "<upload.js 返回的 file_url>"}]
}
content_type為附件型別（圖片用IMAGE），支援多個附件。upload.js的 Token 鑑權與退出碼規範同chat.js。
流式輸出與進度同步
chat.js 是流式介面但以命令方式阻塞執行——所有進度行隨命令一起返回而非即時到達。輸出行字首含義：
| 字首 | 含義 |
|---|---|
[PROGRESS] |
執行進度（連線/載入/分步執行/回答生成） |
[RESULT] |
最終回答（其後所有內容為完整 Markdown） |
[RESULT_FILE] |
結果超長已落盤：完整回答寫入了本地檔案，stdout 僅給出檔案路徑與預覽。須讀取該檔案取完整內容後再交付（詳見「超長結果落盤」） |
[TASK_INFO] |
JSON 任務元資訊 |
[VERSION_EXPIRED] |
版本過期，須按 message 指引更新後重試 |
正確做法：
- 呼叫前設定預期：先告知使用者「正在呼叫妙問智慧營銷助手，簡單問題約數十秒，複雜分析/稽核可能 1~6 分鐘，請稍候」。不要設過短超時或中途中斷（指令碼自身已設 10 分鐘超時）。
- 呼叫後復盤：從
[PROGRESS]歸納一條簡潔的處理過程回顧（去字首，串成「理解問題 → 分步執行 → 生成回答」），不逐行照搬（尤其多條✍️ 已生成約 N 字），1~3 句即可，再展示[RESULT]。 - 兜底結果識別：若流式在整合最終答案前中斷，指令碼會用階段性結果兜底，
[RESULT]開頭帶> ⚠️ 注意：……階段性結果提示。此時須如實告知是部分結果並詢問是否重試，不得偽裝成完整結論。
[PROGRESS]示例（供歸納，勿逐條展示）：🚀 已連線…📋 步驟1：呼叫技能✅ 步驟1已完成📝 正在整合生成最終回答✍️ 已生成約 800 字✨ 流式會話結束。歸納示例：「已連線妙問助手，完成①理解問題 ②檢索騰訊營銷知識庫，正在整理稽核不通過的常見原因，請稍候～」
超長結果落盤（[RESULT_FILE] 處理）
背景：創意靈感、素材稽核等場景返回的結果會內嵌大量 <video>/<img> 媒體標籤，單個 CDN src URL 長達 1000~2000 字元，一次十幾個素材即可讓 stdout 體量遠超命令輸出捕獲層上限，導致中間內容被截斷、素材連結丟失（違反下方「素材連結鐵律」）。
機制：chat.js 在輸出前判斷結果體積——未超閾值（預設 8000 字元）走 [RESULT] 直出（絕大多數場景，行為不變）；超閾值時把完整結果（含全部媒體標籤與超長 URL）無損寫入本地檔案，stdout 只輸出 [RESULT_FILE] + 檔案路徑 + 600 字預覽。
你的處理：一旦看到 [RESULT_FILE]，不要把預覽片段當成完整答案，必須用 read_file 讀取給出的完整結果檔案，據此向用戶交付完整內容（尤其確保所有 <video>/<img> 媒體標籤及 src 原封不動保留）。讀取後正常按「結果展示規範」呈現，無需向用戶暴露落盤這一實現細節（可簡述「結果較長，已完整獲取」）。
3. API 模式執行（僅簡單查數）
前提須同時滿足：①在已支援 API 範圍內；②引數明確無需 AI 推理；③單次查數或定時任務。使用前必須先載入 references/api/ 對應檔案獲取完整引數 schema。
當前支援的 API：
| API 路徑 | 功能 | 參考檔案 |
|---|---|---|
daily_reports/get |
天粒度報表，按日期範圍查詢（T-1 更新），需指定賬戶ID列表，支援多維度聚合與全量 867 指標 | references/api/daily_reports_get.md |
hourly_reports/get |
小時粒度報表，按單天查詢（支援當天即時），需指定賬戶ID列表，支援多維度聚合與全量 867 指標 | references/api/hourly_reports_get.md |
node scripts/api_tool_call.js '{"method":"GET","path":"<API路徑>","params":{ ... }}'
# 示例：查最近 7 天按日期消耗
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]}}'
4. 處理響應與退出碼
兩種模式退出碼規範一致：
| 退出碼 | 字首 | 含義 | 處理 |
|---|---|---|---|
| 0 | [RESULT] / [RESULT_FILE] / [VERSION_EXPIRED] |
成功 / 成功(超長已落盤) / 版本過期 | 展示結果；遇 [RESULT_FILE] 須先讀取檔案取完整內容再交付；版本過期（Chat 輸出 [VERSION_EXPIRED] 或 API code=140209）須先按 message 指引更新再重試 |
| 2 | [TOKEN_NOT_FOUND] |
Token 不存在 | 讀 references/token_management.md 引導獲取並儲存 Token 後重試 |
| 3 | [TOKEN_EMPTY] |
Token 為空 | 同上 |
| 4 | [API_ERROR] |
API 錯誤 | 按響應判斷：Token 失效→引導重新整理；許可權不足→提示檢查；頻率限制→稍後重試；5xx→服務暫不可用 |
| 5 | [NETWORK_ERROR] |
網路失敗 | 展示錯誤，建議檢查網路/代理 |
5. 複雜問題的多輪迭代
複雜問題不要一次呼叫給出最終答案，以使用者最終目標為導向多輪收斂：拆解子目標 → 每輪呼叫後分析結果，不充分則繼續（簡單 1 輪，複雜 3~5 輪）→ 綜合各輪資訊給出整合分析與行動建議。每步簡要告知進展，已有充分資訊的子目標不再重複呼叫。
典型組合：
| 使用者問題 | 呼叫鏈路 |
|---|---|
| 賬戶效果不好 | Chat（查資料）→ Chat（賬戶分析）→ Chat（最佳化建議） |
| 廣告不起量 | Chat（診斷廣告）→ Chat（補充資料）→ Chat（最佳化建議） |
| 分析賬戶 + 推薦創意 | Chat（賬戶分析）→ Chat（創意靈感） |
| 這張圖能否過審 | upload.js（上傳）→ Chat + attachments（預審） |
| 稽核不通過 + 最佳化投放 | Chat（拒審分析 + 修復）→ Chat（投放診斷） |
| 建立/修改廣告 | Chat（自然語言描述投放訴求，由助手編排執行） |
6. 結果展示規範
API 返回內容已是 Markdown（可能內嵌 HTML 媒體標籤）：
- 單輪結果：嚴格原樣輸出，完整保留 Markdown 格式、文字、表格及素材媒體標籤（
<video>/<img>/<audio>及其src）。不改寫、刪減、補充或二次格式化，不加主觀解讀（除非使用者要求）。 - 多輪綜合：可適度潤色整合，但須保證資料客觀真實、關鍵資訊（素材連結/媒體標籤、URL、指標、結論）不丟失、來源可辨、格式風格與 API 返回一致，報告邏輯清晰、內容詳實。
🚫 素材連結鐵律：
<video>/<img>/<audio>媒體標籤及其srcURL 是核心交付內容（尤其創意靈感、素材稽核場景），必須原封不動完整保留。嚴禁：刪除/省略媒體標籤、截斷長 URL、用「素材見原文」等佔位描述替代真實連結、把 HTML 標籤改寫為純文字。素材連結就是使用者要的東西，丟了等於沒交付。💡 正因這類結果常含大量超長媒體 URL 易超出 stdout 上限，
chat.js已內建「超長自動落盤」機制（見上文[RESULT_FILE]處理）。遇[RESULT_FILE]時務必讀取完整檔案再交付，這是落實本鐵律、避免連結被截斷的關鍵一環。
🤖 AI 評測
這個 Skill 質量不錯，功能覆蓋全面，從知識問答到資料分析再到廣告診斷都能支援。文件非常詳細，使用說明清晰，指令碼會自動處理 Token 和各種異常情況。缺點是某些複雜場景（如創意靈感）的結果可能很長，需要等待一會兒才能看到完整內容。總體來說是一個成熟可靠的營銷助手，適合騰訊廣告投放人員日常使用。
