AGENTS.md 2.7 KB

项目协作规则

基本原则

  • 修改代码前先阅读相关文件,遵循现有项目结构、命名和实现风格。
  • 保持改动聚焦,只处理当前任务相关内容,不做无关重构。
  • 不要覆盖或回滚用户已有改动,除非用户明确要求。
  • 不要提交日志、临时文件、构建产物或本地环境配置。

运行与构建

  • 前端构建优先使用: npm run build
  • 如果需要运行前端开发服务,先查看现有脚本和端口配置,再启动对应命令。
  • 如果需要运行后端服务或测试,先查看后端目录中的 Maven/Gradle 配置,再选择合适命令。
  • 运行命令失败时,需要说明失败原因和已尝试的验证方式。

修改限制

  • 不要修改以下本地配置文件,除非用户明确要求: code/backend/src/main/resources/application-dev.yml
  • 不要提交以下内容: code/backend/logs/** logs/**
  • 涉及用户数据、方案、穴位、经络、调理内容时,要优先保证已有数据兼容性。
  • 涉及中医术语、穴位定位和方案描述时,要保持表述准确、谨慎。

测试与验证

  • 前端代码改动后,优先运行: npm run build
  • 后端代码改动后,优先运行相关单元测试或项目已有验证命令。
  • 如果改动范围较小且没有合适测试,也需要进行静态检查或说明未运行测试的原因。

Git 规则

  • 不要自动执行 git push,除非用户明确要求。
  • 不要使用破坏性 Git 命令,例如 git reset --hardgit checkout -- <file>,除非用户明确要求。
  • 提交前检查暂存内容,避免把本地配置、日志或无关文件加入提交。
  • 如果用户要求提交,提交信息优先使用中文,并简洁描述本次改动。
  • 不要将.cursor文件夹和.idea文件夹提交到git
  • Git 仓库: http://git.iwintrue.com/liaoxg/ajy
  • 同事分支:liyu_2026_04_07
  • 我的分支:jiapu_aijiuyi
  • 项目路径(仓库内): code/aijiuyi
  • Git 用户名: jiapu
  • 分支: jiapu_aijiuyi
  • 拉取代码规则:将同事分支的openspec文件夹下的所有文件(不包括openspec目录)同步到我的code目录下。
  • git提交日志:在每次提交的时候要询问我,如果我选择空白,则你可以自己总结边写日志
  • 提交代码规则:application-dev.yml文件默认不参与git提交。

回复要求

  • 完成修改后,简要说明改了哪些文件、做了什么验证。
  • 如果有未完成事项、测试无法运行或需要用户决策的地方,需要明确说明。
  • 语言:和我对话,思考的时候使用中文。

项目信息

  • 项目名称: aijiuyi
  • 可以读取并使用application.yml、application-dev.yml中的datasource属性