feat(AGENTS.md): 添加项目记忆规则说明

main
zangch@mesnac.com 5 days ago
parent fbc7d12cc5
commit ec048bf9ae

@ -494,3 +494,25 @@
- 上传逻辑优先复用 `FileUploadUtils`,不要在业务层重复拼接文件路径。
- 涉及脱敏字段优先用 `@Sensitive`,不要在 Controller 手工字符串处理。
- 新增通用能力时,先判断是否应放在 `ruoyi-common`(跨模块复用)还是业务模块(仅单域使用)。
## 项目记忆规则(私人助理模式)
**重要:每次完成任务后,必须将任务记录追加到项目记忆文件 `{项目根目录名称}_memory.md`** ,内容集中于三方面:我们在解决什么问题、找到了哪些相关文件(精确到行号)、当前的理解是什么
**记录格式**
```markdown
## {YYYY-MM-DD}(北京时间)
### 1、执行清单 (Execution)
- **任务目标**{描述具体需求,描述本次解决了什么业务问题}
- **关键产出**{列出新增/修改的核心文件路径、API 路径或组件名称}
### 2、技术洞察与复盘 (Tech Insights)
- **核心逻辑模式**{说明本次采用了什么设计模式或架构思路策略模式实现多工厂算法、MPJ 实现多表关联等}
- **为什么这样写 (The Why)**{对比普通写法,解释当前方案在可维护性或扩展性上的优势}
- **潜在风险提醒**{记录 AI 在实现过程中发现的风险点,如:大表关联性能、并发冲突风险等}
### 3、专属学习区 (Learning Log)
- **今日新见识**{从本次代码中抽取 1 个用户可能不熟悉的知识点,如:某个 TS 特性、Java 17 新语法或 MPJ 高级用法}
- **1分钟本质理解**{用最通俗的话解释这个知识点的本质,帮用户快速建立直觉}
### 4、下一步建议 (Next Steps)
- **遗留问题**{如有}
- **进阶方向**{建议用户接下来可以深入阅读哪方面的文档或优化哪个模块}
---
```

Loading…
Cancel
Save