SuperAPI AI 工具集

fix-bug

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:为 Rust 项目提供一套系统化的 bug 修复流程,在提供 GitHub Issue、错误信息或问题描述时使用。

主要能力与流程分段: 一、理解 bug:可从 Issue 编号获取详情,分析复现步骤、预期与实际行为;解析错误信息与堆栈,定位错误类型和发生位置(file:line)。 二、探索代码:按错误发生文件、上游调用方、相关测试、同模块相关代码的顺序查找。 三、诊断根因:提出假设并用代码与测试验证,构造最小复现。调试可用 RUST_BACKTRACE=1 cargo run -- <command>、cargo test <test_name> -- --nocapture、dbg!(variable);。 四、创建修复分支:git checkout -b fix/<issue-number>-<short-description>,如 fix/10-sqlite-nested-transaction。 五、实现修复:遵循错误处理(不用 unwrap()/expect(),用 ? 传播)、优先借用、snake_case/PascalCase 命名,尽量小范围改动,避免无关重构。 六、编写测试:先写可复现 bug 的回归测试,确认失败后再修复并确认通过;单元测试置于同文件 #[cfg(test)],集成测试放 src/cli/tests/,命名如 test_<feature><condition><expected_result>。 七、验证:依次运行 cargo fmt、cargo clippy -- -D warnings、cargo test、cargo test --test <test_file_name>,并核对提交信息格式 fix(<scope>): <summary>。 八、创建 PR:git push -u origin <branch-name>,通过 MCP(mcp__github__create_pull_request)创建,填写 PR 模板,关联 Fixes #<issue-number>。

适用场景:Rust 项目的缺陷修复、回归测试补充与 PR 提交。 限制:资料未提供具体依赖版本、安装步骤及可用平台信息;涉及破坏性 API 变更、多种修复方案、无法确定根因或安全相关问题时,应停止并与用户确认。