功能定位
ravi-feedback 是 Ravi 平台官方提供的内置反馈通道，供用户（包括AI Agent）直接向产品开发团队提交各类反馈信息。
核心用法
该技能通过简单的 HTTP POST 请求将消息发送至 https://ravi.id/api/feedback/，支持两种调用方式：
- 快速反馈：仅提交
message字段，系统自动生成默认主题 - 定制主题：额外指定
subject字段，便于分类追踪
身份认证依赖 RAVI_ID_KEY 环境变量，反馈将关联至发送者的 Ravi 身份，支持团队直接邮件回复。
显著优点
1. 官方直达：绕过通用邮件系统，建立结构化、可追溯的产品反馈通道
2. 双向沟通：身份绑定机制使团队能够就反馈内容直接回复用户
3. 场景覆盖全面：明确支持 Bug 报告、功能请求、正面反馈、流程摩擦、文档困惑等多元场景
4. 零配置成本：无需额外注册或权限申请，依赖现有身份密钥即可使用
潜在局限
- 依赖平台生态：仅限 Ravi 平台内部使用，无法用于向其他服务商反馈
- 响应时效未承诺：文档未说明团队处理反馈的 SLA 或响应时间
- 反馈状态不可查：无 API 接口查询历史反馈的处理进度
- 无附件支持：仅支持纯文本消息，无法上传截图或日志文件
适合人群
- 频繁使用 Ravi 平台的开发者与自动化 Agent
- 希望直接影响产品路线图的早期用户
- 在自动化流程中发现平台问题的技术用户
常规风险
- 身份暴露：反馈与 Ravi 身份绑定，敏感场景需评估是否适合实名反馈
- 密钥泄露：
RAVI_ID_KEY若配置不当，可能被其他进程读取 - 信息边界模糊：文档强调「Do NOT use for general email sending」，存在误用风险
使用建议
建议在完成任何 Ravi 相关工作流后主动调用，形成「操作-反馈」闭环。对于复杂 Bug，建议在 message 中包含复现步骤与环境信息。