From cce5cc4dbb5db33c019e1f6f052c411940ad028d Mon Sep 17 00:00:00 2001
From: Marci <Marci@DESKTOP-IR7RCO3>
Date: Thu, 27 Aug 2026 11:05:51 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20AGENTS.md=20=E5=9B=BA=E5=8C=96=E6=A0=87?=
 =?UTF-8?q?=E5=87=86=E5=B7=A5=E4=BD=9C=E6=B5=81=EF=BC=88=E5=88=86=E6=94=AF?=
 =?UTF-8?q?=E2=86=92PR=E2=86=92CI=E2=86=92rebase=20=E5=90=88=E5=B9=B6?=
 =?UTF-8?q?=EF=BC=89=EF=BC=8Cgitignore=20.zcode/?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore |  3 +++
 AGENTS.md  | 23 +++++++++++++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/.gitignore b/.gitignore
index b5d9e34..a479b61 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,6 +7,9 @@ obj/
 .vs/
 .idea/
 
+## ZCode
+.zcode/
+
 ## NuGet
 *.nupkg
 packages/
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..8c43dba
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,23 @@
+# AGENTS.md
+
+给编码代理与贡献者的仓库工作约定。
+
+## 标准工作流（所有改动一律遵循）
+
+1. 从最新 main 建分支（命名如 `fix-xxx` / `ci-xxx` / `docs-xxx`）
+2. 按主题拆分提交：Conventional Commits 前缀（`feat` / `fix` / `ci` / `docs` / `build`）+ 中文摘要
+3. 同步更新 `CHANGELOG.md` 的 `Unreleased` 段（按 新增 / 修复 / 变更 分类）
+4. 推送分支 → 开 PR → 等 `ci.yml` 绿 → rebase 合并并删除分支；**不直接推 main**
+
+## 提交前必须通过
+
+```bash
+dotnet build StreamFrame.slnx -c Release
+dotnet test StreamFrame.slnx -c Release --no-build
+```
+
+## 发版
+
+见 [docs/PUBLISHING.md](docs/PUBLISHING.md)：打 `v*` tag 触发 `release.yml` 单条流水线
+（版本校验 → 构建 → 测试 → Release → 推 nuget.org）；流水线强制校验 tag 与两个 csproj
+的 `<Version>` 一致，发版前先同步版本号。