From 11c936a5b8689d0c2a4154ff8f7d05a873a6a8c1 Mon Sep 17 00:00:00 2001 From: voson Date: Sat, 21 Mar 2026 16:48:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(AGENTS):=20=E6=98=8E=E7=A1=AE=E6=8F=90?= =?UTF-8?q?=E4=BA=A4/=E6=8E=A8=E9=80=81=E5=89=8D=E5=BF=85=E9=A1=BB?= =?UTF-8?q?=E6=A3=80=E6=9F=A5=E7=89=88=E6=9C=AC=E5=8F=B7=E4=B8=8E=E8=BF=90?= =?UTF-8?q?=E8=A1=8C=20fmt/clippy/test?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Made-with: Cursor --- AGENTS.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index cdabc8e..9b894fe 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,12 +2,14 @@ 本仓库为 **MCP SaaS**：`secrets-core`（业务与持久化）+ `secrets-mcp`（Streamable HTTP MCP、Web、OAuth、API Key）。对外入口见 `crates/secrets-mcp`。 -## 提交 / 发版硬规则（优先于下文） +## 提交 / 推送硬规则（优先于下文） + +**每次提交和推送前必须执行以下检查，无论是否明确「发版」：** 1. 涉及 `crates/**`、根目录 `Cargo.toml`/`Cargo.lock`、`secrets-mcp` 行为变更的提交，默认视为**需要发版**，除非明确说明「本次不发版」。 -2. 发版前检查 `crates/secrets-mcp/Cargo.toml` 的 `version`，再查 tag：`git tag -l 'secrets-mcp-*'`。 -3. 若当前版本对应 tag 已存在，默认允许复用现有 tag 继续构建；仅在需要新的发布版本时再 bump `version` 并 `cargo build` 同步 `Cargo.lock`。 -4. 提交前优先运行 `./scripts/release-check.sh`（版本/tag + `fmt` + `clippy --locked` + `test --locked`）。 +2. 提交前检查 `crates/secrets-mcp/Cargo.toml` 的 `version`，再查 tag：`git tag -l 'secrets-mcp-*'`。若当前版本对应 tag 已存在且有代码变更，**必须 bump 版本号**并 `cargo build` 同步 `Cargo.lock`。 +3. 提交前运行 `./scripts/release-check.sh`（版本/tag + `fmt` + `clippy --locked` + `test --locked`）。若脚本不存在或不可用，至少运行 `cargo fmt -- --check && cargo clippy --locked -- -D warnings && cargo test --locked`。 +4. 推送时将版本号更新和代码变更**放在同一次提交或同一次推送**中，不要分开推送。 ## 项目结构