用途:用于调试、性能调查、瓶颈分析、剖析与优化工作。核心原则是:仅阅读代码可能无法揭示缺陷或瓶颈的根源,不应声称推测性的代码改动已修复缺陷或提升性能,而应运行代码、收集证据、定位原因并验证修复。
主要步骤:一,优化任务先建立性能基线,在改动前创建并运行基准测试,尽可能多次运行,使用平均值、百分位数等统计量得到稳定基线,而非依赖单次运行。二,阅读与缺陷或性能问题相关的代码;调试任务中若发现明确原因(如错误运算符或逻辑矛盾)可直接修复并跳过后续步骤,否则继续。三,验证原因,不能只靠代码审查,要运行实验。调试时可在临时文件或 REPL 中构造复现并运行确认;若不失败则逐步加入目标代码行为直到复现;再逐部分移除或回退,找到仍能触发缺陷的最小程序,缩小可能原因范围,定位根因并修复,确认修复能阻止最小复现中的缺陷,再应用到生产代码并确认解决原始缺陷,否则回到复现步骤重复。性能优化时使用基准、剖析器、计时日志等定位慢操作,修复瓶颈后用相同测量确认性能提升,并应用到生产代码确认,否则回到瓶颈分析重复。四,清理验证过程中产生的临时日志、复现代码、生成文件与日志数据。
规则:若用户反馈修复未解决缺陷或未提升性能,应将先前诊断视为未验证并重新调查;避免表面化和权宜性修复,要追问“这是根因吗”;当证据指向依赖项中的缺陷时,不要修补依赖,而应告知用户并描述证据、提出无需修改依赖的项目内变通方案;遇到困难时可添加临时日志,在正确与错误行为或快与慢执行之间寻找边界,或搜索相关库的 GitHub issue、Pull Request、Stack Overflow 与社区文章寻找同类报告与解决方案。使用方式与安装命令暂未提供。