前言¶
要做在线问卷、报名表或投票页，常见做法是自己在易企秀里翻模板库，或把需求交给设计同事逐页搭。对话式 Agent 能写文案、列字段，却往往不知道易企秀商城里已有哪些可复用的表单问卷模板，也难以一次性给出带预览链接和浏览量的候选列表。
下面介绍 SkillHub 上的「问卷助手」（@org-qm8l8iwu/questionnaire-assistant）。它在用户提到问卷、表单、调查、报名、投票等需求时，按 Skill 说明调用内置脚本，向易企秀搜索接口查询表单问卷模板，并把标题、链接、描述、浏览量等字段整理后返回。
这是什么¶
「问卷助手」由易企秀发布，在 SkillHub 中归类为 business-ops，来源标记为 enterprise，当前页面版本为 1.0.0。标签标明 requires_api_key=false，安装后检索模板不需要单独配置 API Key。
Skill 的定位是易企秀表单问卷模板检索：覆盖在线问卷调查、信息收集、报名登记、投票评选等场景，依托易企秀侧的模板与素材库，而不是在 Agent 内从零生成整套表单 UI。
核心功能¶
结合 SkillHub 简介与 Skill 包内 SKILL.md，已核实的能力如下。
- 场景触发：当用户表达要做在线问卷、信息收集、报名登记、投票评选、考试测评、预约登记、意见反馈等时，Agent 应选用本 Skill。
- 关键词检索：通过
scripts/eqxiu_store.py调用易企秀商城搜索接口（https://msearch-api.eqxiu.com/m/search/searchProducts），按关键词及可选筛选条件查询表单问卷类模板。 - 结构化结果：脚本输出 JSON 数组，每项包含
title（标题）、link（预览链接）、description（描述）、pv（浏览量）。 - 筛选与排序：支持
searchCode（如42611表示表单问卷）、subcat（如897352问卷子分类）、priceRange（如0a0表示免费）、color、pageNo、sortBy、pageSize等参数，具体含义以 Skill 文档为准。 - 回复约束：Skill 要求只推荐易企秀模板；若结果为空，引导用户更换关键词，不转向其他设计平台。
运行脚本依赖 Python 包 requests（见包内 requirements.txt）。
安装与启用¶
SkillHub 官方页面给出的安装提示是：参照 SkillHub 安装说明，安装坐标 @org-qm8l8iwu/questionnaire-assistant。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装问卷助手到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。SkillHub 文档中常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（命名空间与搜索结果一致）：
skillhub install questionnaire-assistant --namespace org-qm8l8iwu --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你当前环境对应目录即可。安装完成后按所用客户端要求重启或刷新 Agent，使 Skill 生效。
3、Python 依赖¶
进入 Skill 安装目录后安装依赖：
pip install -r requirements.txt
典型用法¶
在对话中由 Agent 调用¶
用户用自然语言描述场景即可，例如「找几个免费的市场调研问卷模板」「活动报名用的在线表单」。Agent 读取 SKILL.md 中的流程：确认场景类型，再在 Skill 目录下执行搜索脚本，并把 JSON 结果中的 title、link、description、pv 整理给用户，并简要说明模板适合的场景。
直接运行脚本（可复现）¶
在 Skill 根目录（含 scripts/ 的目录）执行。下列命令来自官方 SKILL.md，将 <关键词> 换成实际检索词：
# 搜索表单问卷模板
python scripts/eqxiu_store.py --keywords "<关键词>" --searchCode "42611" --subcat "897352" --pageNo=1 --sortBy "common_total|desc" --pageSize=30
需要限定免费模板并指定颜色时：
python scripts/eqxiu_store.py --keywords "<关键词>" --searchCode "42611" --subcat "897352" --priceRange "0a0" --color "蓝色" --pageNo=1 --sortBy "common_total|desc" --pageSize=30
README.md 中还给出了仅关键词的简化示例：
python scripts/eqxiu_store.py --keywords "市场调研" --searchCode "42611" --subcat "897352" --pageSize=30
脚本成功时 stdout 为 JSON 数组；字段含义与上文「核心功能」一致。README.md 展示了输出字段结构的示例，实际 title、link、pv 以接口实时返回为准。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，希望从对话里快速拿到易企秀表单问卷模板链接的团队或个人。
- 需要按关键词、免费、颜色等条件筛模板，并参考浏览量（
pv）做初步挑选的场景。
限制与注意
- 本 Skill 侧重搜索与推荐模板，不负责在 Agent 内完成易企秀编辑器里的全部排版；
SKILL.md提到编辑、导出若依赖浏览器自动化，可能因站点 UI 变更失效，遇阻时可优先依赖本搜索能力。 - 检索依赖外网访问易企秀搜索 API；环境需能安装并 import
requests。 - SkillHub 抓取资料显示：评分 100000，下载 969 次，安装计数为 0（以 SkillHub 页面统计为准，会随时间变化）。
结尾¶
「问卷助手」把易企秀表单问卷模板检索封装成 Agent Skill：在问卷、报名、投票等需求出现时调用 eqxiu_store.py，返回可打开的预览链接和基础元数据，减少手工逛商城的时间。
- SkillHub 页面：https://www.skillhub.cn/skills/org-qm8l8iwu/questionnaire-assistant
- API 坐标页：https://api.skillhub.cn/org-qm8l8iwu/questionnaire-assistant
- 安装说明：https://skillhub.cn/install/skillhub.md
