From add240775b98c7527df597d5cacab164f9bbf6a8 Mon Sep 17 00:00:00 2001
From: suyx <dada20041002@163.com>
Date: Tue, 4 Aug 2026 18:05:18 +0800
Subject: [PATCH] =?UTF-8?q?docs(=E5=BC=80=E5=8F=91=E7=BA=A6=E5=AE=9A):=20?=
 =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E4=B8=AD=E6=96=87=20Git=20=E6=8F=90=E4=BA=A4?=
 =?UTF-8?q?=E8=A7=84=E8=8C=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..9713a06
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,35 @@
+# 项目开发约定
+
+## Git 提交规范
+
+- 每个 `TASK-*` 或后续工单都必须在独立 worktree 和分支中开发。
+- 每个可验证的开发步骤完成后立即创建 Git 提交并推送到 Gitea `intelligrow` 组织下的对应远端分支，不得等第一版全部完成后再统一提交。
+- 提交信息使用中文描述，采用 Conventional Commits 常见前缀，格式为：
+
+  ```text
+  <type>(<scope>): <中文描述>
+  ```
+
+- `scope` 可选；描述应简短、明确，说明本次提交实际完成的内容，不写空泛描述。
+- 常用前缀：
+  - `feat`：新增功能
+  - `fix`：修复问题
+  - `docs`：文档修改
+  - `refactor`：重构，不改变外部行为
+  - `test`：新增或调整测试
+  - `perf`：性能优化
+  - `build`：构建或依赖调整
+  - `ci`：持续集成配置调整
+  - `style`：不影响逻辑的格式调整
+  - `chore`：其他维护工作
+  - `revert`：回滚提交
+- 任务提交应包含任务号或范围信息，推荐格式：
+
+  ```text
+  feat(WP7-05): 增加候选环境覆盖证据门禁
+  fix(WP5-04): 修复资源访问安全边界
+  test(WP5-lineage): 增加连续提交链验证
+  ```
+
+- 提交完成后必须核对本地提交 SHA、远端分支和远端完整 SHA；本地未提交、推送失败或远端 SHA 不一致时，不得宣告任务完成，也不得开始依赖该任务的下一项任务。
+- 不得在提交信息、日志、测试证据或代码中写入真实凭据、验证码、用户绝对路径或私有响应正文。