version: "1.0.0" name: vibe-bug-tracker description: Use this skill to record production issues and maintain the historical bug list.

线上问题记录与历史Bug清单工作流

1. 基本信息

• 名称：线上问题记录与历史Bug清单工作流
• 目标：全面了解和记录项目的线上问题、历史Bug、常见坑、历史故障和性能瓶颈，为项目的稳定运行和持续改进提供参考

2. 前置步骤

产物检查

1. 检查项目结构：

• 确认项目的基本结构和技术栈
• 检查是否存在现有的问题记录或Bug追踪系统

1. 检查相关文档：

• 检查是否有现有的问题记录文档
• 检查是否有Bug追踪工具的使用记录
• 检查是否有性能分析报告

依赖项确认

1. 技术栈确认：

• 确认前端、后端使用的技术栈
• 确认数据库类型和版本
• 确认部署环境和相关服务

1. 工具确认：

• 确认是否使用了Bug追踪工具（如Jira、GitHub Issues等）
• 确认是否使用了监控和日志分析工具
• 确认是否有性能测试工具的使用记录

3. 执行步骤

第一步：项目全面分析

1. 技术架构分析：

• 了解项目的整体架构
• 识别核心组件和服务
• 了解各组件间的依赖关系

1. 历史问题收集：

• 查阅Bug追踪系统中的历史记录
• 查看项目的版本发布记录和变更日志
• 收集团队成员的经验反馈

1. 线上环境分析：

• 了解生产环境的配置和部署情况
• 检查监控系统的历史数据
• 分析日志系统中的错误记录

第二步：问题分类与整理

1. Bug分类：

• 按功能模块分类
• 按严重程度分类
• 按发生频率分类
• 按影响范围分类

1. 故障分析：

• 记录历史故障的发生时间和持续时间
• 分析故障的根本原因
• 记录故障的解决方案和恢复时间
• 评估故障的影响程度

1. 性能瓶颈识别：

• 分析系统性能数据
• 识别CPU、内存、磁盘、网络等资源瓶颈
• 分析数据库性能问题
• 识别代码层面的性能问题

1. 常见坑总结：

• 记录开发和部署过程中的常见问题
• 总结容易出错的配置和操作
• 整理常见错误的解决方案

第三步：详细信息收集

1. Bug详情记录：

• 记录Bug的具体表现和复现步骤
• 记录Bug的发现时间和修复时间
• 记录Bug的修复方案和验证结果
• 记录Bug的影响范围和严重程度

1. 故障详情记录：

• 记录故障的具体现象和影响范围
• 记录故障的排查过程和使用的工具
• 记录故障的解决方案和预防措施
• 记录故障的事后分析和改进建议

1. 性能问题记录：

• 记录性能问题的具体表现和测试数据
• 记录性能优化的方案和实施结果
• 记录性能监控的关键指标和阈值
• 记录性能问题的预防措施

1. 常见坑记录：

• 记录常见坑的具体场景和表现
• 记录避免和解决这些问题的方法
• 记录相关的最佳实践和注意事项

第四步：文档编写与整合

1. 文档结构设计：

• 设计问题记录文档的结构
• 确定章节划分和内容组织方式

1. 内容编写：

• 按照分类和整理的结果编写详细内容
• 确保内容完整覆盖所有收集到的信息
• 提供清晰的问题描述和解决方案

1. 文档审核：

• 内容准确性检查
• 信息完整性检查
• 格式规范检查
• 与团队成员的交叉验证

4. 执行建议

1. 深入调研：在编写文档前，充分了解项目的历史和现状，收集尽可能多的信息
2. 系统分析：采用系统化的方法分析问题，确保不遗漏任何重要信息
3. 注重细节：详细记录每个问题的具体情况和解决方案，确保文档的实用性
4. 客观记录：保持客观中立的态度，准确记录问题的真实情况
5. 持续更新：问题记录文档应随着项目的发展定期更新，及时添加新发现的问题
6. 团队协作：与项目团队保持沟通，确保记录的信息准确无误
7. 总结规律：从历史问题中总结规律，为未来的开发和运维提供参考
8. 预防为主：基于历史问题，提出预防措施，减少类似问题的发生

5. 成功标准

1. 文档完整覆盖项目的线上问题、历史Bug、常见坑、历史故障和性能瓶颈
2. 文档内容准确反映项目的实际情况和历史问题
3. 文档格式规范，结构清晰，易于理解和使用
4. 文档包含详细的问题描述、根本原因分析和解决方案
5. 文档保存至指定位置：/项目文档/启动文档/问题记录.md
6. 文档对项目的持续改进和问题预防具有参考价值

6. 失败处理

1. 信息收集不足：如果项目信息收集不完整，应及时与项目团队沟通获取更多信息
2. 历史记录缺失：如果历史记录缺失，应通过团队访谈和现有文档尽可能重建历史信息
3. 分析不深入：如果对问题的分析不够深入，应使用专业工具进行进一步分析
4. 文档编写错误：如果发现文档内容有误，应及时修正并重新审核

7. 输出成果

1. 线上问题记录与历史Bug清单文档（问题记录.md） - 保存至/项目文档/启动文档/目录

• 包含Bug分类和详细记录
• 包含历史故障分析和解决方案
• 包含性能瓶颈识别和优化建议
• 包含常见坑总结和预防措施

1. 问题分析报告：

• 问题趋势分析
• 根本原因统计
• 解决方案效果评估

1. 改进建议：

• 基于历史问题的预防措施
• 系统优化建议
• 开发和运维流程改进建议

记住，线上问题记录与历史Bug清单是项目宝贵的经验财富，应确保文档的准确性、完整性和可参考性，为项目的稳定运行和持续改进提供有力支持。