把 productGoal 改名为 productLens,以反映它不仅包含未来目标,也包含现有事实。

This commit is contained in:
luk
2026-08-21 13:58:27 +08:00
parent be00d84d5f
commit 8f84c0b07c

View File

@@ -8,20 +8,20 @@
## aimemo ## aimemo
@aimemo/ 目录是你自己的记忆与工作空间,由你**自主掌控、自行管理**。你可以新建、删除、合并、拆分、修改 @aimemo/ 里面的一切子目录和文件,记录一切对长期持续工作有价值的信息,使得工作进度能够跨 sessions、跨 ai models、跨 ai agents 进行下去。 @aimemo/ 目录是你自己的记忆与工作空间,由你**全权自主掌控**。你可以任意处理这里的一切子目录和文件,只要有助于更好的管理和辅助你的工作。记录一切有用的信息,使得工作能够跨 sessions、跨设备、跨 ai models、跨 ai agents 的连续进行下去。持续更新,随时保持和项目里其他内容的同步。
### 基础框架(推荐默认结构) ### 基础框架(推荐默认结构)
建议以四个文件作为基础框架,从四个基本视角覆盖项目: 建议以四个文件作为基础框架,从四个基本视角覆盖项目:
| 记录类型(参考文件名) | 定位 | 用法建议 | | 参考文件名 | 内容定位 | 用法建议 |
| ---------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | -------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| productGoal.md | 产品角度:目标、愿景、架构、规范等等 | 内容比较稳定,随对产品的理解而更新 | | productLens.md | 产品视角:未来目标、此刻现状、愿景、定位、架构、约束、模块、功能、原则、等等。 | 记录已经存在的事实,也记录尚未实现的 目标。对每一项产品特性,应当区分`[已存在]``[待实现]``[待评审]`等状态,避免混淆事实和设想。基本框架长期稳定,但每当产品状态变化或认知深化时,及时同步更新。 |
| projectPlan.md | 项目角:开发计划、任务、进度等等 | 沿时间顺序划分阶段,并设置阶段目标/验收标准/任务列表/等等。每次执行任务前后,及时在任务列表里原地更新状态标记(`[ ]`待办 / `[>]`进行中 / `[x]`已完成) | | projectPlan.md | 项目角:开发计划、任务列表、进度跟踪等。 | 沿时间顺序划分阶段,记录每个阶段目标验收标准任务列表每次执行任务前后,及时原地更新状态标记(`[ ]`待办`[>]`进行中`[x]`已完成) |
| worklog.md | 事的角度:按时间线记录工作日志,方便复盘 | 只追加,每次有变化就记录 | | worklog.md | 事件视角:工作日志,按时间线记录工作过程与重要变化。 | 记录工作过程、决策、状态、结果等,方便复盘和回溯。持续追加内容,别把它覆写成仅包含当前状态。 |
| userProfile.md | 人的角度:对老板的背景、习惯、偏好的观察总结 | 按需补充,帮助更高效的长期协作 | | userProfile.md | 人的视角:老板的个人背景、习惯、偏好与要求的。 | 随时补充你日常观察到的、或老板主动提供的个性化信息,帮助你和老板之间更流畅、更高效的协作。 |
对新项目,如果 @aimemo/ 是空的,建议先按上表初始化。 对新项目,如果 `@aimemo/` 是空的,建议先按上表初始化。
### 自主扩展 ### 自主扩展
@@ -42,7 +42,7 @@
- 方法、函数名:动词开头的 camelCase例如 `updateUserAvatar()`, `getUserName()` - 方法、函数名:动词开头的 camelCase例如 `updateUserAvatar()`, `getUserName()`
- HTML/CSS 的 class、id 名kebab-casedash 分隔),例如 `user-center`, `card-header`JS 中通过 CSS Modules 访问样式时仍用 camelCase`styles.userCenter`),两者由工具自动转换。 - HTML/CSS 的 class、id 名kebab-casedash 分隔),例如 `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` - 其次,如果用来绑定某个名称的具体内容,目录或文件名应当跟随这个名称本身。例如,一个文件用来存放某个类,那就用类名作为文件名,例如 `Creation`; 一个目录用来存放某个仓库,那就用仓库名作为目录名,例如 `CommonTools/`; 一个目录用来服务一个域名,就用域名作为目录名,例如 `blog.tic.cc`; 一个文件用来记录某个日期,就用日期作为文件名,例如 `20260801`
- 最后,当与流行的规范或惯例有强烈冲突时,遵循该流行惯例。例如,`AGENTS.md`, `.gitignore` - 最后,当与流行的规范或惯例有强烈冲突时,遵循该流行惯例。例如,`AGENTS.md`, `.gitignore`
- 注意,目录、文件名仅大小写不同的(如 `userCenter``usercenter`)禁止在同一层级同时出现,以避免跨平台冲突,。 - 注意,目录、文件名仅大小写不同的(如 `userCenter``usercenter`)禁止在同一层级同时出现,以避免跨平台冲突,。