技能介绍

解决的问题

问卷星平台的功能分散在网页后台：创建问卷、调整题型、发布状态、提交测试答卷、拉取结果、管理联系人和子账号，通常需要手动点选或拼 URL。对于 AI Agent 或自动化脚本来说，真正难点不是调接口，而是把自然语言需求翻译成问卷结构，并在返回数据中准确提取 vid、sid、分页总数、填写短路径等关键字段，避免把后台编号当成公开链接，或用单页数据冒充全量答卷。

核心能力

该技能封装问卷星 OpenAPI 的命令行工具，把常见业务动作组织成明确子命令：

建卷：优先使用 wjx survey create-by-json 和 JSONL 模板，先取 jsonl-template 再提交结构，减少旧字段 q_type、items 造成的兼容错误。
答卷：覆盖 response query、response submit、response report、response download，强调提交前使用 submit-template 校验题号，批量提交必须逐次核对结果。
查询与链接：通过 survey list 获取问卷分页总数和短路径字段，避免手工拼接 vid 生成填写地址；填写地址、编辑地址、建卷地址严格区分。
管理与分析：支持联系人、部门、管理员、子账号、标签等运营对象，并提供 NPS、CSAT、异常检测等本地分析命令。

适用边界

适合把问卷创建、测试提交、结果导出、联系人管理等流程交给 AI 执行的场景。使用时需要注意：API Key 缺失或过期会阻断鉴权操作；NPS、矩阵题、考试题型有固定 JSONL 字段；问卷类型 --type 不等于题目类型；列表和答卷查询必须按 total_count、page_index、page_size 判断是否取完，不能用表格输出替代 JSON 解析。