問卷助手:在 Agent 中檢索易企秀表單問卷模板

前言

要做在線問卷、報名表或投票頁,常見做法是自己在易企秀裏翻模板庫,或把需求交給設計同事逐頁搭。對話式 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,已覈實的能力如下。

  1. 場景觸發:當用戶表達要做在線問卷、信息收集、報名登記、投票評選、考試測評、預約登記、意見反饋等時,Agent 應選用本 Skill。
  2. 關鍵詞檢索:通過 scripts/eqxiu_store.py 調用易企秀商城搜索接口(https://msearch-api.eqxiu.com/m/search/searchProducts),按關鍵詞及可選篩選條件查詢表單問卷類模板。
  3. 結構化結果:腳本輸出 JSON 數組,每項包含 title(標題)、link(預覽鏈接)、description(描述)、pv(瀏覽量)。
  4. 篩選與排序:支持 searchCode(如 42611 表示表單問卷)、subcat(如 897352 問卷子分類)、priceRange(如 0a0 表示免費)、color、pageNo、sortBy、pageSize 等參數,具體含義以 Skill 文檔爲準。
  5. 回覆約束: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
羽毛球分组比赛记分
小程序二维码

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

小夜