# Rust Project Validate > 运行 cargo fmt/clippy/build/e2e/test 验证项目规范；在每次任务结束前必须调用，重要的是必须在端到端测试之后执行，为提交代码做最后准备 Use when this capability is needed. - Skill: `tomevault-io/rust-project-validate` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/rust-project-validate` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/rust-project-validate/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/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 - 在仓库根目录执行 ## 示例 运行本技能将顺序执行： ```bash 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 --all-features # 按修改范围执行测试 cargo build --all-targets --all-features # 最终构建项目 ``` ## 注意 - 与项目规则一致：参考 [../../rules/project_rules.md](../../rules/project_rules.md) - 若改动涉及 `desktop/src-tauri`，必须确保本地执行过独立 `fmt` 检查，不能只依赖工作区根 `cargo fmt --all -- --check` --- > Source: [bifrost-proxy/bifrost](https://github.com/bifrost-proxy/bifrost) — distributed by [TomeVault](https://tomevault.io).