rust-project-validate

Rust 项目规范校验

必须：该技能在任务结束前执行一键规范校验，确保代码风格、静态检查、构建与测试均通过。 避免：还没进行 api和交互测试的情况下，就开始执行规范校验，因为这时候代码可能还不是最终版本，还不能确保通过所有测试用例。

何时调用

• 每次开发任务结束前必须调用
• 提交代码或发起评审前建议调用

执行内容

1. 格式检查：
   • cargo fmt --all -- --check
   • cargo fmt --manifest-path desktop/src-tauri/Cargo.toml --all -- --check
2. Lint 检查：cargo clippy --all-targets --all-features -- -D warnings
3. 执行端到端用例，按本次任务的测试范围执行
4. 运行测试：优先按修改范围执行 cargo test，避免无差别跑完整套耗时用例
5. 完整构建：cargo build --all-targets --all-features（避免无差别构建，应该按改动范围构建）
6. 工作区兜底测试：开发完成后必须至少执行一次 cargo test --workspace --all-features，避免提交后才在 CI 中暴露失败

如果任一步失败，立即停止并返回失败报告。

验证顺序补充

• 对 UI / push / 管理端交互问题，必须先做 E2E 或 API 交叉验证，再进入 fmt/clippy/build
• 在跑 clippy/build/test 前，先确认没有遗留的 cargo、rustc、旧 bifrost 进程，避免互相抢锁造成假卡死
• 如果前面为了调试开过多轮 cargo test 或 cargo clippy，进入本技能前先清理残留任务，再顺序执行校验

输出

• 结构化报告，按步骤给出状态（通过/失败）与关键信息
• 当 fmt --check 失败时提示可使用以下命令自动修复：
  • cargo fmt --all
  • cargo fmt --manifest-path desktop/src-tauri/Cargo.toml --all
• 当 cargo test --workspace --all-features 失败时，必须在报告里明确指出这是 CI 风险，不能默默跳过

前置条件

• 项目为 Rust 工作空间，已正确安装 Rust toolchain 与 cargo
• 在仓库根目录执行

示例

运行本技能将顺序执行：

cargo fmt --all -- --check # 检查工作区 Rust 代码格式
cargo fmt --manifest-path desktop/src-tauri/Cargo.toml --all -- --check # 检查 desktop Tauri Rust 代码格式
cargo clippy --all-targets --all-features -- -D warnings # 检查代码是否符合 Rust 编码规范
cargo test -p bifrost-e2e -- --list # 先确认本次需要覆盖的 E2E 范围
cargo test -p <changed-crate> --all-features # 按修改范围执行测试
cargo build --all-targets --all-features # 最终构建项目

注意

• 与项目规则一致：参考 ../../rules/project_rules.md
• 若改动涉及 desktop/src-tauri，必须确保本地执行过独立 fmt 检查，不能只依赖工作区根 cargo fmt --all -- --check