问卷网 Skill:在 Agent 里完成问卷创建、发布与数据回收

前言

做调研、报名登记或投票评选时,常见路径是打开问卷网后台手工建题、发链接,再在报表页导出数据。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 规范建题的场景。

使用注意:

  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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜