用途
该技能用于在 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,低频)。
- 推荐顺序执行而非逐个执行,以减少开销。
使用方式
提供五种工作流模式:
- 快速检查(开发中,2-3 分钟):
cargo check && cargo test -- --test-threads=1 - 标准构建周期(提交前,5-10 分钟):
cargo build --workspace && cargo test --workspace --all-features && cargo clippy --workspace --all-targets --all-features -- -D warnings && cargo fmt --all -- --check - 清洁构建(问题发生时,10-15 分钟):
cargo clean && cargo build --workspace && cargo test --workspace --all-features - 发布构建(部署前,15-20 分钟):
cargo build --release --workspace && cargo test --release --workspace && cargo bench --no-run - 文档生成(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。