secrets/CONTRIBUTING.md

Contributing

版本控制

本仓库使用 Jujutsu (jj)。请勿使用 git 命令。

jj log          # 查看历史
jj status       # 查看状态
jj new          # 创建新变更
jj commit       # 提交
jj rebase       # 变基
jj squash       # 合并提交
jj git push     # 推送到远端

详见 AGENTS.md 的「版本控制」章节。

本地开发

# 复制环境变量
cp deploy/.env.example .env

# 填写数据库连接等配置后
cargo build
cargo test --locked

提交前检查

每次提交前必须通过：

cargo fmt -- --check
cargo clippy --locked -- -D warnings
cargo test --locked

或使用脚本：

./scripts/release-check.sh

发版规则

涉及 crates/**、根目录 Cargo.toml/Cargo.lock、secrets-mcp 行为变更的提交，默认需要发版。

1. 检查 crates/secrets-mcp/Cargo.toml 的 version
2. 运行 jj tag list 确认对应 tag 是否已存在
3. 若 tag 已存在且有代码变更，必须 bump 版本并 cargo build 同步 Cargo.lock
4. 通过 release-check 后再提交

详见 AGENTS.md 的「提交 / 推送硬规则」章节。