# AGENTS.md - AI Coding Assistant Guide

## GIT
- git提交时使用中文添加描述
- 无视`.DS_Store`

## AGENT
- 不开启subagent

## 文档
- 如果是前后端开发任务，根据设计文档产出实施计划时，输出两份执行文档，一份为后端的实施计划，一份为前端的实施计划
- 每一次改动都需要留下实施文档，记录修改的内容
- 每次写设计文档的时候，都要检查一下保存路径是否正确

## 测试
- 开发完成后必须执行与本次改动直接对应的验证步骤，完成验证后才能结束本次任务
- 如果是接口开发完成，先重启后端进程，确保最新代码已经生效，再调用接口进行测试
- 接口测试时必须覆盖多种情况，至少包含正常场景、必填/参数错误场景、分支场景；如接口逻辑包含状态、类型、金额、期限等关键条件，需要分别验证对应分支
- 每次调用外部接口进行测试或联调时，必须在后端日志中完整输出请求 URL、请求参数和返回参数
- 如果是前端页面开发完成，必须启动前端页面并调用浏览器检查功能是否正常，确认页面展示、交互流程、接口联动和关键提示信息符合预期
- 测试结束后，自动结束测试时开启的前后端进程

## 开发
- 在开发前端的时候，不需要使用git worktree，直接在当前分支进行开发

## 方案规范
- 当需要你给出方案时，必须符合以下规范
- 不允许给出兼容性或补丁性的方案
- 不允许过度设计，保持最短路径实现，且不能违反上一条要求
- 不允许自行给出我提供的需求以外的方案，例如一些兜底和降级方案，这可能导致业务逻辑偏移问题
- 必须确保方案的逻辑正确，必须经过全链路的逻辑验证
