From d79581758bf047021664264bb916a6171736598f Mon Sep 17 00:00:00 2001 From: Alex-larget <33240357+Alex-larget@users.noreply.github.com> Date: Fri, 27 Feb 2026 11:21:20 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E7=BB=8F=E9=AA=8C=E5=BA=93?= =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8C=E6=98=8E=E7=A1=AE=E5=90=84=E8=A7=92?= =?UTF-8?q?=E8=89=B2=E7=9A=84=E7=8B=AC=E7=AB=8B=E6=96=87=E4=BB=B6=E5=A4=B9?= =?UTF-8?q?=E7=BB=93=E6=9E=84=E5=8F=8A=E9=A1=B9=E7=9B=AE=E7=B4=A2=E5=BC=95?= =?UTF-8?q?=E7=9A=84=E6=9B=B4=E6=96=B0=E6=B5=81=E7=A8=8B=EF=BC=8C=E5=A2=9E?= =?UTF-8?q?=E5=BC=BA=E7=BB=8F=E9=AA=8C=E5=90=B8=E6=94=B6=E4=B8=8E=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E5=8D=87=E7=BA=A7=E7=9A=84=E5=8A=9F=E8=83=BD=E3=80=82?= =?UTF-8?q?=E8=B0=83=E6=95=B4=E8=A7=A6=E5=8F=91=E8=AF=8D=E4=BB=A5=E6=94=AF?= =?UTF-8?q?=E6=8C=81=E6=9B=B4=E5=A4=9A=E5=9C=BA=E6=99=AF=EF=BC=8C=E7=A1=AE?= =?UTF-8?q?=E4=BF=9D=E6=96=87=E6=A1=A3=E5=86=85=E5=AE=B9=E4=B8=80=E8=87=B4?= =?UTF-8?q?=E6=80=A7=E5=92=8C=E5=8F=AF=E8=BF=BD=E6=BA=AF=E6=80=A7=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .cursor/README.md | 4 +- .cursor/docs/开发团队职责定义.md | 6 +- .cursor/rules/assistant-xiaofeng.mdc | 6 +- .cursor/rules/product-manager.mdc | 2 +- .cursor/rules/soul-admin-boundary.mdc | 4 +- .cursor/rules/soul-api.mdc | 4 +- .cursor/rules/soul-change-checklist.mdc | 6 +- .cursor/rules/soul-miniprogram-boundary.mdc | 4 +- .cursor/rules/soul-project-boundary.mdc | 28 ++--- .cursor/skills/SKILL-助理橙子-文档同步.md | 76 +++++++++--- .cursor/经验库/README.md | 121 ++++++++++---------- .cursor/经验库/产品/2026-02-26.md | 5 + .cursor/经验库/产品/项目索引.md | 23 ++++ .cursor/经验库/助理橙子/2026-02-26.md | 5 + .cursor/经验库/助理橙子/项目索引.md | 23 ++++ .cursor/经验库/后端/2026-02-26.md | 5 + .cursor/经验库/后端/项目索引.md | 23 ++++ .cursor/经验库/小程序/2026-02-26.md | 5 + .cursor/经验库/小程序/项目索引.md | 23 ++++ .cursor/经验库/管理端/2026-02-26.md | 5 + .cursor/经验库/管理端/项目索引.md | 23 ++++ .cursor/经验库/经验清单.md | 22 +++- 22 files changed, 315 insertions(+), 108 deletions(-) create mode 100644 .cursor/经验库/产品/2026-02-26.md create mode 100644 .cursor/经验库/产品/项目索引.md create mode 100644 .cursor/经验库/助理橙子/2026-02-26.md create mode 100644 .cursor/经验库/助理橙子/项目索引.md create mode 100644 .cursor/经验库/后端/2026-02-26.md create mode 100644 .cursor/经验库/后端/项目索引.md create mode 100644 .cursor/经验库/小程序/2026-02-26.md create mode 100644 .cursor/经验库/小程序/项目索引.md create mode 100644 .cursor/经验库/管理端/2026-02-26.md create mode 100644 .cursor/经验库/管理端/项目索引.md diff --git a/.cursor/README.md b/.cursor/README.md index d60ca0c0..9c4bbe93 100644 --- a/.cursor/README.md +++ b/.cursor/README.md @@ -29,7 +29,7 @@ | 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md | | 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md | -**经验库**：用户说「吸收经验」「升级 skills」→ 助理橙子执行入库 + 升级对应 Skill。详见 [经验库 README](./经验库/README.md)。 +**经验库**：每角色独立文件夹（项目索引 + 按日经验 YYYY-MM-DD.md）。用户说「吸收经验」「升级 skills」→ 入库 + 升级 Skill；说「保存开发进度」→ 更新项目索引（每次保存写日期）。详见 [经验库 README](./经验库/README.md)。 --- @@ -42,7 +42,7 @@ | soul-api/ | `SKILL-API开发.md` | soul-api | | 开发文档/1、需求/、临时需求池/ | `SKILL-产品经理.md` | product-manager | | 小橙、橙子、讨论完毕、记录、同步文档 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng | -| 吸收经验、升级 skills | `SKILL-助理橙子-文档同步.md`（经验入库章节） | assistant-xiaofeng | +| 吸收经验、升级 skills、保存开发进度、更新项目索引 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng | | 跨端功能开发 | `SKILL-角色流程控制.md` | - | | 变更完成 | `SKILL-变更关联检查.md` | soul-change-checklist | diff --git a/.cursor/docs/开发团队职责定义.md b/.cursor/docs/开发团队职责定义.md index e6ed1030..3bc8f5e1 100644 --- a/.cursor/docs/开发团队职责定义.md +++ b/.cursor/docs/开发团队职责定义.md @@ -111,10 +111,12 @@ | 项目 | 说明 | |------|------| -| **位置** | `.cursor/经验库/` | +| **位置** | `.cursor/经验库/`，每角色独立文件夹（小程序/管理端/后端/产品/助理橙子） | +| **项目索引** | 每角色有 `项目索引.md`，根据开发进度做总结、保存进度，**每次保存写日期** | +| **经验存储** | 按天存储，文件名 `YYYY-MM-DD.md`，在对应角色文件夹下 | | **用途** | 沉淀 bug 修复、最佳实践、决策、踩坑；根据经验**自动升级 Skills** | | **触发** | 用户说「吸收经验」「升级 skills」「记录经验」→ 助理橙子执行入库 + 升级 | -| **流程** | 提炼 → 入库（经验清单.md）→ 更新对应 SKILL-xxx.md | +| **流程** | 提炼 → 写入 `{角色}/YYYY-MM-DD.md` → 更新 `{角色}/项目索引.md` → 更新 `经验清单.md` → 升级 SKILL | 详见 [经验库 README](../经验库/README.md)。 diff --git a/.cursor/rules/assistant-xiaofeng.mdc b/.cursor/rules/assistant-xiaofeng.mdc index e73ab9b2..4e552d37 100644 --- a/.cursor/rules/assistant-xiaofeng.mdc +++ b/.cursor/rules/assistant-xiaofeng.mdc @@ -6,11 +6,11 @@ alwaysApply: false # 小橙触发器 -当用户提及**小橙、橙子、橙橙、🍊**，或说**「讨论完毕」「记录一下」「同步到开发文档」「吸收经验」「升级 skills」**时： +当用户提及**小橙、橙子、橙橙、🍊**，或说**「讨论完毕」「记录一下」「同步到开发文档」「更新文档」「吸收经验」「升级 skills」「记录经验」「保存开发进度」「更新项目索引」「记录开发进度」**时： -**必须使用 Read 工具读取 `.cursor/skills/SKILL-助理橙子-文档同步.md` 的完整内容**，然后严格按其流程执行。 +**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` 的完整内容**，然后严格按其流程执行。 ### 行为摘要（供模型快速理解，完整流程以 SKILL 文件为准） 1. **文档同步**：从对话中提炼结论/待办/变更 → 写入 `开发文档/1、需求/需求汇总.md`、`开发文档/10、项目管理/运营与变更.md`、`临时需求池/` 等对应文档 -2. **经验入库**：提炼经验 → 写入 `.cursor/经验库/经验清单.md` → 更新对应 `.cursor/skills/SKILL-xxx.md` +2. **经验入库**：提炼经验 → 写入对应角色的 `.cursor/经验库/{角色}/YYYY-MM-DD.md` → 更新该角色的 `项目索引.md`（写日期）→ 更新 `经验清单.md` → 升级对应 `SKILL-xxx.md` diff --git a/.cursor/rules/product-manager.mdc b/.cursor/rules/product-manager.mdc index 374e2f21..5ced0bd4 100644 --- a/.cursor/rules/product-manager.mdc +++ b/.cursor/rules/product-manager.mdc @@ -8,4 +8,4 @@ alwaysApply: false 当编辑 **开发文档/1、需求/**、**临时需求池/**、**开发文档/10、项目管理/** 时，推断当前角色为**产品经理**。 -**必须使用 Read 工具读取 `.cursor/skills/SKILL-产品经理.md` 的完整内容**，然后按其规范执行需求分析、文档编写、验收标准制定。 +**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-产品经理.md` 的完整内容**，然后按其规范执行需求分析、文档编写、验收标准制定。 diff --git a/.cursor/rules/soul-admin-boundary.mdc b/.cursor/rules/soul-admin-boundary.mdc index 26a1f98c..ef14e1ff 100644 --- a/.cursor/rules/soul-admin-boundary.mdc +++ b/.cursor/rules/soul-admin-boundary.mdc @@ -26,8 +26,8 @@ alwaysApply: false ## Skill 加载（必须执行） -**必须使用 Read 工具读取 `.cursor/skills/SKILL-管理端开发.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。 +**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-管理端开发.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。 -接口实现与路由分组的规范在 `.cursor/rules/soul-api.mdc`（编辑 soul-api 时自动加载）。 +接口实现与路由分组的规范在 `e:\Gongsi\Mycontent\.cursor\rules\soul-api.mdc`（编辑 soul-api 时自动加载）。 违反上述路径或职责边界即视为「互窜」，需纠正后再提交。 diff --git a/.cursor/rules/soul-api.mdc b/.cursor/rules/soul-api.mdc index 400b8426..efb71e6f 100644 --- a/.cursor/rules/soul-api.mdc +++ b/.cursor/rules/soul-api.mdc @@ -1,12 +1,12 @@ --- description: soul-api 路由边界 + 编码规范（合并版，防互窜 + GORM/Gin/响应约定） -globs: soul-api/**/*.go +globs: soul-api/**/* alwaysApply: false --- # soul-api 开发规范 -> **Skill 加载**：编辑 soul-api 代码时，**必须使用 Read 工具读取 `.cursor/skills/SKILL-API开发.md` 的完整内容**，该 Skill 包含业务对接、与前端边界协同等补充约定。本规则侧重编码规范与路由边界。 +> **Skill 加载**：编辑 soul-api 代码时，**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-API开发.md` 的完整内容**，该 Skill 包含业务对接、与前端边界协同等补充约定。本规则侧重编码规范与路由边界。 ## 1. 路由按使用方归类（强制） diff --git a/.cursor/rules/soul-change-checklist.mdc b/.cursor/rules/soul-change-checklist.mdc index a464fce7..5b3ac244 100644 --- a/.cursor/rules/soul-change-checklist.mdc +++ b/.cursor/rules/soul-change-checklist.mdc @@ -30,6 +30,10 @@ alwaysApply: false - **每次**在 miniprogram、soul-admin、soul-api 内完成一轮修改后，**先过一遍上表 + 二**，再视为本次变更完成。 - 若本次变更涉及多端（例如小程序新功能 + 管理端配置页），应在同一次任务内一并完成或明确记录未做项，避免漏改。 -- 更详细的检查流程：**必须使用 Read 工具读取 `.cursor/skills/SKILL-变更关联检查.md` 的完整内容**，按其「以领域为单位思考」的方法逐项确认。 +- 更详细的检查流程：**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-变更关联检查.md` 的完整内容**，按其「以领域为单位思考」的方法逐项确认。 + +## 四、聊天中触发变更检查 + +编码完成后在聊天中说**「变更完成」「检查一下」「准备提交」**，AI 会主动加载本清单 + SKILL-变更关联检查.md 完成核对。**不需要正在编辑文件，直接说触发词即可。** 未通过上述检查即提交视为可能漏改，需补全后再提交。 diff --git a/.cursor/rules/soul-miniprogram-boundary.mdc b/.cursor/rules/soul-miniprogram-boundary.mdc index 79f457d1..41219027 100644 --- a/.cursor/rules/soul-miniprogram-boundary.mdc +++ b/.cursor/rules/soul-miniprogram-boundary.mdc @@ -23,8 +23,8 @@ alwaysApply: false ## Skill 加载（必须执行） -**必须使用 Read 工具读取 `.cursor/skills/SKILL-小程序开发.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。 +**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-小程序开发.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。 -接口实现与路由分组的规范在 `.cursor/rules/soul-api.mdc`（编辑 soul-api 时自动加载）。 +接口实现与路由分组的规范在 `e:\Gongsi\Mycontent\.cursor\rules\soul-api.mdc`（编辑 soul-api 时自动加载）。 违反上述路径或职责边界即视为「互窜」，需纠正后再提交。 diff --git a/.cursor/rules/soul-project-boundary.mdc b/.cursor/rules/soul-project-boundary.mdc index f12dddbd..6b2562b9 100644 --- a/.cursor/rules/soul-project-boundary.mdc +++ b/.cursor/rules/soul-project-boundary.mdc @@ -22,23 +22,25 @@ alwaysApply: true ## 核心原则 - 小程序只调 `/api/miniprogram/*`；管理端只调 `/api/admin/*`、`/api/db/*`；禁止混用。 -- 变更完成必过 **soul-change-checklist.mdc** + 读取 `.cursor/skills/SKILL-变更关联检查.md`。 +- 变更完成必过 soul-change-checklist.mdc；聊天中说「变更完成」「检查一下」「准备提交」时主动触发检查。 ## 角色推断与 Skill 加载（必须执行） 根据当前编辑的目录，**必须使用 Read 工具读取对应的主 Skill 文件完整内容**，然后按其规范执行开发： -| 编辑目录 | 推断角色 | 必须 Read 的主 Skill 文件 | -|----------|----------|---------------------------| -| miniprogram/ | 小程序开发工程师 | `.cursor/skills/SKILL-小程序开发.md` | -| soul-admin/ | 管理端开发工程师 | `.cursor/skills/SKILL-管理端开发.md` | -| soul-api/ | 后端开发 | `.cursor/skills/SKILL-API开发.md` | -| 开发文档/1、需求/、临时需求池/ | 产品经理 | `.cursor/skills/SKILL-产品经理.md` | +| 编辑目录 | 推断角色 | 必须 Read 的主 Skill 文件（绝对路径） | +|----------|----------|---------------------------------------| +| miniprogram/ | 小程序开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-小程序开发.md` | +| soul-admin/ | 管理端开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-管理端开发.md` | +| soul-api/ | 后端开发 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-API开发.md` | +| 开发文档/1、需求/、临时需求池/ | 产品经理 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-产品经理.md` | +| .cursor/ | 助理橙子 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` | -| 场景触发词 | 必须 Read 的 Skill 文件 | -|------------|-------------------------| -| 小橙、橙子、讨论完毕、记录、同步文档 | `.cursor/skills/SKILL-助理橙子-文档同步.md` | -| 吸收经验、升级 skills | `.cursor/skills/SKILL-助理橙子-文档同步.md`（经验入库章节） | -| 跨端功能开发 | `.cursor/skills/SKILL-角色流程控制.md` | +| 场景触发词 | 必须 Read 的 Skill 文件（绝对路径） | +|------------|-------------------------------------| +| 小橙、橙子、橙橙、🍊、讨论完毕、记录一下、记录、同步文档 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` | +| 吸收经验、升级 skills、记录经验、保存开发进度、更新项目索引、记录开发进度 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` | +| 跨端功能开发 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-角色流程控制.md` | +| 变更完成、检查一下、准备提交 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-变更关联检查.md` | -**注意**：「必须 Read」= 使用 Read 工具读取文件完整内容后执行，不可跳过或仅凭记忆。 +**注意**：「必须 Read」= 使用 Read 工具读取**绝对路径**的完整文件内容后执行，不可跳过或仅凭记忆。 diff --git a/.cursor/skills/SKILL-助理橙子-文档同步.md b/.cursor/skills/SKILL-助理橙子-文档同步.md index 2d1ea38a..324dbd0b 100644 --- a/.cursor/skills/SKILL-助理橙子-文档同步.md +++ b/.cursor/skills/SKILL-助理橙子-文档同步.md @@ -1,5 +1,5 @@ --- -description: 开发团队文档同步与经验升级。小橙、橙子、讨论完毕、吸收经验、升级skills。Use when 小橙, 橙子, 讨论完毕, 记录, 同步文档, 吸收经验, 升级skills. +description: 开发团队文档同步与经验升级。小橙、橙子、橙橙、讨论完毕、吸收经验、升级skills、保存开发进度、更新项目索引。Use when 小橙, 橙子, 橙橙, 讨论完毕, 记录一下, 同步文档, 吸收经验, 升级skills, 记录经验, 保存开发进度, 更新项目索引, 记录开发进度. --- # SKILL - 助理橙子（小橙/橙子/橙橙/🍊） @@ -12,6 +12,7 @@ description: 开发团队文档同步与经验升级。小橙、橙子、讨论 | 小橙、橙子、橙橙、🍊 | 文档同步 | | 讨论完毕、记录一下、同步到开发文档、更新文档 | 文档同步 | | **吸收经验、升级 skills、记录经验** | **经验入库 + Skills 升级** | +| **保存开发进度、更新项目索引、记录开发进度** | **更新对应角色的 项目索引.md**（写日期） | ## 执行流程 @@ -44,26 +45,68 @@ description: 开发团队文档同步与经验升级。小橙、橙子、讨论 - 若新建了 `临时需求池/xxx.md`，在需求汇总或运营与变更中可引用 - 若更新了需求清单，检查项目落地推进表是否需要同步 +### 4.5 保存开发进度（更新项目索引） + +当用户说**「保存开发进度」「更新项目索引」「记录开发进度」**时，执行： + +1. **确定角色**：根据本次对话涉及目录（miniprogram/soul-admin/soul-api/需求文档）推断对应角色 +2. **提炼进度**：从对话中提取本次开发完成的内容、当前阶段、待续项 +3. **更新项目索引**：打开 `e:\Gongsi\Mycontent\.cursor\经验库\{文件夹名}\项目索引.md`（文件夹名见步骤 5.1 映射表） + - 在「开发进度」表追加一行，**必须写日期**（YYYY-MM-DD） + - 视需要更新「项目总结」段落 + - 文末「最后更新」改为当前日期 +4. **回复**：已保存开发进度至 `经验库\{文件夹名}\项目索引.md` + ### 5. 经验吸收与 Skills 升级（开发团队经验库） 当用户说**「吸收经验」「升级 skills」「记录经验」**时，执行： +#### 5.1 角色→经验库文件夹名映射（必须按此对应） + +| 推断角色 | 经验库文件夹名 | 示例路径 | +|----------|---------------|----------| +| 小程序开发工程师 | `小程序` | `e:\Gongsi\Mycontent\.cursor\经验库\小程序\` | +| 管理端开发工程师 | `管理端` | `e:\Gongsi\Mycontent\.cursor\经验库\管理端\` | +| 后端开发 | `后端` | `e:\Gongsi\Mycontent\.cursor\经验库\后端\` | +| 产品经理 | `产品` | `e:\Gongsi\Mycontent\.cursor\经验库\产品\` | +| 助理橙子 | `助理橙子` | `e:\Gongsi\Mycontent\.cursor\经验库\助理橙子\` | + +#### 5.2 跨端经验写入规则 + +- 若经验**仅影响一个角色**：写入该角色文件夹，如 `后端/2026-02-26.md` +- 若经验**同时影响多角色**（如 API 变更联动前端）： + - 按**主要影响角色**写入一个文件夹 + - 在经验条目中注明「同时影响：小程序/管理端」 + - 分别更新各角色的项目索引 +- 判断主要角色原则：谁的 Skill/规范因此次经验需要升级，谁就是主要角色 + +#### 5.3 执行步骤 + 1. **提炼经验**：从对话中提取 - 问题/场景 - 解决方案 - - 适用角色（小程序/管理端/后端/产品） + - 适用角色（用上方映射表确定文件夹名） - 应升级的 Skill -2. **入库**：写入 `.cursor/经验库/` - - 追加到 `经验清单.md` 索引 - - 或新建 `YYYY-MM/xxx.md` 详细条目 +2. **写入经验文件**（绝对路径）： + - 路径：`e:\Gongsi\Mycontent\.cursor\经验库\{文件夹名}\YYYY-MM-DD.md` + - 当天文件不存在则新建；文件名用日期，经验按天存储 -3. **升级 Skill**：根据经验类型，更新对应 `.cursor/skills/SKILL-xxx.md` +3. **更新项目索引**（绝对路径）： + - 路径：`e:\Gongsi\Mycontent\.cursor\经验库\{文件夹名}\项目索引.md` + - 在「开发进度」表追加一行，**必须写日期**（YYYY-MM-DD） + - 更新文末「最后更新」为当前日期 + +4. **更新经验清单**： + - 路径：`e:\Gongsi\Mycontent\.cursor\经验库\经验清单.md` + - 在索引表追加一行 + +5. **升级 Skill**：根据经验类型，更新对应 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-xxx.md` - bug 修复 → 补充规则/流程/常见问题 - 最佳实践 → 补充示例或新章节 - 决策记录 → 补充到相关 Skill 或 boundary -4. **回复**：已吸收经验并升级 Skills，详见 `.cursor/经验库/经验清单.md` +6. **回复**：已吸收经验并升级 Skills，详见 `经验库\{文件夹名}\YYYY-MM-DD.md` 与 `经验清单.md` ## 文档结构速查 @@ -75,9 +118,14 @@ description: 开发团队文档同步与经验升级。小橙、橙子、讨论 │ ├── 项目落地推进表.md # 里程碑、永平落地 │ └── 运营与变更.md # 近期更新、变更记录 临时需求池/ # 需求分析、技术分析、待办 -.cursor/经验库/ # 开发团队经验沉淀，用于升级 Skills +.cursor/经验库/ # 每角色独立经验库，经验按天存储 ├── README.md # 经验库说明、入库流程 -└── 经验清单.md # 经验索引 +├── 经验清单.md # 跨角色经验索引 +├── 小程序/项目索引.md、YYYY-MM-DD.md +├── 管理端/项目索引.md、YYYY-MM-DD.md +├── 后端/项目索引.md、YYYY-MM-DD.md +├── 产品/项目索引.md、YYYY-MM-DD.md +└── 助理橙子/项目索引.md、YYYY-MM-DD.md ``` ## 示例 @@ -99,7 +147,9 @@ description: 开发团队文档同步与经验升级。小橙、橙子、讨论 **小橙**执行： -1. 提炼：本次 bug 修复发现「支付回调需以 openId 解析买家，不信任 attach.userId」 -2. 入库：追加到 `.cursor/经验库/经验清单.md` -3. 升级：在 SKILL-API开发 或 相关部署文档中补充该规则 -4. 回复：已吸收经验并升级 Skills，详见 经验库/经验清单.md +1. 提炼：本次 bug 修复发现「支付回调需以 openId 解析买家，不信任 attach.userId」→ 适用角色：后端 +2. 写入经验：追加到 `.cursor/经验库/后端/2026-02-26.md` +3. 更新项目索引：在 `后端/项目索引.md` 的「开发进度」表追加一行，写日期 +4. 更新经验清单：在 `经验清单.md` 索引表追加 +5. 升级 Skill：在 SKILL-API开发 或 相关部署文档中补充该规则 +6. 回复：已吸收经验并升级 Skills，详见 经验库/后端/2026-02-26.md diff --git a/.cursor/经验库/README.md b/.cursor/经验库/README.md index be37c2fd..e407d7f1 100644 --- a/.cursor/经验库/README.md +++ b/.cursor/经验库/README.md @@ -1,74 +1,71 @@ # 开发团队经验库 -> 开发团队（小程序开发工程师、管理端开发工程师、后端开发、产品经理、助理橙子）的集体经验沉淀，用于**根据经验自动升级 Skills**。 +> 每个角色拥有独立的经验库文件夹、项目索引；经验按天存储在单文件中，文件名用日期命名。 --- -## 一、用途 - -| 用途 | 说明 | -|------|------| -| **沉淀经验** | 记录 bug 修复、决策、最佳实践、踩坑与规避 | -| **升级 Skills** | 经验入库后，对应更新 `.cursor/skills/` 下相关 Skill，避免同类问题复现 | -| **可追溯** | 每条经验可关联日期、角色、相关 Skill | - ---- - -## 二、经验类型 - -| 类型 | 说明 | 升级目标 | -|------|------|----------| -| **bug 修复** | 修 bug 时发现的规则/流程遗漏 | 对应角色主 Skill、变更关联检查 | -| **最佳实践** | 表单、列表、路由等实现模式 | SKILL-管理端开发、SKILL-API开发 等 | -| **决策记录** | 技术选型、接口约定、边界决策 | 相关 Skill、boundary、开发文档 | -| **踩坑规避** | 已知坑及规避方式 | 对应 Skill 的「常见问题」或新章节 | - ---- - -## 三、经验入库流程 - -``` -1. 触发：用户说「吸收经验」「升级 skills」「记录经验」或讨论完毕时主动提炼 -2. 提炼：从对话中提取 问题/场景、解决方案、适用角色 -3. 入库：写入 经验库/YYYY-MM-xxx.md 或追加到 经验库/经验清单.md -4. 升级：根据经验类型，更新对应 .cursor/skills/SKILL-xxx.md -``` - -**执行者**：助理橙子（SKILL-助理橙子-文档同步）在「吸收经验、升级 skills」时执行完整流程。 - ---- - -## 四、经验条目格式 - -```markdown -## YYYY-MM-DD | 标题 - -- **类型**：bug 修复 / 最佳实践 / 决策记录 / 踩坑规避 -- **角色**：小程序 / 管理端 / 后端 / 产品 -- **升级 Skill**：SKILL-xxx.md -- **内容**：问题描述、解决方案、补充到 Skill 的要点 -``` - ---- - -## 五、自动升级触发 - -| 触发词 | 动作 | -|--------|------| -| 吸收经验、升级 skills、记录经验 | 助理橙子执行：提炼 → 入库 → 升级 Skill | -| 讨论完毕、记录一下 | 若有可沉淀经验，提示「是否吸收经验并升级 Skills」 | -| 修 bug 完成 | 若发现规则/流程遗漏，建议写入经验库并更新 Skill | - ---- - -## 六、目录结构 +## 一、目录结构 ``` .cursor/经验库/ -├── README.md # 本说明 -└── 经验清单.md # 经验索引 +├── README.md # 本说明 +├── 经验清单.md # 跨角色经验索引（汇总） +├── 小程序/ +│ ├── 项目索引.md # 项目总结、开发进度（每次保存写日期） +│ └── YYYY-MM-DD.md # 按天存储的经验 +├── 管理端/ +│ ├── 项目索引.md +│ └── YYYY-MM-DD.md +├── 后端/ +│ ├── 项目索引.md +│ └── YYYY-MM-DD.md +├── 产品/ +│ ├── 项目索引.md +│ └── YYYY-MM-DD.md +└── 助理橙子/ + ├── 项目索引.md + └── YYYY-MM-DD.md ``` --- -**更新日期**：2026-02 +## 二、项目索引（每角色一份） + +| 文件 | 用途 | 约定 | +|------|------|------| +| `{角色}/项目索引.md` | 根据开发进度对项目做总结，保存开发进度，方便下次继续开发 | **每次保存必须写日期**；含「项目总结」「开发进度」表 | + +--- + +## 三、经验存储（按天） + +| 规则 | 说明 | +|------|------| +| **文件名** | `YYYY-MM-DD.md`（日期） | +| **位置** | 对应角色文件夹下 | +| **内容** | 当日经验条目：类型、摘要、升级 Skill | + +--- + +## 四、经验类型与升级目标 + +| 类型 | 说明 | 升级目标 | +|------|------|----------| +| bug 修复 | 修 bug 时发现的规则/流程遗漏 | 对应角色主 Skill、变更关联检查 | +| 最佳实践 | 表单、列表、路由等实现模式 | SKILL-xxx | +| 决策记录 | 技术选型、接口约定、边界决策 | 相关 Skill、boundary | +| 踩坑规避 | 已知坑及规避方式 | 对应 Skill 的「常见问题」 | + +--- + +## 五、入库流程（助理橙子执行） + +1. **提炼**：从对话中提取问题/场景、解决方案、适用角色、应升级的 Skill +2. **写入经验**：追加到对应角色的 `YYYY-MM-DD.md`（当天文件，不存在则新建） +3. **更新项目索引**：在对应角色的 `项目索引.md` 的「开发进度」表追加一行，**写日期** +4. **更新经验清单**：在根目录 `经验清单.md` 索引表追加 +5. **升级 Skill**：根据经验类型，更新对应 `.cursor/skills/SKILL-xxx.md` + +--- + +**更新日期**：2026-02-26 diff --git a/.cursor/经验库/产品/2026-02-26.md b/.cursor/经验库/产品/2026-02-26.md new file mode 100644 index 00000000..de5d3f9e --- /dev/null +++ b/.cursor/经验库/产品/2026-02-26.md @@ -0,0 +1,5 @@ +# 2026-02-26 | 产品经验 + +> 本日经验条目，格式：类型 | 摘要 | 升级 Skill + +--- diff --git a/.cursor/经验库/产品/项目索引.md b/.cursor/经验库/产品/项目索引.md new file mode 100644 index 00000000..61f57477 --- /dev/null +++ b/.cursor/经验库/产品/项目索引.md @@ -0,0 +1,23 @@ +# 产品 - 项目索引 + +> 根据开发进度对项目做总结，保存开发进度，方便下次继续开发。**每次保存必须写日期**。 + +--- + +## 项目总结 + +Soul 创业派对产品定位：面向创业者的社区/工具型小程序。核心需求文档在 `开发文档/1、需求/需求汇总.md`，项目推进表在 `开发文档/10、项目管理/项目落地推进表.md`，临时需求/分析在 `临时需求池/`。 + +--- + +## 开发进度 + +| 日期 | 摘要 | 状态 | +|------|------|------| +| 2026-02-26 | 项目索引初始化，.cursor 规则优化完成 | 已完成 | + +> **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置 + +--- + +**最后更新**：2026-02-26 diff --git a/.cursor/经验库/助理橙子/2026-02-26.md b/.cursor/经验库/助理橙子/2026-02-26.md new file mode 100644 index 00000000..41a5d0e5 --- /dev/null +++ b/.cursor/经验库/助理橙子/2026-02-26.md @@ -0,0 +1,5 @@ +# 2026-02-26 | 助理橙子经验 + +> 本日经验条目，格式：类型 | 摘要 | 升级 Skill + +--- diff --git a/.cursor/经验库/助理橙子/项目索引.md b/.cursor/经验库/助理橙子/项目索引.md new file mode 100644 index 00000000..3b67ae34 --- /dev/null +++ b/.cursor/经验库/助理橙子/项目索引.md @@ -0,0 +1,23 @@ +# 助理橙子 - 项目索引 + +> 根据开发进度对项目做总结，保存开发进度，方便下次继续开发。**每次保存必须写日期**。 + +--- + +## 项目总结 + +助理橙子负责开发团队文档同步与经验升级。触发词：小橙/橙子/橙橙/🍊。核心流程文件：`SKILL-助理橙子-文档同步.md`。经验库结构：每角色独立文件夹 + 按日文件 + 项目索引。 + +--- + +## 开发进度 + +| 日期 | 摘要 | 状态 | +|------|------|------| +| 2026-02-26 | 项目索引初始化；经验库五角色目录结构搭建；SKILL 补充角色映射表与跨端写入规则 | 已完成 | + +> **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置 + +--- + +**最后更新**：2026-02-26 diff --git a/.cursor/经验库/后端/2026-02-26.md b/.cursor/经验库/后端/2026-02-26.md new file mode 100644 index 00000000..b83c7b44 --- /dev/null +++ b/.cursor/经验库/后端/2026-02-26.md @@ -0,0 +1,5 @@ +# 2026-02-26 | 后端经验 + +> 本日经验条目，格式：类型 | 摘要 | 升级 Skill + +--- diff --git a/.cursor/经验库/后端/项目索引.md b/.cursor/经验库/后端/项目索引.md new file mode 100644 index 00000000..9d25c231 --- /dev/null +++ b/.cursor/经验库/后端/项目索引.md @@ -0,0 +1,23 @@ +# 后端 - 项目索引 + +> 根据开发进度对项目做总结，保存开发进度，方便下次继续开发。**每次保存必须写日期**。 + +--- + +## 项目总结 + +soul-api（Go + Gin + GORM + MySQL）提供三组路由：`/api/miniprogram/*`（小程序）、`/api/admin/*` + `/api/db/*`（管理端）、`/api/payment/*`（支付回调）。微信生态通过 PowerWeChat 集成。当前核心模块：用户、订单、分销、VIP、提现、章节、配置。 + +--- + +## 开发进度 + +| 日期 | 摘要 | 状态 | +|------|------|------| +| 2026-02-26 | 项目索引初始化，.cursor 规则优化完成 | 已完成 | + +> **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置 + +--- + +**最后更新**：2026-02-26 diff --git a/.cursor/经验库/小程序/2026-02-26.md b/.cursor/经验库/小程序/2026-02-26.md new file mode 100644 index 00000000..4f28916a --- /dev/null +++ b/.cursor/经验库/小程序/2026-02-26.md @@ -0,0 +1,5 @@ +# 2026-02-26 | 小程序经验 + +> 本日经验条目，格式：类型 | 摘要 | 升级 Skill + +--- diff --git a/.cursor/经验库/小程序/项目索引.md b/.cursor/经验库/小程序/项目索引.md new file mode 100644 index 00000000..cd875f3d --- /dev/null +++ b/.cursor/经验库/小程序/项目索引.md @@ -0,0 +1,23 @@ +# 小程序 - 项目索引 + +> 根据开发进度对项目做总结，保存开发进度，方便下次继续开发。**每次保存必须写日期**。 + +--- + +## 项目总结 + +小程序（微信原生）C 端主要功能：用户注册/登录、VIP 购买、章节阅读、分销推荐、提现申请、找伙伴。当前已上线核心功能，持续迭代优化中。 + +--- + +## 开发进度 + +| 日期 | 摘要 | 状态 | +|------|------|------| +| 2026-02-26 | 项目索引初始化，.cursor 规则优化完成 | 已完成 | + +> **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置 + +--- + +**最后更新**：2026-02-26 diff --git a/.cursor/经验库/管理端/2026-02-26.md b/.cursor/经验库/管理端/2026-02-26.md new file mode 100644 index 00000000..90eb313c --- /dev/null +++ b/.cursor/经验库/管理端/2026-02-26.md @@ -0,0 +1,5 @@ +# 2026-02-26 | 管理端经验 + +> 本日经验条目，格式：类型 | 摘要 | 升级 Skill + +--- diff --git a/.cursor/经验库/管理端/项目索引.md b/.cursor/经验库/管理端/项目索引.md new file mode 100644 index 00000000..274f733a --- /dev/null +++ b/.cursor/经验库/管理端/项目索引.md @@ -0,0 +1,23 @@ +# 管理端 - 项目索引 + +> 根据开发进度对项目做总结，保存开发进度，方便下次继续开发。**每次保存必须写日期**。 + +--- + +## 项目总结 + +管理端（React + Vite + Tailwind）主要功能：用户管理、订单管理、提现审核、VIP 管理、内容/章节管理、配置项管理、数据统计。调用 `/api/admin/*` 与 `/api/db/*` 接口，JWT Bearer 鉴权。 + +--- + +## 开发进度 + +| 日期 | 摘要 | 状态 | +|------|------|------| +| 2026-02-26 | 项目索引初始化，.cursor 规则优化完成 | 已完成 | + +> **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置 + +--- + +**最后更新**：2026-02-26 diff --git a/.cursor/经验库/经验清单.md b/.cursor/经验库/经验清单.md index 2a6dc0b2..f002da84 100644 --- a/.cursor/经验库/经验清单.md +++ b/.cursor/经验库/经验清单.md @@ -1,22 +1,34 @@ # 开发团队经验清单 -> 经验入库后在此索引，便于追溯与升级 Skills。 +> 跨角色经验索引，便于追溯与升级 Skills。各角色详情在 `{角色}/YYYY-MM-DD.md`、`{角色}/项目索引.md`。 --- -## 索引 +## 各角色经验库 -| 日期 | 类型 | 角色 | 升级 Skill | 摘要 | +| 角色 | 项目索引 | 按日经验 | +|------|----------|----------| +| 小程序 | [小程序/项目索引.md](./小程序/项目索引.md) | 小程序/YYYY-MM-DD.md | +| 管理端 | [管理端/项目索引.md](./管理端/项目索引.md) | 管理端/YYYY-MM-DD.md | +| 后端 | [后端/项目索引.md](./后端/项目索引.md) | 后端/YYYY-MM-DD.md | +| 产品 | [产品/项目索引.md](./产品/项目索引.md) | 产品/YYYY-MM-DD.md | +| 助理橙子 | [助理橙子/项目索引.md](./助理橙子/项目索引.md) | 助理橙子/YYYY-MM-DD.md | + +--- + +## 索引表 + +| 日期 | 角色 | 类型 | 升级 Skill | 摘要 | |------|------|------|------------|------| | （待补充） | | | | | --- -## 已吸收经验 +## 已吸收经验（历史） - **SetVipModal**：SKILL-管理端开发 4.1 表单弹窗 - **vip_roles**：SKILL-API开发 3.2、SKILL-MySQL直接操作 8 --- -**更新日期**：2026-02 +**最后更新**：2026-02-26