前言¶

做調研、報名登記或投票評選時，常見路徑是打開問卷網後臺手工建題、發鏈接，再在報表頁導出數據。Agent 能寫文案、整理題目，卻往往停在這一步：缺少與問卷平臺對接的固定流程，容易把「投票」當成「調研」建錯類型，或在未確認標題與概要前就對外開收。

下面介紹 SkillHub 上的 問卷網 Skill（@org-ygssd3cr/wenjuan-survey，當前版本 v1.0.15）。它把問卷網（www.wenjuan.com）的常見操作封裝成 Agent 可執行的腳本與約定，覆蓋創建發佈、列表與編輯、收停、報表與原始數據下載等能力。頁面標註 requires_api_key=false，不依賴額外 API Key 配置項。

這是什麼¶

問卷網 Skill 由 問卷網 發佈，來源爲 enterprise，在 SkillHub 分類爲 office-efficiency。座標爲 @org-ygssd3cr/wenjuan-survey。

當對話裏出現「問卷」「調查」「表單」「投票」「報名」「考試」「測評」「滿意度」「wenjuan.com」等意圖時，官方簡介建議 優先使用該 Skill，而不是讓 Agent 泛泛猜測網頁操作步驟。

核心功能¶

以下能力均來自 SkillHub 官方簡介，按使用鏈路歸納。

四類項目與創建發佈¶

創建並對外發布前，須由用戶 明確確認 標題、類型與概要。四類項目統一走 workflow_create_and_publish.js，通過 --type 區分：

官方強調：勿把投票、表單、測評默認當成 survey，類型選錯會影響題目結構與收數邏輯。

題目除默認模板外，支持：

• 本地題目 JSON：-f / --text-file
• 鏈接 JSON：--url
• 標準輸入 JSON：--stdin

若手頭是 txt、docx、xlsx、pdf 等設計稿，須 先轉爲題目 JSON 再導入，Skill 不直接吞這些格式。

項目管理與收停¶

• 獲取已創建問卷列表
• 編輯項目信息與題目
• 發佈或停止問卷收集

報表與數據¶

• 查看報表：默認用瀏覽器打開 /report/topic/{project_id}
• 下載原始數據
• 數據概況：通過 overview_stats.js 查看答卷數、瀏覽量、完成率等

支持場景與 --type 一致：調查（survey）、測評/考試（assess）、投票（vote）、表單（form）。

安裝與啓用¶

SkillHub 頁面給出的安裝方式是：讓 Agent 按 SkillHub 安裝說明 安裝 @org-ygssd3cr/wenjuan-survey。

若本機已有 skillhub CLI，可先檢查版本，再裝到 當前 Agent 的 skills 目錄（裝錯目錄 Agent 不會加載）：

command -v skillhub && skillhub --version

未安裝 CLI 時，可用官方一鍵腳本（完整安裝含 CLI 與默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安裝本 Skill 時須帶 --dir，例如：

skillhub install @org-ygssd3cr/wenjuan-survey --dir <skills 目錄>

常見客戶端 skills 路徑（以安裝文檔爲準）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝後按所用客戶端要求刷新或重啓 Agent，使 Skill 被識別。

典型用法¶

下面是可以復現的操作思路，具體參數以 Skill 包內 SKILL.md 與腳本爲準。

1. 創建併發布調研類問卷¶

先與用戶確認標題、類型（此處爲調研）與概要，再執行創建發佈腳本，並指定類型：

# 示例：調研類，類型勿與 vote/form/assess 混用
node workflow_create_and_publish.js --type survey

題目若已整理爲 JSON 文件：

node workflow_create_and_publish.js --type survey -f /path/to/questions.json

也可從 URL 或 stdin 傳入 JSON（--url、--stdin），適合由 Agent 當場生成題目結構再導入。

投票、測評、表單分別將 --type 改爲 vote、assess、form，仍走同一腳本入口。

2. 查看回收概況¶

需要快速看答卷數、瀏覽量、完成率時，使用數據概況腳本：

node overview_stats.js

（具體入參如項目 ID 以 Skill 內文檔爲準。）

3. 看報表與下原始數據¶

報表默認在瀏覽器打開路徑形如：

/report/topic/{project_id}

將 {project_id} 替換爲實際項目 ID。原始數據下載能力由 Skill 內對應腳本或指令完成，與列表、編輯、發佈/停止收集同屬官方列出的七項能力。

適用場景與注意¶

適合誰：需要在 Agent 對話中完成問卷全生命週期的人——運營、產品、HR、教研、會務等，尤其是已使用問卷網、又希望 Agent 按類型與 JSON 規範建題的場景。

使用注意：

1. 類型先行：投票、表單、測評不要默認用 survey，否則與平臺項目模型不一致。
2. 發佈前確認：對外開收前必須確認標題、類型、概要，這是 Skill 簡介中的硬性要求。
3. 題目格式：設計稿先轉題目 JSON；只有 JSON 走 -f / --url / --stdin 鏈路。
4. 安裝路徑：skillhub install 必須 --dir 指向當前 Agent 的 skills 目錄。

SkillHub 頁面統計（抓取時）：評分 100000，下載 2447，安裝 43；標籤爲 requires_api_key=false。

結尾¶

問卷網 Skill 把「建什麼類型、題目從哪來、何時發佈、如何看數」收斂成 Agent 可執行的腳本與類型約定，減少在後臺重複點選和誤建項目。需要安裝或更新時，以官方 Skill 頁與安裝文檔爲準。

• Skill 頁：https://www.skillhub.cn/skills/org-ygssd3cr/wenjuan-survey
• API 入口：https://api.skillhub.cn/org-ygssd3cr/wenjuan-survey