前言¶

在 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