SuperAPI AI 工具集

rust-agents-compile-fix

编程与开发

查看项目

更新于 10-15 22:18

技能介绍

用途:该技能只做一件事——把失败的 cargo build / cargo check 收敛到干净编译,刻意逐条修复,避免连锁编辑。它不负责任务路由(由 rust-agents-orchestrator 负责),也不做深度惯用法审查(由 rust-agents-code-reviewer 负责);具体错误类别的含义交给相关 rust-errors-* 技能。

主要能力与用法:迭代时始终使用 cargo check(跳过代码生成,更快),每次修复后必须重新编译,绝不批量修复多个错误后只编译一次。循环为:cargo check 获取完整错误列表;从上到下读第一个错误;分类错误;应用一个修复;再次 cargo check;重复直到干净。始终先修最早出现的错误,后续错误常是首个错误的级联。同一错误尝试超过 2 到 3 次即停止并询问用户。

读取诊断:按顺序读错误码与标题、主位置、主下划线、次下划线(原因常在此)、note、help。不要只看主下划线而忽略次下划线。遇到不熟悉的错误码先运行 rustc --explain EXXXX。

建议处理:机械性建议(加分号、加 &、加 use、加 mut、加 .await、加 #[derive(...)]、加 ?)通常可直接应用;生命周期、trait bound、改类型、加 .clone() 等判断性建议需先检查是否符合设计意图。

限制与停止条件:若修复会跨多个模块、改变公共 API、或同一错误反复失败,应停止并询问用户,报告错误、根因与 2 到 3 个设计选项。cargo fix 与 cargo clippy --fix 仅用于批量机械清理,运行前需保证工作区干净,且不能替代阅读硬错误。

参考链接:Rust 错误索引 https://doc.rust-lang.org/error_codes/error-index.html ;rustc 命令行参数 https://doc.rust-lang.org/rustc/command-line-arguments.html ;cargo fix https://doc.rust-lang.org/cargo/commands/cargo-fix.html 。