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