写个缺陷修复的skill,提高AI的缺陷修复效率
发布于 2026-06-13
649
版权声明
我们非常重视原创文章,为尊重知识产权并避免潜在的版权问题,我们在此提供文章的摘要供您初步了解。如果您想要查阅更为详尽的内容,访问作者的公众号页面获取完整文章。
麦哲思科技任甲林
扫码关注公众号
扫码阅读
手机扫码阅读
文章主旨:通过制定并遵循一个严格、结构化的Bug修复流程,可以显著提高缺陷定位与修复的效率和质量,避免来回试错的低效循环。
关键要点:
- 缺陷修复的核心瓶颈在于与AI反复沟通定位问题原因。
- 修复流程必须根除根本原因,不能只解决表面现象。
- 用户确认是连接分析阶段与修复阶段的关键决策环节。
- 修复完成后需进行知识存档,以避免同类问题再次发生。
- 所有步骤均需有检查清单进行最终确认,确保流程完整落实。
内容结构:
一、动机与背景:作者在实际开发中发现,使用AI(TRAE)进行缺陷修复时,最耗时的是反复沟通而无法准确定位原因。为此,作者设计了一套规范化的Bug修复Skill,以提升修复效率。
二、修复流程(核心主体部分):
- 前置判断:明确区分“Bug修复”与“需求调整”。Bug修复指代码行为与预期不符;需求调整指新功能或行为变更,两者走不同流程。
-
步骤1:故障定位(深入分析):
- 确定问题模块和出错层面(前端/后端/交互)。
- 如果多次修改未果,需扩大分析范围(层次、范围、交叉、换角度)。
- 编写复现测试:必须编写用于稳定重现Bug的测试(单元/集成),或提供详细手动复现步骤。无法复现的问题无法精准修复。
- 识别根本原因:明确区分“出错点(A)”与“根本原因(B)”,并使用“5个为什么”深挖。必须同时修复A和B。 - 步骤2:用户确认:在完成故障定位后,必须向用户汇报分析结果(出错模块、出错点A、根本原因B、修复建议),并获得用户同意后才能继续修复。
- 步骤3:修复影响分析:评估修复的有效性、影响范围、关联改动点及潜在的连锁修改。
- 步骤4:方案设计:通常提供两种方案,并选择更能预防问题复发的方案。强调设计优于临时补丁。
- 步骤5:方案评审:对选定方案进行自我批判,检查是否有遗漏、是否破坏其他功能、是否存在性能/安全风险。
- 步骤6:虚拟修改:在思维中进行修改的静态推演,确保修改完整、无语法错误、保持代码可读性。
- 步骤7:单元测试:修正步骤1编写的复现测试以使其通过,编写/更新其他相关单元测试,并执行回归测试确保无新问题。
- 步骤8:全局扫描:在代码库中搜索是否存在相同或类似的潜在问题模式,并在获用户同意后统一修复。
-
步骤9:经验总结:将本次修复记录追加到项目文档
docs/bug-fixes.md中,格式包括问题描述、严重程度、出错点、根本原因、修复方案、预防措施、影响范围。
三、修复检查清单:列出所有流程步骤,确保最终没有遗漏。最终输出要求以diff或前后对比形式展示修改,并需用户确认关键决策后才能修改代码。
文章总结: 这是一套高度结构化、强调根本原因分析与用户确认机制的Bug修复SOP,适合用于提升AI辅助开发场景下的问题修复效率与质量。
麦哲思科技任甲林
麦哲思科技任甲林
扫码关注公众号
麦哲思科技(北京)有限公司总经理 敏捷性能合弄模型评估师 认证的Scrum Master 认证的大规模敏捷顾问SPC CMMI高成熟度主任评估师 COSMIC MPC,IAC 成员,中国分部主席
471 篇文章
浏览 937.3K
还在用多套工具管项目?
一个平台搞定产品、项目、质量与效能,告别整合之苦,实现全流程闭环。
查看方案
麦哲思科技任甲林的其他文章
SCAMPIV1.3b的有趣变化----行动计划复评20问
2014年12月30日CMMI研究所发布了SCAMPI评估方法v1.3b版本,对比以往的版本,该版本发生了一个有趣的变化,即增加一个阶段:行动计划复评阶段(action plan reappraisal,简写:APR)。这就意味着,在做一次评估时,允许被评估的组织在初期可以被评估为不满足或未评级,而在后续的4个月内可以针对影响目标达成的弱项做一次修正的复评。具体的操作方式如何呢?我们通过回答如下的
CMMI V2.0 时代即将来临
CMMI V2.0
CMMI 4级实践问题30问-5
第15问:如何选择控制图?最常用的控制图是哪几种? 答: 在选择控制图时,首先选择要判断数据的类型: 连续型变量可用的控制图有:X-R,X-S,XMR等,离散型变量可用的控制图有:U,c,z,P,nP图等。X-R,X-S图是适合分组数据的,如果分组的容量小于10则选择X-R,否则选择X-S图,如果是单点值则选择XMR。对于离散型变量要判断分布的类型,如果是二项分布则采用P,nP图,如果
文档恐惧症的分析
一、为什么不愿意写文档?大部分开发人员不愿意编写文档,为什么呢?1.写文档需要花费很多时间。2.不愿意暴露自己的思想被别人评判。3.文档编写得不好、没有充分发挥作用。4.根据实践经验,并非不写文档,项目就干不下去。有很多客户也这样对我讲:“我们原来没有那么多文档,项目照样干,客户也一样验收付款啊!”。5.如果写文档,很容易造成文档与实现不一致,文档的价值大大降低。6.如果写文档,就不能只写一份文档
为什么同事不能成为好朋友
昨夜,一位朋友给我电话,他大叹:“为什么同事不能成为好朋友!” 他在一家小公司做事,但是人际关系却很复杂,他是一个直肠子,很善良,很容易相信别人,也很乐意帮助别人。结果却发现别人利用他,为了利益,为了权力,他成了冤大头。初来咋到,有什么心事,他还和其他的同事说说,结果那些心腹话成了别人的攻击他,给老板打小报告的把柄。他很苦闷,于是要找我喝酒,找一个不会危害他的人诉说诉说。 这个问题,我也经
加入社区微信群
与行业大咖零距离交流学习
PMO实践白皮书
白皮书上线
白皮书上线