From 32c222f241fe1a0de37c9f969f9d5fd234c271b3 Mon Sep 17 00:00:00 2001 From: Alex-larget <33240357+Alex-larget@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:55:22 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E5=BC=80=E5=8F=91=E6=96=87?= =?UTF-8?q?=E6=A1=A3=EF=BC=8C=E8=B0=83=E6=95=B4=E5=9B=A2=E9=98=9F=E8=A7=92?= =?UTF-8?q?=E8=89=B2=E5=8F=8A=E5=85=B6=E6=8A=80=E8=83=BD=E6=8F=8F=E8=BF=B0?= =?UTF-8?q?=EF=BC=8C=E4=BC=98=E5=8C=96=E6=96=87=E6=A1=A3=E7=BB=93=E6=9E=84?= =?UTF-8?q?=E4=BB=A5=E6=98=8E=E7=A1=AE=E5=90=84=E8=A7=92=E8=89=B2=E7=9A=84?= =?UTF-8?q?=E8=B4=A3=E4=BB=BB=E4=B8=8E=E5=8D=8F=E4=BD=9C=E6=B5=81=E7=A8=8B?= =?UTF-8?q?=E3=80=82=E5=A2=9E=E5=BC=BA=E7=BB=8F=E9=AA=8C=E5=BA=93=E5=8A=9F?= =?UTF-8?q?=E8=83=BD=EF=BC=8C=E6=94=AF=E6=8C=81=E7=BB=8F=E9=AA=8C=E5=90=B8?= =?UTF-8?q?=E6=94=B6=E4=B8=8E=E6=8A=80=E8=83=BD=E5=8D=87=E7=BA=A7=EF=BC=8C?= =?UTF-8?q?=E6=8F=90=E5=8D=87=E5=9B=A2=E9=98=9F=E5=8D=8F=E4=BD=9C=E6=95=88?= =?UTF-8?q?=E7=8E=87=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .cursor/README.md | 185 ++++++++-------------- .cursor/docs/开发团队职责定义.md | 2 +- .cursor/docs/角色驱动Skills分析.md | 9 +- .cursor/skills/SKILL-助理橙子-文档同步.md | 22 +-- .cursor/经验库/README.md | 4 +- .cursor/经验库/经验清单.md | 11 +- 6 files changed, 94 insertions(+), 139 deletions(-) diff --git a/.cursor/README.md b/.cursor/README.md index 4bc0db12..f962e8a9 100644 --- a/.cursor/README.md +++ b/.cursor/README.md @@ -1,149 +1,104 @@ # Soul 创业派对 - .cursor 配置说明 -本目录的 rules 与 skills 均为**当前项目（Soul 创业派对）**服务，用于约束开发、防止互窜、减少漏改。 - -**开发团队**：2 前端（小程序开发工程师、管理端开发工程师）+ 1 后端 + 1 产品经理 + 1 助理橙子。开发团队有**经验库**，根据经验自动升级 Skills。完整职责与 Skills 分配见 [开发团队职责定义.md](./docs/开发团队职责定义.md)，经验库见 [经验库 README](./经验库/README.md)。 - -**会话启动自检**：新 Cursor 打开本项目时，应优先执行 soul-project-boundary 中的「会话启动自检」，仅沿用本项目的 rules、skills、开发风格与配置参数，排除无关的全局或其它项目规则。 +本目录的 rules 与 skills 为**开发团队**服务，用于约束开发、防止互窜、经验升级。 --- -## 一、Rules 执行顺序与生效范围 - -| 规则文件 | 生效范围 | alwaysApply | 用途 | -|----------|----------|-------------|------| -| **soul-project-boundary.mdc** | `**`（全项目） | ✅ | 总入口：项目组成、防互窜原则、开发时索引 | -| **soul-change-checklist.mdc** | miniprogram、soul-admin、soul-api | ❌ | 变更后必过：关联层检查清单，防漏改 | -| **assistant-xiaofeng.mdc** | ** | ❌ | 小橙/橙子/橙橙/🍊：讨论后记录并更新开发文档 | -| **soul-miniprogram-boundary.mdc** | miniprogram/**/* | ❌ | 小程序：只调 /api/miniprogram/* | -| **soul-admin-boundary.mdc** | soul-admin/**/* | ❌ | 管理端：只调 /api/admin/*、/api/db/* | -| **soul-api-boundary.mdc** | soul-api/**/*.go | ❌ | soul-api：路由按使用方归类 | -| **soul-api-coding.mdc** | soul-api/**/*.go | ❌ | soul-api：GORM、Model、响应等编码规范 | -| **api-reliability.mdc** | next-project/**/* | ❌ | 仅 next-project 参考（TypeScript/Next API） | -| **product-manager.mdc** | 开发文档/1、需求/、临时需求池/、开发文档/10、项目管理/ | ❌ | 产品经理：需求、验收，加载 SKILL-产品经理 | - -**执行逻辑**：alwaysApply 的规则始终生效；其余按当前编辑文件路径匹配 glob，匹配到的规则同时生效，无先后依赖。 - ---- - -## 二、Skills 索引（按团队角色驱动） - -团队：**小程序开发工程师**、**管理端开发工程师**、**后端开发**、**产品经理**、**助理橙子**。各开发角色在各自端内**必须**遵循对应主 Skill；辅助 Skill 按「何时选用」选用。 - -### 速查：目录/场景 → 角色 → 应加载 Skills - -| 当前编辑目录/场景 | 角色 | 主 Skill | 辅助 Skill（按需） | -|------------------|------|----------|--------------------| -| miniprogram/ | 小程序开发工程师 | SKILL-小程序开发.md | 三端架构 → API开发 → 变更关联检查 | -| soul-admin/ | 管理端开发工程师 | SKILL-管理端开发.md | 三端架构 → API开发 → 变更关联检查 | -| soul-api/ | 后端开发 | SKILL-API开发.md | soul-api-coding → 三端架构 → 变更关联检查 → MySQL直接操作 | -| 开发文档/1、需求/、临时需求池/ | 产品经理 | SKILL-产品经理.md | 需求汇总、运营与变更 | -| 说 小橙、橙子、讨论完毕、记录、同步文档 | 助理橙子 | SKILL-助理橙子-文档同步.md | - | - -**跨端功能开发**：加载 **SKILL-角色流程控制.md**。 -**变更完成**：**必过** **SKILL-变更关联检查.md** + **soul-change-checklist.mdc**。 - -### 快速决策（Agent 执行时） +## 目录结构 ``` -当前编辑目录？ - → miniprogram/ → 主：SKILL-小程序开发 - → soul-admin/ → 主：SKILL-管理端开发 - → soul-api/ → 主：SKILL-API开发 - → 开发文档/1、需求/、临时需求池/ → 主：SKILL-产品经理 - -说 小橙橙子讨论完毕记录同步？ → 主：SKILL-助理橙子-文档同步 - -涉及多端？ → 加载 SKILL-角色流程控制 -改完准备提交？ → 必过 SKILL-变更关联检查 + soul-change-checklist -API 需操作数据库且 MCP 不可用？ → 加载 SKILL-MySQL直接操作 +.cursor/ +├── README.md # 本说明（入口） +├── rules/ # 规则（boundary、checklist、助理） +├── skills/ # Skills（按角色分配） +├── docs/ # 文档（职责定义、边界、分析） +└── 经验库/ # 经验沉淀，用于自动升级 Skills + ├── README.md + └── 经验清单.md ``` --- -### 角色一：小程序开发工程师 +## 开发团队 -| 类型 | Skill | 何时选用 | -|------|-------|----------| -| **主** | SKILL-小程序开发.md | 在 miniprogram/ 下编辑时**必加载** | -| 辅助 1 | SKILL-三端架构与框架分析.md | 拆解/迁移、选用框架语法时 | -| 辅助 2 | SKILL-API开发.md | 对接新接口、确认 miniprogram 路径时 | -| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 | -| 协同 | SKILL-角色流程控制.md | 跨端功能开发（新增/优化）时 | +| 角色 | 负责 | 主 Skill | +|------|------|----------| +| 小程序开发工程师 | miniprogram/ | SKILL-小程序开发.md | +| 管理端开发工程师 | soul-admin/ | SKILL-管理端开发.md | +| 后端开发 | soul-api/ | SKILL-API开发.md | +| 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md | +| 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md | -**负责**：miniprogram/ +**经验库**：用户说「吸收经验」「升级 skills」→ 助理橙子执行入库 + 升级对应 Skill。详见 [经验库 README](./经验库/README.md)。 --- -### 角色二：管理端开发工程师 +## 快速决策 -| 类型 | Skill | 何时选用 | -|------|-------|----------| -| **主** | SKILL-管理端开发.md | 在 soul-admin/ 下编辑时**必加载** | -| 辅助 1 | SKILL-三端架构与框架分析.md | 拆解/迁移、选用框架语法时 | -| 辅助 2 | SKILL-API开发.md | 对接新接口、确认 admin/db 路径时 | -| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 | -| 协同 | SKILL-角色流程控制.md | 跨端功能开发时 | - -**负责**：soul-admin/ +| 编辑/场景 | 加载 | +|-----------|------| +| miniprogram/ | SKILL-小程序开发 + soul-miniprogram-boundary | +| soul-admin/ | SKILL-管理端开发 + soul-admin-boundary | +| soul-api/ | SKILL-API开发 + soul-api-boundary、soul-api-coding | +| 开发文档/1、需求/、临时需求池/ | SKILL-产品经理 | +| 小橙、橙子、讨论完毕、记录、同步文档 | SKILL-助理橙子-文档同步 | +| 吸收经验、升级 skills | 助理橙子：经验入库 + 升级 Skill | +| 跨端功能开发 | SKILL-角色流程控制（流程图见 docs/角色协同流程图.html） | +| 变更完成 | 必过 SKILL-变更关联检查 + soul-change-checklist | --- -### 角色三：后端开发 +## Rules 一览 -| 类型 | Skill | 何时选用 | -|------|-------|----------| -| **主** | SKILL-API开发.md | 在 soul-api/ 下编辑时**必加载** | -| 辅助 1 | soul-api-coding.mdc | 与主 Skill 一致，按 glob 自动生效 | -| 辅助 2 | SKILL-三端架构与框架分析.md | 路由分组、框架约束时 | -| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 | -| 辅助 4 | SKILL-MySQL直接操作.md | MCP 无法连接、需增减字段/执行迁移时 | -| 协同 | SKILL-角色流程控制.md | 跨端功能开发时 | - -**负责**：soul-api/ +| 规则 | 生效范围 | 用途 | +|------|----------|------| +| soul-project-boundary | `**` | 总入口、防互窜、会话自检 | +| soul-change-checklist | miniprogram、soul-admin、soul-api | 变更后必过 | +| assistant-xiaofeng | 触发词 | 小橙：文档同步、经验升级 | +| soul-miniprogram-boundary | miniprogram/** | 只调 /api/miniprogram/* | +| soul-admin-boundary | soul-admin/** | 只调 /api/admin/*、/api/db/* | +| soul-api-boundary | soul-api/**/*.go | 路由按使用方归类 | +| soul-api-coding | soul-api/**/*.go | GORM、Model、响应规范 | +| product-manager | 开发文档/1、需求/、临时需求池/ | 产品经理 | +| api-reliability | next-project/** | 仅 next-project 参考 | --- -### 角色四：产品经理 +## Skills 一览 -| 类型 | Skill | 何时选用 | -|------|-------|----------| -| **主** | SKILL-产品经理.md | 需求分析、需求文档、验收、编辑 开发文档/1、需求/、临时需求池/ 时 | -| 辅助 | 需求汇总、运营与变更 | 查阅需求清单、项目推进表时 | +### 角色主 Skill -**负责**：需求、验收、与开发协调 +| 角色 | 主 Skill | 辅助 Skill | +|------|----------|------------| +| 小程序开发工程师 | SKILL-小程序开发 | 三端架构 → API开发 → 变更关联检查 | +| 管理端开发工程师 | SKILL-管理端开发 | 三端架构 → API开发 → 变更关联检查 | +| 后端开发 | SKILL-API开发 | soul-api-coding → 三端架构 → 变更关联检查 → MySQL直接操作 | +| 产品经理 | SKILL-产品经理 | 需求汇总、运营与变更 | +| 助理橙子 | SKILL-助理橙子-文档同步 | - | + +### 场景 Skill + +| 场景 | Skill | +|------|-------| +| 跨端协同 | SKILL-角色流程控制 | +| 变更检查 | SKILL-变更关联检查、soul-change-checklist | +| 文档同步、经验升级 | SKILL-助理橙子-文档同步 | +| next-project | SKILL-next-project仅预览 | +| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序 | --- -### 角色五：助理橙子 +## 文档索引 -| 类型 | Skill | 何时选用 | -|------|-------|----------| -| **主** | SKILL-助理橙子-文档同步.md | 小橙、橙子、橙橙、🍊、「讨论完毕」「记录一下」「同步到开发文档」 | -| 规则 | assistant-xiaofeng.mdc | 同上 | - -**负责**：讨论后记录、文档同步 +| 文档 | 说明 | +|------|------| +| [开发团队职责定义](./docs/开发团队职责定义.md) | 五角色职责、Skills 分配 | +| [三角色边界定义](./docs/三角色边界定义.md) | 开发三角色源码与业务边界 | +| [角色驱动Skills分析](./docs/角色驱动Skills分析.md) | Skills 组织方式 | +| [经验库 README](./经验库/README.md) | 经验入库、Skills 升级流程 | --- -### 通用 / 场景 Skill +## 会话启动自检 -| 场景 | Skill | 何时选用 | -|------|-------|----------| -| 跨端协同 | SKILL-角色流程控制.md | 开发涉及多端时；流程图见 `.cursor/docs/角色协同流程图.html` | -| 变更检查 | SKILL-变更关联检查.md、soul-change-checklist.mdc | **开发改完必过** | -| 文档同步 | SKILL-助理橙子-文档同步.md | 讨论完毕、记录、同步文档 | -| next-project | SKILL-next-project仅预览.md | 编辑 next-project/ 或需区分线上后端时 | -| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序.md | 拆解 Next.js 全栈时；拆解前必读 SKILL-三端架构与框架分析.md | - -**助理橙子**：当用户说小橙、橙子、橙橙、🍊、「讨论完毕」「记录一下」「同步到开发文档」等时，加载 **SKILL-助理橙子-文档同步.md**，以小橙身份记录讨论要点并更新 `开发文档/`、`临时需求池/`。 - -**Skills 迭代**：开发团队经验库（`.cursor/经验库/`）沉淀经验，根据经验自动升级 Skills。用户说「吸收经验」「升级 skills」时，助理橙子执行：提炼 → 入库 → 更新对应 Skill。修 bug 时若发现规则/流程遗漏，建议写入经验库并升级 Skill。详见 [经验库 README](./经验库/README.md)。 - ---- - -## 三、无冲突、无顺序依赖 - -- 各 boundary 规则按目录互斥（改 miniprogram 不会触发 soul-admin-boundary）。 -- soul-api-boundary 与 soul-api-coding 同作用于 soul-api，内容互补（边界 vs 编码），不冲突。 -- soul-change-checklist 与各 boundary 互补（boundary 管「能做什么」，checklist 管「改完要检查什么」）。 +新 Cursor 打开本项目时，优先执行 soul-project-boundary 中的「会话启动自检」：仅沿用本项目的 rules、skills、开发风格与配置，排除无关规则。 diff --git a/.cursor/docs/开发团队职责定义.md b/.cursor/docs/开发团队职责定义.md index dedd1b19..9338bbf2 100644 --- a/.cursor/docs/开发团队职责定义.md +++ b/.cursor/docs/开发团队职责定义.md @@ -1,6 +1,6 @@ # Soul 创业派对 - 开发团队职责定义 -> **开发团队**：2 前端（小程序开发工程师、管理端开发工程师）+ 1 后端 + 1 产品 + 1 助理。按职责分配 Skills，防止互窜、明确协同。开发团队有**经验库**，根据经验自动升级 Skills。 +> **开发团队**：2 前端 + 1 后端 + 1 产品 + 1 助理。按职责分配 Skills，有**经验库**用于根据经验自动升级 Skills。速查见 [.cursor/README.md](../README.md)。 --- diff --git a/.cursor/docs/角色驱动Skills分析.md b/.cursor/docs/角色驱动Skills分析.md index 9a1fe344..e7f74d3a 100644 --- a/.cursor/docs/角色驱动Skills分析.md +++ b/.cursor/docs/角色驱动Skills分析.md @@ -2,12 +2,13 @@ ## 一、当前方式概述 -Skills 按**五角色**（小程序开发工程师、管理端开发工程师、后端开发、产品经理、助理橙子）组织，每个角色有： +**开发团队**五角色：小程序开发工程师、管理端开发工程师、后端开发、产品经理、助理橙子。Skills 按角色分配： + +> 职责定义：[开发团队职责定义.md](./开发团队职责定义.md) | 源码边界：[三角色边界定义.md](./三角色边界定义.md) | 入口：[.cursor/README.md](../README.md) -> **团队职责**：完整定义见 [开发团队职责定义.md](./开发团队职责定义.md)。开发三角色源码边界见 [三角色边界定义.md](./三角色边界定义.md)。 - **主 Skill**：开发风格与规范（必须遵循） -- **辅助 Skill**：按顺序 1→2→3→4 选用 -- **协同 Skill**：跨端功能开发时使用（开发角色） +- **辅助 Skill**：按需选用 +- **协同 Skill**：跨端时用 SKILL-角色流程控制 --- diff --git a/.cursor/skills/SKILL-助理橙子-文档同步.md b/.cursor/skills/SKILL-助理橙子-文档同步.md index cd3bcf11..2d1ea38a 100644 --- a/.cursor/skills/SKILL-助理橙子-文档同步.md +++ b/.cursor/skills/SKILL-助理橙子-文档同步.md @@ -1,13 +1,17 @@ -# SKILL - 小橙（橙子/橙橙/🍊）：讨论后记录与更新开发文档 +--- +description: 开发团队文档同步与经验升级。小橙、橙子、讨论完毕、吸收经验、升级skills。Use when 小橙, 橙子, 讨论完毕, 记录, 同步文档, 吸收经验, 升级skills. +--- +# SKILL - 助理橙子（小橙/橙子/橙橙/🍊） + +> 开发团队文档同步与经验升级助理。 ## 何时使用 -当用户说以下任一表述时，加载本 Skill 并以小橙身份执行： - -- **唤醒名**：小橙、橙子、橙橙、🍊 -- 「讨论完毕」「记录一下」「同步到开发文档」「更新文档」 -- **「吸收经验」「升级 skills」「记录经验」** → 执行**经验入库 + Skills 升级**流程 -- 「将项目情况同步更新到开发文档」 +| 触发词 | 动作 | +|--------|------| +| 小橙、橙子、橙橙、🍊 | 文档同步 | +| 讨论完毕、记录一下、同步到开发文档、更新文档 | 文档同步 | +| **吸收经验、升级 skills、记录经验** | **经验入库 + Skills 升级** | ## 执行流程 @@ -59,9 +63,7 @@ - 最佳实践 → 补充示例或新章节 - 决策记录 → 补充到相关 Skill 或 boundary -4. **回复**：已吸收经验并升级 Skills，详见 经验库/经验清单.md - -**经验库说明**：见 `.cursor/经验库/README.md`。 +4. **回复**：已吸收经验并升级 Skills，详见 `.cursor/经验库/经验清单.md` ## 文档结构速查 diff --git a/.cursor/经验库/README.md b/.cursor/经验库/README.md index d5414318..be37c2fd 100644 --- a/.cursor/经验库/README.md +++ b/.cursor/经验库/README.md @@ -66,9 +66,7 @@ ``` .cursor/经验库/ ├── README.md # 本说明 -├── 经验清单.md # 经验条目索引（可选） -└── YYYY-MM/ # 按月份归档（可选） - └── xxx.md +└── 经验清单.md # 经验索引 ``` --- diff --git a/.cursor/经验库/经验清单.md b/.cursor/经验库/经验清单.md index 1249a864..2a6dc0b2 100644 --- a/.cursor/经验库/经验清单.md +++ b/.cursor/经验库/经验清单.md @@ -4,19 +4,18 @@ --- -## 索引说明 +## 索引 | 日期 | 类型 | 角色 | 升级 Skill | 摘要 | |------|------|------|------------|------| -| （示例）2026-02-26 | 最佳实践 | 管理端 | SKILL-管理端开发 | SetVipModal 表单弹窗可选+可手动填写 | -| （示例）2026-02-26 | 最佳实践 | 后端 | SKILL-API开发 | vip_roles 新增表/字段完整流程 | +| （待补充） | | | | | --- -## 已吸收经验（示例） +## 已吸收经验 -- **SetVipModal 经验**：已写入 SKILL-管理端开发 4.1 表单弹窗 -- **vip_roles 经验**：已写入 SKILL-API开发 3.2、SKILL-MySQL直接操作 8 +- **SetVipModal**：SKILL-管理端开发 4.1 表单弹窗 +- **vip_roles**：SKILL-API开发 3.2、SKILL-MySQL直接操作 8 ---