SuperAPI AI 工具集

detect-support-requests

办公与效率

查看项目

更新于 10-16 08:19

技能介绍

用途

Detect Support Requests Posted as Feature Requests 用于帮助 WooCommerce Marketplace 团队成员识别并关闭那些实际上是支持问题的功能请求(FR)。这类请求通常涉及店铺特定问题、故障排查、设置帮助或错误报告,而非真正的功能诉求。该技能的目标是将这些用户重新引导至 WooCommerce 支持团队。

主要能力

  1. 解析产品:按照共享规则文件 RESOLVE_PRODUCT.md 确定目标产品。

  2. 获取全部开放功能请求:调用 wccom-feature-requests-list,参数为 product_id、status: "publish"、per_page: 100,并持续分页直到某页返回少于 100 条。收集 id、title、description、status、votes、date、url 字段。如果第一页返回 0 条结果,则停止并报告“未找到该产品的开放功能请求”。

  3. 识别支持请求:根据以下模式判断某条请求是否为支持请求:

    • 个人化/店铺特定语言,如“我无法在我的店铺/结账/站点上让 X 正常工作”“当我做 Y 时,它对我报错”。
    • 故障排查/操作指导,如“我该如何配置……?”“为什么 X 没有显示?”“更新后它停止工作了”。
    • 伪装成功能请求的错误报告,如“请修复 X”,而 X 实际已存在但在其环境中损坏。
    • 设置/安装帮助:关于激活、连接或迁移数据的问题。
    • 存在诊断信息:错误消息、后台错误截图、对其站点上特定订单/产品的引用。
    • 直接向团队提问,如“你能帮我吗?”“我在哪里更改设置?”,并以“谢谢!”或“请帮忙。”结尾。

    以下情况不视为支持请求(保持不变):请求新功能、增强功能或集成;描述能让其他商户受益的工作流改进;使用产品级语言(“添加对 X 的支持”“如果插件能 Y 就太好了”)而非店铺级语言。

    判断应保持保守,仅在支持性质明确时才标记。每条标记记录需分配置信度(High / Low)。

  4. 标记记录结构:

    { "id": <int>, "title": "<str>", "url": "<str>",
      "reason": "<one sentence>", "confidence": "High" | "Low",
      "excerpt": "<first 1–3 sentences of description, trimmed>" }
    
  5. 展示报告:按 DISPLAY.md 分页规则展示,解码 HTML 实体,并按 RULES.md 翻译非英文摘录。每条报告包含 ID、标题、置信度、原因、投票数、开启日期、URL 和摘录。最后汇总:扫描了 X 条开放请求 · Y 条疑似支持请求(Z 条高置信度,W 条低置信度)。若无标记则报告并停止。

  6. 确认菜单:列出被标记的请求,用户可通过编号、A(全部)、H(仅高置信度)、N(跳过)进行选择。等待用户回复后才执行操作。

  7. 预览评论:以纯文本展示将要发布的评论全文,询问“发布这些评论并关闭请求?(Y / N)”,等待确认;若为 N 则中止。

  8. 关闭已批准的请求:对每个已批准请求,依次:

    • 通过 wccom-feature-requests-comment 发布关闭评论,内容为:

      Hey there! Thank you for getting in touch. This looks like a support question, rather than a feature request. To get help with this, I encourage you to get in touch with our support team at: https://woocommerce.com/my-account/contact-support/.

    • 通过 wccom-feature-requests-update-status 将状态更新为 "closed"。

    写入失败处理:若任一调用失败,不将该请求记为已处理,在摘要中报告失败并继续下一个。若评论已发布但状态更新失败,需注明半完成状态,需手动清理。

  9. 确认摘要:逐条列出已关闭和失败的请求,最后汇总:关闭 N 条支持请求 · 失败 F 条。然后遵循 PHASE_LOOP.md。

使用方式

该技能依赖若干共享规则文件(RULES.md、DISPLAY.md、PHASE_LOOP.md、RESOLVE_PRODUCT.md),并调用 wccom-feature-requests-list、wccom-feature-requests-comment、wccom-feature-requests-update-status 等工具。它支持被编排器(orchestrator)调用,此时跳过获取步骤,直接从 input_path 读取 JSONL 格式的 FR 数据,并从识别步骤开始执行。

适用场景

适用于 WooCommerce Marketplace 产品团队的功能请求分类工作流,帮助区分真正的功能请求与伪装成功能请求的支持问题。

限制

  • 判断应保持保守,仅在支持性质明确时才标记。
  • 写入失败时需手动清理半完成状态。
  • 具体价格、平台支持范围、性能指标等未在资料中提供。