mcpField
C
client-feedback

client-feedback

github.com/genericservice测试与质量039 次安装23 周前更新
代码仓库

关于 client-feedback

将客户反馈邮件整理为待跟踪和调查的 GitHub issue，并协助撰写专业回复的 Agent 技能。Python 脚本负责邮件获取、解析和附件下载，Agent 负责分流、核查与修复。

主要功能

  1. 01按发件域名和日期搜索 Gmail
  2. 02获取邮件正文并下载附件
  3. 03生成包含线程摘要的 JSON 报告
  4. 04将反馈分流为 GitHub issue
  5. 05按邮件线程起草回复

适用场景

  1. 01定期收集指定客户的邮件反馈
  2. 02把不同反馈整理为独立 issue
  3. 03核查反馈并定位代码问题
  4. 04拟定客户回复并先行审阅

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/genericservice/claude-skills --skill client-feedback

安装后在 Claude Code 中输入/client-feedback确认已加载。

附带文件scripts/process_feedback.py

详细介绍

客户反馈处理器

将客户反馈邮件转换为已跟踪、已调查并已解决的 GitHub 问题，并撰写专业的回复邮件。

此工作流采用脚本优先方法：由确定性的 Python 脚本负责获取和解析邮件等“繁琐工作”，让 Agent 负责分流和修复问题等“判断工作”。

用法

当用户要求“处理反馈”“查看来自 [domain] 的邮件”或“将反馈转成问题”时：

  1. 运行处理器脚本：

    python3 ~/.agents/skills/client-feedback/scripts/process_feedback.py \
  --domain "<client-domain>" \
  --days 7 \
  --out "./feedback-batch-$(date +%F)"

  2. 阅读报告： 加载生成的 report.json 和完整正文文本文件，了解反馈内容。

  3. 分流到 GitHub： 对报告中的每条不同反馈，创建一个 GitHub 问题或更新现有问题。

阶段 1：接收（由脚本驱动）

process_feedback.py 脚本可在数秒内完成以下任务：

  • 搜索来自指定域名或发件人的 Gmail 邮件。
  • 获取完整的邮件负载。
  • 自动将附件下载到本地目录。
  • 将纯文本正文提取到单独的文件中，方便阅读。
  • 生成 report.json，汇总邮件会话、参与者和摘要。

阶段 2：分流 — GitHub 问题

GitHub 问题是主要的工作看板。每项反馈创建一个问题，而不是每封邮件创建一个问题。

问题正文模板
## Reported by
[Person name] — [date] "[email subject]" (thread [threadId])

## Issue
[Verbatim quote if short, paraphrase if long]

## Status
[Open / awaiting client / in progress]

根据类别添加标签：feedback（始终添加）、bug、content、design、provider-data、question。

阶段 3：调查并修复

对照实际代码库核实反馈。全局搜索涉及声明的主题，确保彻底移除或更新。

阶段 4：回复

按邮件会话整理专业回复草稿。

**关键规则：**发送前，务必先在聊天中展示草稿正文。

签名政策

签名应简洁、专业。除非客户关系明确允许，否则避免披露 AI 合著情况。

参考：Gmail 多部分上传

如果需要撰写带内嵌图片的回复（例如修复前后的证明），请使用脚本注释或 process_feedback.py 逻辑中记录的 gws 多部分上传流程。

评论

支持 Markdown