From 8f84c0b07c13bc0892bf1f2795651fc6eb1bd62f Mon Sep 17 00:00:00 2001 From: luk Date: Fri, 21 Aug 2026 13:58:27 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8A=8A=20productGoal=20=E6=94=B9=E5=90=8D?= =?UTF-8?q?=E4=B8=BA=20productLens=EF=BC=8C=E4=BB=A5=E5=8F=8D=E6=98=A0?= =?UTF-8?q?=E5=AE=83=E4=B8=8D=E4=BB=85=E5=8C=85=E5=90=AB=E6=9C=AA=E6=9D=A5?= =?UTF-8?q?=E7=9B=AE=E6=A0=87=EF=BC=8C=E4=B9=9F=E5=8C=85=E5=90=AB=E7=8E=B0?= =?UTF-8?q?=E6=9C=89=E4=BA=8B=E5=AE=9E=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- agents/AGENTS.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/agents/AGENTS.md b/agents/AGENTS.md index 4052f71..3d45ba5 100644 --- a/agents/AGENTS.md +++ b/agents/AGENTS.md @@ -8,20 +8,20 @@ ## aimemo -@aimemo/ 目录是你自己的记忆与工作空间，由你**自主掌控、自行管理**。你可以新建、删除、合并、拆分、修改 @aimemo/ 里面的一切子目录和文件，记录一切对长期持续工作有价值的信息，使得工作进度能够跨 sessions、跨 ai models、跨 ai agents 进行下去。 +@aimemo/ 目录是你自己的记忆与工作空间，由你**全权自主掌控**。你可以任意处理这里的一切子目录和文件，只要有助于更好的管理和辅助你的工作。记录一切有用的信息，使得工作能够跨 sessions、跨设备、跨 ai models、跨 ai agents 的连续进行下去。持续更新，随时保持和项目里其他内容的同步。 ### 基础框架（推荐默认结构） 建议以四个文件作为基础框架，从四个基本视角覆盖项目： -| 记录类型（参考文件名） | 定位 | 用法建议 | -| ---------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -| productGoal.md | 产品角度：目标、愿景、架构、规范等等 | 内容比较稳定，随对产品的理解而更新 | -| projectPlan.md | 项目角度：开发计划、任务、进度等等 | 沿时间顺序划分阶段，并设置阶段目标/验收标准/任务列表/等等。每次执行任务前后，及时在任务列表里原地更新状态标记（`[ ]`待办 / `[>]`进行中 / `[x]`已完成） | -| worklog.md | 事的角度：按时间线记录的工作日志，方便复盘 | 只追加，每次有变化就记录 | -| userProfile.md | 人的角度：对老板的背景、习惯、偏好的观察总结 | 按需补充，帮助更高效的长期协作 | +| 参考文件名 | 内容定位 | 用法建议 | +| -------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| productLens.md | 产品视角：未来目标、此刻现状、愿景、定位、架构、约束、模块、功能、原则、等等。 | 记录已经存在的事实，也记录尚未实现的 目标。对每一项产品特性，应当区分`[已存在]`、`[待实现]`和`[待评审]`等状态，避免混淆事实和设想。基本框架长期稳定，但每当产品状态变化或认知深化时，及时同步更新。 | +| projectPlan.md | 项目视角：开发计划、任务列表、进度跟踪等。 | 沿时间顺序划分阶段，记录每个阶段的目标、验收标准和任务列表；每次执行任务前后，及时原地更新状态标记（`[ ]`待办，`[>]`进行中，`[x]`已完成）。 | +| worklog.md | 事件视角：工作日志，按时间线记录工作过程与重要变化。 | 记录工作过程、决策、状态、结果等，方便复盘和回溯。持续追加内容，别把它覆写成仅包含当前状态。 | +| userProfile.md | 人的视角：老板的个人背景、习惯、偏好与要求的。 | 随时补充你日常观察到的、或老板主动提供的个性化信息，帮助你和老板之间更流畅、更高效的协作。 | -对新项目，如果 @aimemo/ 是空的，建议先按上表初始化。 +对新项目，如果 `@aimemo/` 是空的，建议先按上表初始化。 ### 自主扩展 @@ -42,7 +42,7 @@ - 方法、函数名：动词开头的 camelCase，例如 `updateUserAvatar()`, `getUserName()`。 - HTML/CSS 的 class、id 名：kebab-case（dash 分隔），例如 `user-center`, `card-header`；JS 中通过 CSS Modules 访问样式时仍用 camelCase（如 `styles.userCenter`），两者由工具自动转换。 - 目录和文件名： - - 首先，我的主规则是用 camelCase 命名目录或文件，例如 `source`, `frontend`, `userCenter.vue`。 + - 首先，主规则是用 camelCase 命名目录或文件，例如 `source`, `frontend`, `userCenter.vue`。 - 其次，如果用来绑定某个名称的具体内容，目录或文件名应当跟随这个名称本身。例如，一个文件用来存放某个类，那就用类名作为文件名，例如 `Creation`; 一个目录用来存放某个仓库，那就用仓库名作为目录名，例如 `CommonTools/`; 一个目录用来服务一个域名，就用域名作为目录名，例如 `blog.tic.cc`; 一个文件用来记录某个日期，就用日期作为文件名，例如 `20260801`。 - 最后，当与流行的规范或惯例有强烈冲突时，遵循该流行惯例。例如，`AGENTS.md`, `.gitignore`。 - 注意，目录、文件名仅大小写不同的（如 `userCenter` 与 `usercenter`）禁止在同一层级同时出现，以避免跨平台冲突，。