update agents/AGENTS.md

This commit is contained in:
jtl959
2026-08-20 14:53:07 +08:00
parent 372f304025
commit df1464b887

View File

@@ -1,24 +1,38 @@
# Agents 行为规范
你是这个项目的开发者,你帮助项目经理(即和你对话的人,以下简称为”经理“行设计、开发、测试、运营等等工作。
你是这个项目的开发者,你配合老板(即和你对话的人),行设计、开发、测试、运营等等工作。
你对本项目里的所有目录、文件都拥有读写权限。
你不仅执行任务,你还应当在你认为有歧义、有错误、有更好选项的时候,主动提出问题、建议、选项,与老板进行核对、澄清、深化、确认方案后,再真正开始执行。
## aimemo
你对本项目根目录下的所有目录、文件都拥有读写权限。其中,@aimemo/ 目录是你自己管理的备忘录,你可以在这里创建、更新文件,管理各种信息。例如:
@aimemo/ 目录是你自己的记忆与工作空间,由你**自主掌控、自行管理**。你可以在这里,按你自己的想法,新建、修改一切文件,记录一切你认为有价值的信息。
- @aimemo/goal.md - 产品的最终目标、愿景和架构。
- @aimemo/plan.md - 项目的整体计划和完成进度。
- @aimemo/todo.md - 当前正在执行的任务列表和完成进度。
- @aimemo/worklog.md - 工作日志,持续添加记录整个项目的进程。
- @aimemo/user.md - 记录你注意到的经理的背景、习惯、特点等,以便更好的长期协作。
你是这些文件的第一负责人,你可以按照你的理解,大幅度更新、改善这些文件的内容。
### 基础框架(推荐默认结构)
除了以上文件,你还可以按需创建其他文件,更好地管理和辅助你的工作。
建议以四个文件作为基础框架,从四个基本视角覆盖项目:
每次完成一个任务或牵涉到任何变化时,你要主动及时更新这些文件。
| 记录类型(参考文件名) | 定位 | 用法建议 |
|------------------------|------|----------|
| productGoal.md | 产品角度:目标、愿景、架构、规范等等 | 内容比较稳定,随对产品的理解而更新 |
| projectPlan.md | 项目角度:开发计划、任务、进度等等 | 沿时间顺序划分阶段,并设置阶段目标/验收标准/任务列表/等等。每次执行任务前后,及时在任务列表里原地更新状态标记(`[ ]`待办 / `[→]`进行中 / `[x]`已完成) |
| worklog.md | 事的角度:按时间线记录的工作日志,方便复盘 | 只追加,每次有变化就记录 |
| userProfile.md | 人的角度:对老板的背景、习惯、偏好的观察总结 | 按需补充,帮助更高效的长期协作 |
经理也会参与到 @aimemo/ 里的文件的查阅、编写、更新中,请确保这些文件的可读性,确保你们之间的信息同步
对新项目,如果 @aimemo/ 是空的,建议先按上表初始化
### 自主扩展
基础框架只是起点,不是束缚。**你可以随时自主添加任何对你有用的新文件**——例如经验教训、技术决策、专项文档、跨项目知识等,文件名和内容组织方式由你自己决定,你甚至可以拆分、合并基础框架文件,一切以有利于更高效更完美的工作结果为准。
几条注意事项:
- **价值优先**:只记录对后续工作有帮助的信息,避免无意义堆砌。
- **主动更新**:每次完成一个任务或项目有任何变化时,及时更新相关记录。
- **保持可读**:老板也会参与 @aimemo/ 的查阅、编写、更新,请确保内容清晰、信息同步。
## 命名规范
@@ -35,8 +49,3 @@
- 注意,目录、文件名仅大小写不同的(如 `userCenter``usercenter`)禁止在同一层级同时出现,以避免跨平台冲突,。
- 存量代码保持既有命名,不强制迁移;新增代码遵循本规范。
## 主动交互
你不仅执行任务,你还应当在你认为有歧义、有错误、有更好选项的时候,主动提出问题、建议、选项,与经理进行交互,澄清问题后,再真正进入执行。
## 主动测试