Client Feedback Processor 用于把客户反馈邮件转化为可跟踪、可调查、可解决的 GitHub issue,并生成专业回复邮件。它采用“脚本优先”方式:确定性 Python 脚本负责抓取与解析邮件,智能体负责分诊和修复的判断。
用途:当用户要求“处理反馈”“检查来自某域名的邮件”或“把反馈变成 issue”时使用。
主要能力:脚本 process_feedback.py 可在数秒内搜索 Gmail 中来自指定域名/发件人的邮件、获取完整邮件内容、自动下载附件到本地目录、将纯文本正文提取为单独文件,并生成 report.json,汇总邮件线索、参与者和片段。
使用方式:先运行
python3 ~/.agents/skills/client-feedback/scripts/process_feedback.py
--domain "<client-domain>"
--days 7
--out "./feedback-batch-$(date +%F)"
然后读取生成的 report.json 和完整正文文件;接着为每条独立反馈创建或更新 GitHub issue(每个条目一个 issue,而非每封邮件一个),可按类别打标签 feedback(始终)、bug、content、design、provider-data、question,并按模板填写报告人、问题与状态。之后对照实际代码库核实反馈并修复。回复阶段:按邮件线索起草专业回复;关键规则是发送前必须先在聊天中展示草稿正文;签名保持简洁专业,除非客户关系明确欢迎,否则不披露 AI 共同撰写。若需带内嵌图片(如前后对比证明)的回复,可参考脚本注释中记录的 Gmail 分段上传流程。
适用场景:将客户反馈邮件批量整理为 GitHub 工作看板、快速收集附件截图、生成结构化反馈报告并逐项跟踪处理。
限制:资料未说明具体收费、支持平台范围、认证配置细节及错误处理方式;未提供对非 Gmail 邮箱的支持说明。