wjx-cli-use

Name: wjx-cli-use
Author: orzwq

Description

Guide for using wjx-cli (Wenjuanxing CLI) to create surveys, query responses, and analyze data. Use when the user mentions: 问卷, 调查, 收集, 表单, 投票, 考试, 测评, 满意度,...

Usage Guidance

This skill is a coherent, detailed guide for wjx-cli, but it instructs the agent to perform system installs and to obtain and use your WJX API Key (and optionally a WJX_CORP_ID). Consider the following before installing/using: - Only provide an API Key if you trust the skill and the agent; avoid pasting long-lived root keys into chat. Prefer creating a limited-scope or sub-account API key for automation. - The skill will try to run npm install -g wjx-cli and write ~/.wjxrc via wjx init; if you don't want the agent to run commands, perform installs and the wjx init step yourself and then give the agent explicit, minimal permission. - The skill metadata does not declare required env vars, yet the instructions use WJX_API_KEY and WJX_CORP_ID — this mismatch is why extra caution is warranted. - If you allow the agent to run the setup, watch for prompts that request secrets and prefer setting credentials via environment variables or uploading them to a secure vault rather than pasting into chat. - If uncertain, run the provided setup.sh manually on a controlled machine and inspect its output before giving the agent any credentials or permission to execute commands.

Capability Analysis

Type: OpenClaw Skill Name: wjx-cli-use Version: 0.3.2 The skill bundle provides a legitimate and well-documented interface for the Wenjuanxing (wjx.cn) survey platform via the `wjx-cli` tool. It includes a setup script (setup.sh) that automates the installation of the official npm package and guides users through API key configuration on the official website. The instructions in SKILL.md are focused on ensuring the AI agent uses the tool correctly and provides a good user experience, with no evidence of malicious intent, data exfiltration, or harmful prompt injection.

Capability Tags

requires-sensitive-credentials

Capability Assessment

✓ Purpose & Capability

Name/description match the contents: SKILL.md, references, and examples all document wjx-cli usage (create surveys, responses, analytics, contacts). The included scripts (setup.sh, pack_skill.sh) and reference docs are coherent with a CLI usage/install guide.

⚠ Instruction Scope

SKILL.md explicitly instructs the AI agent to run system commands (install Node.js, npm install -g wjx-cli, wjx init, wjx doctor, open browser links) and to request the user's API Key and then run wjx init --api-key <key> itself. The instructions also reference environment/config locations (~/.wjxrc) and a second credential (WJX_CORP_ID) for contacts. Those runtime actions go beyond passive guidance and give the agent permission to perform system-level installs and to solicit and use secrets.

ℹ Install Mechanism

There is no declared install spec (instruction-only), but repository includes setup.sh which automates Node.js detection and runs npm install -g wjx-cli (and suggests sudo). Node install guidance uses standard nodesource/nvm/homebrew commands. No downloads from untrusted/personal URLs are present; install steps are conventional but run-at-runtime behavior is enabled by the instructions.

⚠ Credentials

Skill metadata declares no required env vars or primary credential, yet the SKILL.md and scripts explicitly reference/configure WJX_API_KEY (and recommend wjx init and ~/.wjxrc) and optionally WJX_CORP_ID for contacts. The skill also instructs the agent to ask the user to paste their API key into chat so the agent can run wjx init with it. This is a mismatch and increases the risk of credential exposure if the user pastes secrets into the conversation or lets the agent run commands with those secrets.

✓ Persistence & Privilege

Skill is not flagged always:true and does not request system-wide persistent privileges. The setup writes/uses ~/.wjxrc (normal for a CLI) and installs a global npm package — these are expected for a CLI integration. It does not attempt to modify other skills or agent-wide configuration beyond its own configuration steps.

Version History

v0.3.2

Version 0.3.2 - 增加“规则 5”：遇到 API Key 相关错误时，必须用自然语言提醒用户获取并配置 API Key，暂停业务操作，指明下一步，并在配置后继续原任务 - 常见错误与处理表格同步强化，强调未配/错误 API Key 时应停止业务并主动提醒用户配 Key，不仅复述错误 - 明确要求 AI 直接执行配置，除非用户要求，不让用户手动输入命令 - 用户提醒增加自然语言举例，指导用户获取并提供 API Key - 不涉及功能逻辑或命令参数变更，仅优化 API Key 异常处理体验

v0.3.1

**Major update: Strong enforcement of JSONL format for survey creation, stricter workflow rules, and clarified best practices.** - 强制所有问卷/投票/考试/表单创建统一用 `create-by-json` + JSONL 格式，全面禁止自动用 `create-by-text`（DSL），新增“规则 0”详细说明原因与例外情况。 - 明确 JSONL 各题型写法：题目 `title` 只写正文、投票题用 `qtype:"投票单选"`/`qtype:"投票多选"`、表格题标准组合方式等，严格写法指引。 - 新增“规则 5”：发布与提交答卷的易错点，包括状态参数、版本号注入、submit-template 用法、矩阵题数据格式和 shell 转义陷阱等。 - 指出 DSL 覆盖题型有限、容易被 shell 破坏，并标记 `create-by-text` 为弃用命令，仅在用户明确要求时

v0.2.3

**wjx-cli-use 0.2.3** — Major update with a unified, JSONL-based survey creation workflow. - 默认问卷创建方式切换为 `wjx survey create-by-json`，统一使用 JSONL 格式，支持 70+ 题型。 - 弃用文本 DSL (`create-by-text`) 和老 JSON 数组创建 (`create --questions`)，仅为兼容保留。 - 快速路由、核心工作流说明已同步为 JSONL 格式写法，适配新命令。 - 子命令统计：覆盖 67 个子命令（原为 69）。 - 参考文件和用法示例更新，标注 DSL 仅供历史代码参考。

v0.1.21

Version 0.1.21 - Major content and guideline update to SKILL.md, including stricter AI agent usage rules and natural language reply requirements. - Added 7 new files: three example survey DSL texts, packaging and setup scripts (pack_skill.sh, setup.sh), package.json, and a detailed Node.js installation guide (references/install-nodejs.md). - Improved survey creation guidance: clarified survey types, question types, and provided common error troubleshooting. - Enhanced installation instructions for Node.js and wjx-cli, including steps for API Key configuration. - Updated command overview to match latest CLI functions (now 69 subcommands in 15 modules). - Emphasized that AI should never display CLI commands to users unless directly asked.

v1.0.0

- First release of wjx-cli-use! - Provides a comprehensive CLI guide for Wenjuanxing, covering 69 subcommands across 15 modules. - Includes installation, configuration, command reference, and core workflows for creating surveys, querying responses, managing contacts, and local analytics. - Detailed usage examples, common parameter values, and links to further reference documentation.

Metadata

Slug wjx-cli-use

Version 0.3.2

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 5

Frequently Asked Questions

What is wjx-cli-use?

Guide for using wjx-cli (Wenjuanxing CLI) to create surveys, query responses, and analyze data. Use when the user mentions: 问卷, 调查, 收集, 表单, 投票, 考试, 测评, 满意度,... It is an AI Agent Skill for Claude Code / OpenClaw, with 214 downloads so far.

How do I install wjx-cli-use?

Run "/install wjx-cli-use" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is wjx-cli-use free?

Yes, wjx-cli-use is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does wjx-cli-use support?

wjx-cli-use is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created wjx-cli-use?

It is built and maintained by orzwq (@orzwq); the current version is v0.3.2.

More Skills

What is wjx-cli-use?

How do I install wjx-cli-use?

Is wjx-cli-use free?

Which platforms does wjx-cli-use support?

Who created wjx-cli-use?

💬 Comments