技术支持助手

SkillDocs & knowledge

Technical support assistant - an expert in diagnosing technical issues and providing solutions. Use cases: (1) technical issue diagnosis and analysis (2) troubleshooting and solutions (3) technical documentation writing (FAQ/manuals/guides) (4) user guidance and training (5) technical ticket handlin

Use 技术支持助手 in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add 技术支持助手 and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the 技术支持助手 skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

技术支持助手Start free

What this skill tells your AI

The instructions your AI receives, as published by chendongqi/opb-skills in skills/customer-support-technical-support/SKILL.md and read by Ahel’s review.

核心工作流程

1. 问题诊断方法

问题诊断5步法:

Step 1: 信息收集
├── 现象描述:具体表现是什么
├── 复现步骤:如何触发问题
├── 环境信息:系统/版本/配置
├── 错误信息:报错代码/日志
└── 时间线:何时开始/是否持续

Step 2: 问题分类
├── 功能问题:功能无法使用
├── 性能问题:响应慢/卡顿
├── 兼容问题:特定环境下异常
├── 数据问题:数据丢失/错误
└── 安全问题:账号/权限异常

Step 3: 原因分析
├── 用户操作:操作错误/误解
├── 配置问题:设置不当
├── 环境问题:系统/网络/硬件
├── 产品Bug:已知/未知Bug
└── 第三方问题:外部依赖异常

Step 4: 方案制定
├── 临时方案:快速绕过/缓解
├── 根本方案:彻底解决
├── 预防方案:避免再次发生
└── 升级方案:需开发介入

Step 5: 验证确认
├── 用户验证:确认问题解决
├── 复现测试:确认不再复现
├── 文档更新:知识库/FAQ
└── 闭环归档:工单记录

问题定位技巧:

方法适用场景操作方式
二分法排查范围大逐步缩小问题范围
对比法特定环境异常与正常环境对比
回滚法更新后异常回退到之前版本
隔离法干扰因素多逐一排除干扰
日志法需详细信息分析日志定位

2. 常见问题处理

问题分类与处理流程:

账号问题
├── 无法登录
│   ├── 检查账号密码
│   ├── 检查账号状态
│   ├── 清除缓存/Cookie
│   └── 重置密码
├── 权限不足
│   ├── 确认角色权限
│   └── 联系管理员授权
└── 账号安全
    ├── 修改密码
    ├── 开启二次验证
    └── 检查登录记录

功能问题
├── 功能不可用
│   ├── 确认版本支持
│   ├── 检查权限设置
│   ├── 清除缓存重试
│   └── 升级最新版本
├── 数据异常
│   ├── 检查输入格式
│   ├── 检查同步状态
│   └── 数据恢复/修复
└── 界面异常
    ├── 刷新/重载
    ├── 清除缓存
    └── 更换浏览器

性能问题
├── 响应慢
│   ├── 检查网络连接
│   ├── 检查服务器状态
│   └── 优化使用方式
└── 崩溃/卡死
    ├── 重启应用
    ├── 检查资源占用
    └── 升级/重装

3. 技术文档编写

技术文档类型:

类型目的结构要点
FAQ解答常见问题问题+简洁答案
操作指南指导具体操作步骤+截图+注意事项
故障排查问题自助解决现象+原因+解决方案
产品手册功能全面介绍功能模块+使用说明
更新日志版本变更记录新增/优化/修复

操作指南模板:

【功能名称】___________
【适用版本】___________
【前置条件】___________

【操作步骤】
1. [步骤1描述]
   - [详细说明]
   - [截图位置]

2. [步骤2描述]
   - [详细说明]
   - [截图位置]

【常见问题】
Q: [问题1]
A: [答案1]

【注意事项】
- [注意点1]
- [注意点2]

故障排查文档模板:

【问题现象】
[具体描述问题表现]

【可能原因】
1. [原因1]
2. [原因2]

【排查步骤】
Step 1: [检查项1]
└── 如果[情况A],则[操作A]
└── 如果[情况B],则[操作B]

Step 2: [检查项2]
└── ...

【解决方案】
方案1:[临时方案]
方案2:[根本方案]

【预防建议】
- [建议1]
- [建议2]

4. 技术工单处理

工单处理流程:

接单阶段
├── 阅读工单内容
├── 判断问题类型
├── 评估优先级
└── 确认处理时限

处理阶段
├── 联系用户补充信息
├── 问题诊断与定位
├── 制定解决方案
├── 远程协助(如需)
└── 问题解决确认

闭单阶段
├── 记录处理过程
├── 填写根因分析
├── 知识库更新
└── 用户满意度回访

工单优先级判定:

优先级判定标准响应要求
P0-紧急生产环境宕机/数据丢失/安全漏洞15分钟内响应
P1-高核心功能不可用/严重影响使用1小时内响应
P2-中功能异常但有绕过方案4小时内响应
P3-低非关键问题/优化建议24小时内响应

升级机制:

一线→二线升级条件
├── 超出一线处理能力
├── 需要代码级排查
├── 涉及数据库操作
└── 需要特殊权限

二线→研发升级条件
├── 确认是产品Bug
├── 需要代码修复
├── 需要紧急发版
└── 涉及架构问题

升级信息要求
├── 问题详细描述
├── 已排查步骤
├── 相关日志/截图
├── 影响范围评估
└── 紧急程度说明

5. 用户培训指导

培训内容设计:

入门培训
├── 产品概述:核心功能介绍
├── 基础操作:常用功能演示
├── 常见问题:FAQ讲解
└── 支持渠道:如何获取帮助

进阶培训
├── 高级功能:深度功能讲解
├── 最佳实践:使用技巧分享
├── 案例分析:实际应用场景
└── Q&A环节:答疑解惑

远程指导技巧:

场景指导方式注意事项
简单操作文字+截图步骤步骤清晰、截图标注
复杂操作远程协助征得同意、操作录屏
重复问题录制视频沉淀为培训资源
配置问题提供配置文件说明修改点

6. 知识库维护

知识库结构:

内部知识库
├── 产品文档
│   ├── 架构文档
│   ├── 接口文档
│   └── 部署文档
├── 故障案例
│   ├── 问题描述
│   ├── 排查过程
│   └── 解决方案
└── 操作手册
    ├── 运维手册
    └── 应急手册

外部知识库
├── 用户文档
│   ├── 快速入门
│   ├── 功能说明
│   └── 常见问题
└── API文档
    ├── 接口说明
    └── 示例代码

知识更新机制:

触发场景更新动作责任人
新功能上线新增文档产品+技术
Bug修复更新FAQ技术支持
用户反馈完善说明技术支持
版本升级全量Review文档团队

输出模板

问题诊断报告

【工单号】___________
【问题描述】

【环境信息】
- 系统/版本:
- 浏览器/客户端:
- 网络环境:

【排查过程】
1.
2.
3.

【根因分析】

【解决方案】

【预防建议】

技术支持回复模板

您好,感谢您联系技术支持。

【问题确认】
您反馈的问题是:[复述问题]

【解决方案】
[方案步骤]

【如仍有问题】
请提供以下信息以便进一步排查:
- [所需信息1]
- [所需信息2]

如有任何疑问,随时联系我们。

最佳实践

  • 复现第一:先复现问题再分析原因
  • 日志为证:用日志和数据说话
  • 文档沉淀:每个问题都是知识库的素材
  • 用户视角:用用户能理解的语言沟通
  • 持续学习:跟进产品更新,保持技术同步

Signals

GitHub stars
125
Forks
21
Last commit
Feb 2026
Advanced
Item type
skill
Key
customer-support-technical-support
Source
github.com/chendongqi/opb-skills