diff --git a/AGENTS.md b/AGENTS.md
index e69de29..5817f15 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -0,0 +1,30 @@
+# AGENTS.md - AI Coding Assistant Guide
+
+## GIT
+- git提交时使用中文添加描述
+- 无视`.DS_Store`
+
+## AGENT
+- 不开启subagent
+
+## 文档
+- 根据设计文档产出前后端项目的实施计划时，输出两份执行文档，一份为后端的实施计划，一份为前端的实施计划
+- 每一次改动都需要留下实施文档，记录修改的内容
+- 每次写设计文档的时候，都要检查一下保存路径是否正确
+
+## 测试
+- 开发完成后必须执行与本次改动直接对应的验证步骤，完成验证后才能结束本次任务
+- 如果是接口开发完成，先重启后端进程，确保最新代码已经生效，再调用接口进行测试
+- 接口测试时必须覆盖多种情况，至少包含正常场景、必填/参数错误场景、分支场景；如接口逻辑包含状态、类型、金额、期限等关键条件，需要分别验证对应分支
+- 如果是前端页面开发完成，必须启动前端页面并调用浏览器检查功能是否正常，确认页面展示、交互流程、接口联动和关键提示信息符合预期
+- 测试结束后，自动结束测试时开启的前后端进程
+
+## 开发
+- 在开发前端的时候，不需要使用git worktree，直接在当前分支进行开发
+
+## 方案规范
+- 当需要你给出方案时，必须符合以下规范
+- 不允许给出兼容性或补丁性的方案
+- 不允许过度设计，保持最短路径实现，且不能违反上一条要求
+- 不允许自行给出我提供的需求以外的方案，例如一些兜底和降级方案，这可能导致业务逻辑偏移问题
+- 必须确保方案的逻辑正确，必须经过全链路的逻辑验证
diff --git a/doc/implementation-report-2026-03-30-agents-test-rules.md b/doc/implementation-report-2026-03-30-agents-test-rules.md
new file mode 100644
index 0000000..08bb147
--- /dev/null
+++ b/doc/implementation-report-2026-03-30-agents-test-rules.md
@@ -0,0 +1,21 @@
+# AGENTS 测试步骤规范补充实施记录
+
+## 实施时间
+- 2026-03-30
+
+## 修改内容
+- 新增仓库级 `AGENTS.md` 协作规范内容
+- 明确开发完成后必须执行与改动对应的验证步骤
+- 明确接口开发完成后需要先重启后端进程，再进行接口调用验证
+- 明确接口测试必须覆盖正常场景、参数错误场景和关键业务分支场景
+- 明确前端页面开发完成后需要通过浏览器检查页面功能、交互与接口联动
+- 保留测试结束后自动关闭测试进程的要求
+
+## 文档路径
+- `AGENTS.md`
+- `doc/implementation-report-2026-03-30-agents-test-rules.md`
+
+## 结论
+- 已将“开发完成后的测试步骤”写入仓库级协作规范
+- 新增要求能够直接约束接口开发和前端页面开发的验收动作
+- 本次修改仅涉及文档规范，不涉及业务代码与接口实现