SuperAPI AI 工具集

rust development workflow

编程与开发

查看项目

更新于 10-16 04:42

技能介绍

用途

该技能用于在 Miyabi 项目中执行完整的 Rust 开发工作流,保证代码质量、类型安全与全面测试。当需要编译、测试或检查 Rust 代码质量时使用,典型触发场景包括:构建项目、运行测试、检查代码质量、提交前检查、实现新功能后验证。

主要能力

  • 覆盖 cargo build、cargo test、cargo clippy、cargo fmt、cargo doc 等命令。
  • 提供命令优先级与平均耗时参考:cargo check(10-30s,高频)、cargo build(30-120s,高频)、cargo build --release(60-300s,低频)、cargo test(60-180s,高频)、cargo clippy(30-60s,中频)、cargo fmt(5-10s,高频)、cargo doc(30-60s,低频)。
  • 推荐顺序执行而非逐个执行,以减少开销。

使用方式

提供五种工作流模式:

  1. 快速检查(开发中,2-3 分钟):cargo check && cargo test -- --test-threads=1
  2. 标准构建周期(提交前,5-10 分钟):cargo build --workspace && cargo test --workspace --all-features && cargo clippy --workspace --all-targets --all-features -- -D warnings && cargo fmt --all -- --check
  3. 清洁构建(问题发生时,10-15 分钟):cargo clean && cargo build --workspace && cargo test --workspace --all-features
  4. 发布构建(部署前,15-20 分钟):cargo build --release --workspace && cargo test --release --workspace && cargo bench --no-run
  5. 文档生成(3-5 分钟):cargo doc --workspace --no-deps --all-features

性能优化方面:可按 CPU 核心数设置并行度(如 cargo build -j 8、cargo test -- --test-threads=8);利用增量构建缓存(target/debug/deps/、target/release/deps/),必要时用 CARGO_INCREMENTAL=0 cargo build 禁用缓存。

适用场景

适用于 Miyabi 项目的 Cargo Workspace 结构,包含 miyabi-types、miyabi-core、miyabi-cli、miyabi-agents、miyabi-github、miyabi-worktree、miyabi-llm 等 crate。主要依赖包括 tokio、async-trait、serde、octocrab、tracing。

限制与错误处理

常见错误及处理:error[E0277](Trait 未实现,检查 async-trait 使用)、error[E0412](类型未定义,添加 use 语句)、error[E0433](模块未解析,检查路径)、Clippy 警告(按警告修改)、fmt 差异(运行 cargo fmt)、测试失败(可尝试 cargo test -- --test-threads=1、cargo test test_name -- --nocapture、RUST_BACKTRACE=1 cargo test)。

成功标准:cargo build 0 errors、cargo test 100% pass、cargo clippy 0 warnings、cargo fmt --check 0 diff、cargo doc 0 warnings。

相关文档包括 context/rust.md、context/rust-tool-use-rules.md、agents/RUST_COMMANDS_OPTIMIZATION.md;相关技能包括 Agent Execution、Git Workflow、Security Audit。