config-hermes/skills/formbricks/formbricks-survey-creation/SKILL.md

title, author, description, name

title	author	description	name
Formbricks Survey Creation Workflow	Hermes Agent	Complete workflow for creating Formbricks Link Survey questionnaires with API and browser fallback	formbricks-survey-creation

创建Formbricks问卷的工作流

触发条件

• 需要创建Formbricks Link Survey问卷
• 需要添加必填问题字段
• 需要设置欢迎页和结束页
• 需要获取分享链接

步骤

1. API端点测试

   • 测试GET /api/v1/management/surveys
   • 如果返回404，尝试GET /api/v1/management
   • 如果都失败，切换到浏览器工具

2. API认证

   • 使用x-api-key头进行认证
   • Bearer前缀无效，直接使用API Key
   • 测试认证: GET /api/v1/management

3. 创建问卷

   • 如果API可用: POST /api/v1/management/surveys
   • 如果API失败: 使用浏览器工具创建空白问卷

4. 配置Survey Type

   • 通过API: PATCH /api/v1/management/surveys/{id}
   • 通过UI: 找到Survey Type下拉菜单选择Link Survey

5. 添加问题

   • 通过API: POST /api/v1/management/questions
   • 通过UI: 点击Add Question按钮逐个添加

6. 设置欢迎页和结束页

   • 通过API: PATCH /api/v1/management/surveys/{id}
   • 通过UI: 找到相应设置页面

7. 获取分享链接

   • 通过API: GET /api/v1/management/surveys/{id}
   • 通过UI: 在问卷列表中找到分享链接

常见问题

• API端点404: 检查Base URL是否正确
• 认证401: 检查API Key格式和权限
• 浏览器工具导航: 可能跳转到其他标签页，需要重新定位
• questions格式: API要求严格的JSON结构

验证步骤

• 问卷类型是否为Link Survey
• 所有必填问题是否已添加
• 欢迎页和结束页内容是否正确
• 分享链接是否可访问
• 问卷是否已发布可用