Skip to content

Bugfix 工作流

系统性Bug修复工作流,提供结构化的Bug定位、修复和验证流程。

使用方法

/bugfix <问题描述>

输入上下文

  • 任务描述: $ARGUMENTS
  • 尽可能提供错误日志、复现步骤以及预期与实际行为的对比

修复流程

  1. 复现并隔离问题 - 稳定重现Bug,确定其触发条件
  2. 识别根本原因 - 用证据定位问题根源
  3. 实现修复 - 采用最小、安全的修复方案
  4. 添加回归测试 - 编写或更新测试防止再次出现
  5. 验证修复 - 确认问题已解决并记录风险

输出格式

1. Diagnosis (诊断)

  • 根本原因分析
  • 支持结论的证据
  • 问题定位说明

2. Fix Plan (修复计划)

  • 需要修改的文件
  • 修复方法概述
  • 实施步骤

3. Patch (补丁)

  • 代码修改详情
  • 具体的代码编辑

4. Tests (测试)

  • 回归测试命令
  • 测试结果验证

5. Risks (风险)

  • 潜在的副作用
  • 需要关注的跟进事项

质量门禁

  • 完成阈值: 90%
  • 通过验证循环实现自动化质量保证

最佳实践

有效报告Bug

提供以下信息以加速修复:

  • 完整的错误堆栈跟踪
  • 复现步骤(最小可重现案例)
  • 预期行为 vs 实际行为
  • 环境信息(操作系统、版本、配置)
  • 相关日志片段

示例

bash
/bugfix "用户登录失败后session未正确清理,导致重新登录时出现405错误"

提供详细上下文:

bash
/bugfix "Safari浏览器下修改密码后立即访问受保护资源返回401,
        但Chrome和Firefox正常。
        错误日志:[Error] Token validation failed。
        复现步骤:1.登录 2.修改密码 3.访问/api/user 4.出现401"

相关命令

命令用途
/debug复杂问题的系统性调试分析
/test添加或更新测试
/review验证代码变更

Workflows / Orchestration / Execution