# 贡献指南

感谢你为 Claw Code 做出贡献。

## 开发设置

- 安装稳定的 Rust 工具链。
- 在此 Rust 工作区的仓库根目录下进行开发。如果你从父仓库根目录开始，请先执行 `cd rust/`。

## 构建

```bash
cargo build
cargo build --release
```

## 测试与验证

在开启 Pull Request 之前，请运行完整的 Rust 验证集：

```bash
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo check --workspace
cargo test --workspace
```

如果你更改了行为，请在同一个 Pull Request 中添加或更新相关的测试。

## 代码风格

- 遵循所修改 crate 中的现有模式，而不是引入新的风格。
- 使用 `rustfmt` 格式化代码。
- 确保你修改的工作区目标的 `clippy` 检查通过。
- 优先采用针对性的 diff，而不是顺便进行的重构。

## Pull Request

- 从 `main` 分支拉取新分支。
- 确保每个 Pull Request 的范围仅限于一个明确的更改。
- 说明更改动机、实现摘要以及你运行的验证。
- 在请求审查之前，确保本地检查已通过。
- 如果审查反馈导致行为更改，请重新运行相关的验证命令。