前言¶
做调研、报名登记或投票评选时,常见路径是打开问卷网后台手工建题、发链接,再在报表页导出数据。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 区分:
--type |
场景 |
|---|---|
survey |
调研 |
assess |
测评 / 打分测验 / 考试 |
vote |
投票 / 评选 |
form |
表单 / 报名登记 |
官方强调:勿把投票、表单、测评默认当成 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 规范建题的场景。
使用注意:
- 类型先行:投票、表单、测评不要默认用
survey,否则与平台项目模型不一致。 - 发布前确认:对外开收前必须确认标题、类型、概要,这是 Skill 简介中的硬性要求。
- 题目格式:设计稿先转题目 JSON;只有 JSON 走
-f/--url/--stdin链路。 - 安装路径:
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