SuperAPI AI 工具集

volcengine-feedback

通用与其它

查看项目

更新于 10-19 16:17

技能介绍

用途

volcengine-feedback 用于帮助用户分享使用智能体管理云服务的实际经验,包括使用收益、遇到的困难,以及希望获得的能力。用户只需简述场景即可;是否附上诊断结论或实现方案由用户自行决定。反馈的目标位置是 GitHub 上的 volcengine/volcengine-skills 仓库。

主要能力

  • 从对话上下文中推断反馈类别(技能问题、能力请求、场景需求或成功案例),并生成标题和正文;正文尽量复用用户原句和相关对话。
  • 展示一份简短预览,其中包含 [Feedback] 标题以及说明目标、经验和期望变化的段落;只有在已有脱敏证据有助于理解时,才补充“详细信息”。
  • 发布前进行脱敏审查:移除 AK/SK、令牌、cookie、授权头、签名 URL、密码、个人或客户数据、私有端点、本地绝对路径和机密业务内容;账号 ID 替换为 <account-id>,资源 ID 替换为保留前缀的形式,真实 TRN 替换为 <resource-trn>;标题、截图和附件也同样检查。
  • 提供发布决定:用户可以发送、修改,或先留作草稿。起草请求本身不构成发布授权;如果已有明确授权覆盖这份确切内容和目标位置,则沿用该授权。
  • 提交后,如果通过返回 URL 或读取结果验证成功,就简要确认贡献并返回 issue 链接;如果只生成草稿、无法访问 GitHub 或明确提交失败,则标记“未提交”,并返回可复制的草稿和表单链接;如果创建超时但可能已经成功,就先检查是否存在匹配的 issue,无法确认时标记“提交未确认”,保留草稿并停止本次尝试,以避免重复提交。

使用方式

用户可以说“我希望反馈使用中遇到的问题:……”或“分享本次成功部署的实践”,也可以在其宿主环境中调用 volcengine-feedback。该技能不提供原生的 /feedback 或 ve feedback 命令,应使用宿主实际提供的技能调用方式。

交互遵循“一句话 → 一次预览 → 一个结果”:先根据上下文起草,只在完全没有可用经验可描述时询问一个简短问题,否则省略缺失细节;然后展示一份紧凑预览,并说明反馈将公开发布到 volcengine/volcengine-skills,同时提醒用户检查敏感信息、遵守反馈约定;最后询问是否发布。

发布环节使用可用的、已获授权的 GitHub 集成或浏览器执行。没有强制要求的可执行文件或环境变量依赖。表单中的公开分享指引仅供参考,没有勾选框或额外同意步骤。仍然需要针对确切内容和公开发布获得授权。不要求搜索 issue;如果已知匹配的 issue 或用户要求查找,只使用已脱敏的关键词进行搜索;在已有讨论串中评论同样需要针对该目标的授权。

适用场景

  • 使用智能体管理云服务时遇到技能问题,希望报告问题。
  • 希望请求新增能力或提出云场景需求。
  • 希望分享一次成功部署或使用的实践。
  • 在授权前提下,希望将脱敏后的反馈提交到公开 GitHub 仓库。

限制与注意

  • 反馈属于可选的附带任务,不能妨碍主要任务:出现错误或结果不完整时,这最多只是提供一个可选邀请,绝不代表允许发布;应先继续已获授权的诊断、恢复和剩余工作。反馈邀请应在自然总结时提及,每次对话最多一次;如果用户拒绝、忽略或此前已提供过,就不再重复提醒。常规成功不需要主动征求反馈。
  • 主动邀请只用一句简短的话并附上表单链接,不要为了邀请而等待回答,也不要开始起草、搜索 issue、收集日志、安装工具或技能、登录或打开浏览器。
  • 用户要求反馈后,将其作为可选附带任务处理;缺少细节、无法访问 GitHub、用户拒绝发布或提交失败,都不应成为继续云上工作的前提。草稿保留在对话中,然后继续剩余工作。不要为了获取反馈证据而重复云上变更或复现事故。
  • 不要编造根本原因、结果、节省的时间或维护者承诺;版本、复现步骤、日志和单独的情绪评分都不是必需的。
  • 对于正在发生的事故,应继续排查或联系官方支持;公开 issue 不承诺响应时间或解决结果。
  • 安全漏洞或疑似凭证泄露应通过项目可用的私密安全报告渠道或火山引擎官方支持处理,不应提交到公开 issue;不要编造私密联系方式,也不上传漏洞细节。
  • 应遵守 GitHub 社区准则,聚焦事实、证据和影响;如果草稿含有攻击性内容,可以提供保留核心关切的事实性改写,但不要发布攻击性文本。
  • 如果无法安全脱敏,就省略该细节;不要为此检查凭证存储或收集更多云数据。