前言¶

在 Cursor、Claude Code 等環境裏做滿意度調查、考試投票或導出答卷時，常見做法是反覆查問卷星 OpenAPI 文檔，再手寫 curl 或零散腳本。題型字段、填寫鏈接、分頁總數、批量提交結果等細節容易踩坑，Agent 也容易把「生成了 JSONL」誤當成「已在平臺上建卷」。

下面介紹 SkillHub 上的 問卷星cli（座標 @user_f14cdb14/wjx-cli-use，當前版本 0.4.5）。它是一份面向 AI 的 wjx-cli 使用指南：把問卷星官方命令行工具的安裝、鑑權、JSONL 建卷、答卷查詢與分析等流程寫進 SKILL.md，並附帶分模塊參考文檔。Agent 在用戶提到問卷、調查、NPS、考試、投票等意圖時，應按 Skill 中的規則在後臺執行 wjx，而不是臨時拼湊接口調用。

這是什麼¶

問卷星cli 是社區來源（community）的 Agent Skill，發佈者爲 SkillHub 用戶 user_f14cdb14（展示名 wjxcom）。Skill 本身不替代 wjx-cli，而是教 Agent 如何正確使用 wjx-cli——問卷星 OpenAPI 的命令行封裝，命令形態爲 wjx <模塊> <操作> [選項]。

官方簡介寫明：覆蓋 15 個模塊、67 個子命令，用於創建問卷、查詢回覆、導出數據，以及 NPS/CSAT 分析、聯繫人/部門/子賬號管理等場景。SkillHub 分類爲 data-analysis，子類包括報表生成、數據洞察、用戶分析；標籤 requires_api_key=true，表示依賴問卷星 API Key（通訊錄等能力還需 WJX_CORP_ID）。

SkillHub 頁面統計（截至資料抓取）：下載約 10622 次，安裝記錄 20 次；評分字段在抓取資料中爲 100000（SkillHub 展示口徑，以頁面爲準）。

核心功能¶

以下內容均來自 Skill 包內 SKILL.md 與 SkillHub 簡介，按能力歸納。

觸發與路由¶

當用戶提到問卷、調查、收集、表單、投票、考試、測評、滿意度、NPS、問卷星、wjx、survey、questionnaire，或需要建卷、看回復、導出、分析 NPS/CSAT、管理聯繫人/部門/子賬號時，Agent 應加載本 Skill。簡介還提到 AI 主頁、AI 海報、AI PPT 等創建場景（通過 survey create-ai-page / update-ai-page）。

CLI 模塊（命令總覽）¶

Skill 中的命令總覽表列出主要模塊，例如：

user-system 在 Skill 中標記爲兼容維護、已過時，新項目不應主動走該路徑。

Agent 行爲約束（區別於「只會裝 CLI」）¶

Skill 用大量「規則」約束 Agent，避免常見生產事故，例如：

1. 建卷唯一入口：新問卷只能 wjx survey create --file <path>.jsonl；須先 wjx survey jsonl-template 取骨架，首行必須是問卷基礎信息。
2. 填寫鏈接：禁止用 vid 拼公開 URL；須使用 API 返回的 fill_url 或校驗後的 activity_domain + pc_path/mobile_path。
3. 列表與答卷分頁：機器處理須讀 JSON 裏的 total_count、page_index 等，不能把單頁結果說成「全部」；--format table 僅適合人工掃一眼。
4. 批量提交：每次 response submit 須檢查頂層 ok，彙總成功/失敗數，禁止口述未覈實條數。
5. 對用戶說話：默認用自然語言反饋結果，不堆砌 CLI 命令（用戶明確要求時例外）。

包內還有 references/ 下的問卷、答卷、通訊錄、分析、題型、公式、Node 安裝等 Markdown，供 Agent 按需展開子命令參數。

安裝與啓用¶

分兩層：Skill 裝進 Agent，以及 本機安裝 wjx-cli。二者都完成後，對話裏才能穩定走 wjx 命令。

1. 安裝 Skill（SkillHub）¶

SkillHub 安裝說明要求按官方文檔操作，並安裝座標 @user_f14cdb14/wjx-cli-use：

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_f14cdb14/wjx-cli-use。

若已安裝 SkillHub CLI，可將 Skill 安裝到當前 Agent 的 skills 目錄（目錄因產品而異，須用 --dir 指向可被識別的路徑）。文檔中的示例：

command -v skillhub && skillhub --version
skillhub install @user_f14cdb14/wjx-cli-use --dir <當前 Agent 的 skills 目錄>

常見路徑包括：Cursor 爲 ~/.cursor/skills/；Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下 .agents/skills/。也可從 SkillHub 頁面下載 wjx-cli-use-0.4.5.zip 解壓到對應目錄。

官方 Skill 地址：https://api.skillhub.cn/user_f14cdb14/wjx-cli-use
SkillHub 展示頁：https://www.skillhub.cn/skills/user_f14cdb14/wjx-cli-use

2. 安裝 wjx-cli（Node.js 環境）¶

Skill 要求 Node.js >= 20。就緒後安裝全局 CLI，並把 Skill 文件同步到 Agent（wjx skill install）：

node --version
npm install -g wjx-cli@latest
wjx skill install --force
wjx --version

說明：npm 包名爲 wjx-cli，安裝後的可執行命令是 wjx，不要用 wjx-cli --version 做驗收。Skill 內寫明兼容最低客戶端版本爲 0.4.1，低於該版本應先升級。

3. 配置 API Key¶

API Key 需用戶在瀏覽器中獲取，Agent 在拿到 Key 後執行初始化（勿在回覆中回顯完整 Key）：

wjx init --api-key <用戶提供的 key>

私有化部署時，獲取 Key 的域名與 --base-url 須一致，例如：

wjx init --api-key <key> --base-url https://<域名>

公網默認域名爲 www.wjx.cn；獲取鏈接形態爲：

https://<域名>/weixinlogin.aspx?redirecturl=%2Fnewwjx%2Fmanage%2Fuserinfo.aspx%3FshowApiKey%3D1

憑據優先級：--api-key > 環境變量 WJX_API_KEY > ~/.wjxrc。通訊錄相關操作另需配置 WJX_CORP_ID。

4. 驗證¶

wjx doctor

通過後可用列表做一次人工可讀驗收（Skill 強調：表格輸出不用於推斷總數或分頁）：

wjx survey list --format table

典型用法¶

以下示例來自 Skill 中的快速路由與核心工作流，可在配置好 Key 後復現。

用 JSONL 創建調查問卷¶

先生成模板，編輯後創建：

wjx survey jsonl-template --type 1 --raw > survey.jsonl
# 編輯 survey.jsonl
wjx survey create --file survey.jsonl

最小示例（每行一個 JSON 對象）：

{"qtype":"問卷基礎信息","title":"客戶滿意度調查","introduction":"感謝您的參與","atype":1}
{"qtype":"單選","title":"您對本次服務是否滿意？","select":["滿意","一般","不滿意"]}
{"qtype":"簡答題","title":"您還有什麼建議？"}

投票、考試、表單等須同時指定 --type（如投票 --type 3，考試 --type 6）並使用對應 qtype 名稱。

查看結果與導出¶

wjx survey list
wjx response report --vid <vid>
wjx response download --vid <vid>

下載格式可通過 --suffix 選擇 CSV（0）、SAV（1）、Word（2）等（詳見 Skill 內答卷參考文檔）。

本地 NPS 計算（示例）¶

wjx analytics nps --scores "[9,10,7,3]"

意圖到命令的對照（節選）¶

適用場景與注意¶

適合誰

• 已在用或計劃用 問卷星 OpenAPI / wjx-cli，希望 Agent 按同一套規範建卷、查數、導出，而不是每次重新讀長文檔。
• 需要 NPS/CSAT、子賬號與通訊錄等企業側能力，且能接受自行保管 API Key 與 Corp ID。
• 對話裏高頻出現問卷、考試、投票、滿意度等關鍵詞，希望自動命中 Skill 路由。

限制與注意

• 必須配置 API Key；Skill 要求遇到鑑權錯誤時停止業務操作並引導用戶重新配置，禁止僞造 Key。
• Node >= 20 與全局 wjx 可執行；僅安裝 Skill 而未裝 CLI 時，Agent 仍無法真正調 API。
• 創建問卷以 JSONL + survey create 爲準；只生成文件不執行命令不會在平臺上產生問卷。
• 填寫鏈接、分頁總數、批量提交結果等均有強制校驗邏輯，違背時 Skill 要求 Agent 如實報告而非猜測。
• Skill 爲社區發佈，與問卷星官方文檔、CLI 版本（SkillHub 頁 0.4.5，包內 front matter 曾寫 0.4.4）可能略有滯後，遇 UPGRADE_REQUIRED 應按服務端提示升級客戶端。

結尾¶

問卷星cli 把 wjx-cli 的安裝、鑑權、JSONL 建卷、答卷與分析、組織側命令以及 Agent 側防錯規則收斂成一份可加載的 Skill，適合把「問卷星相關」對話從臨時腳本升級爲可重複的操作規程。

官方入口：https://api.skillhub.cn/user_f14cdb14/wjx-cli-use