SuperAPI AI 工具集

feedback

办公与效率

查看项目

更新于 10-20 01:49

技能介绍

Superset Feedback 技能用于帮助用户向 Superset 团队提交反馈,包括缺陷报告、功能请求或一般反馈。其核心目标是让报告简短、可扫描,便于 Superset 工程师快速分诊。

用途:

  • 在提交反馈前,先检索 Superset 文档,确认用户的问题或需求是否已有答案或已支持的功能。
  • 将用户输入(命令后的内容作为种子)整理为结构化报告:标题、摘要要点、复现步骤、预期与实际、调查线索等。
  • 按用户选择,私密提交给 Superset 团队或创建公开 GitHub issue。

主要能力:

  • 文档检索:使用 docs_search / docs_read(当 Superset docs MCP 工具可用时),否则抓取 https://docs.superset.sh/llms.txt 阅读相关页面,或限定在 docs.superset.sh 进行网络搜索。
  • 上下文收集:并行执行 superset --version、uname -sm、superset auth whoami、superset status --json,失败则跳过;版本检查通过 superset update --check --json 或 gh release download cli-latest -R superset-sh/superset -p version.txt -O - 获取最新版本。
  • 常见主机问题诊断:针对主机未注册、列表为空、自动化创建失败、终端无法连接、工作区缺失等,运行 doctor 技能快照(superset status、superset auth whoami、superset hosts list)并应用签名表;若已修复则无需报告。
  • 证据附件:仅缺陷报告且用户同意时,可附加截图或 --diagnostics 诊断包(包含版本、OS、应用日志与主机服务日志最后 200 行,总大小约 3 MB 以内)。
  • 报告分类与草稿:按用户措辞分类为 bug、feature 或 general;每个根问题一份报告,每个请求一份报告。标题格式为“<Surface>: <症状或需求>”,不超过 72 字符,不加“Bug:”或“Feature:”前缀。正文使用纯文本、分节标签、- 项目符号、编号步骤,不使用标题、粗体或表格。
  • 提交前询问发送方式:私密发送给 Superset 团队、创建公开 GitHub issue、先编辑草稿、取消。必须获得用户明确选择后才提交。
  • 私密提交:若 superset feedback --help 可用,则通过 stdin 提交:superset feedback submit --type <bug|feature|general> --title "..." --body-file=- <<'EOF' ... EOF;可附加 --attach 和/或 --diagnostics。若 CLI 缺失或未登录,则提供 mailto 链接和原始草稿。
  • 公开提交:先用 gh search issues -R superset-sh/superset "<关键词>" --limit 5 查重;若匹配则展示并建议评论;否则用 gh issue create 或打开预填表单 https://github.com/superset-sh/superset/issues/new?title=...&body=...。
  • 提交后确认:公开路径返回 issue URL;私密路径确认发送内容与收件方,并提醒同一问题的补充信息应回复抄送邮件,而非新建报告。

使用方式: 用户触发技能并提供反馈内容;技能先查文档,若已解决且用户未要求提交则停止;否则收集上下文、检查版本、诊断常见主机问题、可选收集证据、分类并起草报告;展示完整草稿后询问发送方式;按选择提交并确认。

适用场景:

  • 用户报告 Superset 桌面应用、CLI、终端、侧边栏、浏览器面板、工作区、自动化、更新器、移动端等组件的缺陷。
  • 用户提出新功能请求或一般性反馈。
  • 需要私密发送给团队或公开到 GitHub issue 的反馈流程。

限制:

  • 不包含仓库内容、终端输出或日志,除非用户明确同意。
  • 不提交含未回答检查项的报告。
  • 调查部分仅限用户或技能实际发现的线索,猜测需标注“Hypothesis:”,不得写入标题或摘要。
  • 标题不得使用“Follow-up:”、“ROOT CAUSE:”、“RETRACTION”等。
  • 私密路径正文为纯文本邮件,不使用标题、粗体或表格。
  • 附件总大小约 3 MB 以内。
  • 文档不可用或未找到答案时,不阻止提交,也不声称不存在答案。
  • 未提供的信息(如具体收费、平台支持范围等)暂未提供。