用途
该技能用于把用户对 Spotify Portal CLI 的反馈提交给 Portal 团队。它面向的是 CLI 使用体验本身,包括命令、参数、输出、认证流程以及相关插件工作流。
何时提供
在以下情况可以主动提供一次反馈入口:
- 用户明确要求发送关于 Portal CLI 的反馈。
- 用户在会话中对 Portal CLI 或其工作流表达出明确的印象、抱怨、建议或称赞。
只提供一次,不要反复打扰。
范围限制
反馈范围限于 CLI 体验:命令、参数、输出、认证流程以及相关插件工作流。不要提交以下内容:Portal 产品 UI 的反馈、需要回复的缺陷报告、支持请求,或其他工具的反馈。
提交方式
通过以下命令提交:
npx @spotify/portal-cli actions telemetry:submit-feedback --text "<feedback>" --source cli --json
提交流程
- 未经用户明确确认,绝不提交。先展示将要发送的确切文本,询问后再调用该操作。
- 将用户反馈原样作为 --text 传入,不要总结、修饰或翻译。
- 不要在文本中包含密钥、令牌、个人数据或内部 URL。如果用户措辞中包含这些内容,请让用户改写,而不是静默编辑。
- 保持 --source cli。当已知已安装的 @spotify/portal-cli 版本时,传入 --client-version。
- 向用户确认结果:返回 {"submitted": true} 表示反馈已送达。
预期说明
这是一个单向通道:不会收到回复,也不会创建工单。对于需要答复的问题,请引导用户联系其 Portal 支持联系人。
退出码 2 表示 CLI 未认证:让用户运行 portal-cli auth login,然后重试。