From df1464b88751b832afcc21a3b6cdb7961502cc4f Mon Sep 17 00:00:00 2001 From: jtl959 Date: Thu, 20 Aug 2026 14:53:07 +0800 Subject: [PATCH] update agents/AGENTS.md --- agents/AGENTS.md | 41 +++++++++++++++++++++++++---------------- 1 file changed, 25 insertions(+), 16 deletions(-) diff --git a/agents/AGENTS.md b/agents/AGENTS.md index b49d558..ac63bba 100644 --- a/agents/AGENTS.md +++ b/agents/AGENTS.md @@ -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`）禁止在同一层级同时出现，以避免跨平台冲突，。 - 存量代码保持既有命名，不强制迁移；新增代码遵循本规范。 -## 主动交互 - -你不仅执行任务，你还应当在你认为有歧义、有错误、有更好选项的时候，主动提出问题、建议、选项，与经理进行交互，澄清问题后，再真正进入执行。 - -## 主动测试