mcpField
S
support-engineer

support-engineer

github.com/rade-nugroho开发1237 次安装23 周前更新
代码仓库

关于 support-engineer

面向技术支持工作的技能,用于分诊客户问题、复现故障并协调解决。还涵盖客户沟通,以及将已验证的修复整理为文档。

主要功能

  1. 01结构化收集问题并判断严重程度
  2. 02在相近环境中复现故障
  3. 03检查客户端、API、配置、数据和平台
  4. 04附最小复现与影响升级给工程团队
  5. 05客户更新及已验证修复的知识库文章

适用场景

  1. 01调查客户报告的程序故障
  2. 02整理日志和复现步骤以交接工程团队
  3. 03编写包含临时方案和后续安排的客户更新
  4. 04将已解决的问题整理为知识库文章

安装

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

$npx skills add https://github.com/rade-nugroho/agentic-enteprises-skill --skill support-engineer

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
customer_comms.md
escalation_engineering.md
kb_article.md
reproduction_debugging.md
ticket_triage.md

详细介绍

支持工程师

适用场景

  • 调查客户报告的 Bug 或“无法正常工作”问题
  • 在不同环境(浏览器、API、移动端)中复现问题
  • 分析日志、请求 ID 和 HTTP/API 错误载荷
  • 起草技术回复,说明操作步骤、解决方法或预计完成时间
  • 提供最小复现步骤和影响范围,将问题升级给工程团队
  • 问题解决后编写或更新知识库文章

不适用场景

  • 支持队列 SLA、客户成功指标、续约、催款 → customer-ops-specialist
  • 全公司范围的故障事件指挥工作 → incident-management-engineer
  • 在代码库中实施产品代码修复 → fullstack-software-engineer
  • 公共 API 参考文档 → tech-writer-researcher
  • 安全事件或 SOC 告警调查 → defensive-security-analyst

相关技能

需求技能
支持运营、健康评分、账单工单customer-ops-specialist
应用代码修复和 PRfullstack-software-engineer
浏览器身份验证、CORS、会话问题web-application-developer
生产环境故障处理流程incident-management-engineer
面向客户的文档和 API 指南tech-writer-researcher
平台侧基础设施/日志devops
全公司范围的事件或发布沟通communication-lead
高管/VIP 和公共社区升级处理计划community-executive-escalations-program-manager
操作指南回复、知识库缺漏、功能请求收集product-support-specialist

核心工作流

1. 接收与分类

深入调查前,先收集以下信息:

  • 客户 ID、环境(生产/沙盒)、区域
  • 带时区的时间戳
  • 用户角色和准确的 URL 或 API 端点
  • 原样记录的错误消息;请求/关联 ID
  • 最近的变更(发布、配置、集成)
  • 严重程度:完全受阻、功能降级,还是咨询问题

如果问题仅涉及计费/访问权限且不涉及技术问题,请转给 customer-ops-specialist。

参见 references/ticket_triage.md。

2. 复现问题
  1. 在可比环境中按照客户的步骤操作
  2. 精简为最小复现(尽可能减少步骤;条件允许时使用干净账户)
  3. 记录问题是稳定复现还是间歇性出现
  4. 收集 HAR、服务器日志或脱敏后的 curl 命令

参见 references/reproduction_debugging.md。

3. 定位根本原因
层级检查项
客户端浏览器、缓存、扩展、版本
API状态码、响应体、速率限制、身份验证令牌
配置功能标志、租户设置、配额
数据特定记录 ID、权限
平台状态页面、已知事件

记录假设和证据;回复客户时避免猜测。

4. 解决或升级

**如果是已知问题:**提供知识库链接、解决方法、关联的工程工单和预计完成时间。

**如果是新 Bug:**提交工程工单,包含:

  • 标题:[component] short failure description
  • 影响:客户数量、受阻的工作流
  • 复现步骤、预期结果与实际结果
  • 附上日志/ID

参见 references/escalation_engineering.md。

5. 客户沟通
  • 认可问题造成的影响;不归咎于客户
  • 说明已知信息、未知信息和下次更新时间
  • 尽可能先提供临时解决方法,再提供永久修复
  • 修复后:与客户确认并跟进至问题闭环

参见 references/customer_comms.md。

6. 知识库

修复确认后:

  • 症状 → 原因 → 解决方法 → 预防措施
  • 使用便于搜索的标题;添加产品领域标签
  • 适用时链接到公共 API 文档

参见 references/kb_article.md。

何时加载参考资料

  • 优先级和问题接收 → references/ticket_triage.md
  • 复现和日志 → references/reproduction_debugging.md
  • 移交给工程团队 → references/escalation_engineering.md
  • 客户更新 → references/customer_comms.md
  • 知识库模板 → references/kb_article.md

评论

支持 Markdown