chore(.cursor): 同步 rules/skills/docs 与 karuo-party（排除凭证）；补充 .gitignore

Made-with: Cursor
2026-03-20 18:41:30 +08:00
parent 939e9cc6b7
commit 17ce20c8ee
39 changed files with 2385 additions and 245 deletions
--- a/.cursor/README.md
+++ b/.cursor/README.md
@@ -1,127 +1,21 @@
-# Soul 创业派对 - .cursor 配置说明
+# Soul 创业派对 · `.cursor` 速览

-本目录按 **cursor标准模板** 重构，rules、skills、agent 为**开发团队**服务，用于约束开发、防止互窜、经验升级。
+## 路径约定

---
+- 所有 Skill、会议纪要、agent 经验路径均以 **本 Git 仓库根** 为基准（与 `miniprogram/`、`soul-api/` 同级）。
+- Rules 中「必须 Read」的路径形如 `.cursor/skills/{name}/SKILL.md`。
+- Python 脚本统一可用 `config/paths.py` 的 `ROOT`、`SKILLS`、`AGENT`、`MEETING`。

-## 目录结构
+## 入口优先级

-```
-.cursor/
-├── README.md                 # 本说明（入口）
-├── config/                   # 配置（paths.py、workspace.txt、model_switch.json）
-├── rules/                    # 规则（boundary、checklist、助理、会议、老板分身-索引）
-├── skills/                   # Skills（按角色分配）
-├── agent/                    # 智能体（标准开发团队结构）
-│   ├── 老板分身/             # 最高权限，协调所有角色
-│   ├── 开发助理/             # 规则进化、通用经验、项目索引、bat 入口
-│   │   ├── evolution/        # 通用经验池
-│   │   ├── script/           # 一键-列出经验池.bat、一键-添加经验.bat 等
-│   │   └── 项目索引/         # 各角色开发进度（小程序.md、管理端.md 等）
-│   ├── 小程序开发工程师/
-│   ├── 管理端开发工程师/
-│   ├── 后端工程师/
-│   ├── 产品经理/
-│   ├── 软件测试/
-│   └── 团队/                 # 跨角色共享经验
-├── scripts/                  # 共享脚本（evolution.py、经验模板.md、db-exec）
-├── docs/                     # 文档（职责定义、边界、分析）
-├── process/                  # 工作流
-├── meeting/                  # 会议纪要（橙子生成）
-└── archive/                  # 历史归档
-```
+1. **三端开发**：`rules/soul-project-boundary.mdc` + `skills/*-dev` / `change-checklist`。
+2. **派对 AI**：若存在仓库根目录 `派对AI/`，可补充读其 `BOOTSTRAP.md`；与 `.cursor` 冲突时 **以 `.cursor` 三端约定为准**（见 `rules/party-ai-dev.mdc`）。

---
+## 噪声与体积

-## 开发团队
+- `meeting/`、`agent/`：历史纪要/evolution 会增多，属正常；需要时可按月归档到子目录或压缩备份。
+- `scripts/db-exec/node_modules/`：已在 `.cursorignore` 与 `.gitignore` 中排除，首次使用在 `db-exec` 下执行 `npm install`。

-| 角色 | 负责 | 主 Skill | Agent 目录 |
-|------|------|----------|------------|
-| 小程序开发工程师 | miniprogram/ | SKILL-小程序开发.md | agent/小程序开发工程师/ |
-| 管理端开发工程师 | soul-admin/ | SKILL-管理端开发.md | agent/管理端开发工程师/ |
-| 后端开发 | soul-api/ | SKILL-API开发.md | agent/后端工程师/ |
-| 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md | agent/产品经理/ |
-| 测试人员 | miniprogram、soul-admin、soul-api | SKILL-测试.md | agent/软件测试/ |
-| 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md | agent/开发助理/ |
+## 文档

-**经验**：每角色 `agent/{角色}/evolution/`，团队共享 `agent/团队/evolution/`。用户说「吸收经验」「升级 skills」→ 入库 + 升级 Skill；说「保存开发进度」「任务完成」→ 更新 `agent/开发助理/项目索引/{角色}.md`。
-
---
-
-## 快速决策（必须 Read = 使用 Read 工具读取完整内容）
-
-| 编辑/场景 | 必须 Read 的 Skill | 自动加载的 Rule |
-|-----------|-------------------|----------------|
-| miniprogram/ | `SKILL-小程序开发.md` | soul-miniprogram-boundary |
-| soul-admin/ | `SKILL-管理端开发.md` | soul-admin-boundary |
-| soul-api/ | `SKILL-API开发.md` | soul-api |
-| 开发文档/1、需求/、临时需求池/ | `SKILL-产品经理.md` | product-manager |
-| 测试、测试用例、回归测试、功能测试、QA | `SKILL-测试.md` | - |
-| 小橙、橙子、讨论完毕、记录、同步文档 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng |
-| 吸收经验、升级 skills、保存开发进度、任务完成、搞定了 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng |
-| 跨端功能开发 | `SKILL-角色流程控制.md` | - |
-| 变更完成 | `SKILL-变更关联检查.md` | soul-change-checklist |
-| 开个会、团队会议、需求评审、方案讨论 | `SKILL-团队会议.md` | soul-meeting |
-| 会议结束、散会 | `SKILL-助理橙子-文档同步.md`（会议收尾） | soul-meeting |
-
---
-
-## Rules 一览
-
-| 规则 | 生效范围 | 用途 |
-|------|----------|------|
-| soul-project-boundary | `**`（alwaysApply） | 项目组成、核心原则、会话自检 |
-| 老板分身-索引 | `**`（alwaysApply） | 经验自动收集、Soul 角色推断、编码习惯 |
-| soul-change-checklist | miniprogram、soul-admin、soul-api | 变更后必过 |
-| assistant-xiaofeng | 触发词 | 小橙触发器 → SKILL-助理橙子-文档同步 |
-| soul-miniprogram-boundary | miniprogram/** | 只调 /api/miniprogram/* |
-| soul-admin-boundary | soul-admin/** | 只调 /api/admin/*、/api/db/* |
-| soul-api | soul-api/** | 路由边界 + 编码规范（合并版） |
-| product-manager | 开发文档/1、需求/、临时需求池/ | 产品经理 glob 触发 |
-| soul-meeting | 触发词 | 开个会、团队会议、需求评审 → SKILL-团队会议 |
-
---
-
-## Skills 一览
-
-### 角色主 Skill
-
-| 角色 | 主 Skill | 辅助 Skill |
-|------|----------|------------|
-| 小程序开发工程师 | SKILL-小程序开发 | 三端架构 → API开发 → 变更关联检查 |
-| 管理端开发工程师 | SKILL-管理端开发 | 三端架构 → API开发 → 变更关联检查 |
-| 后端开发 | SKILL-API开发 | soul-api 规范 → 三端架构 → 变更关联检查 → MySQL直接操作 |
-| 产品经理 | SKILL-产品经理 | 需求汇总、运营与变更 |
-| 测试人员 | SKILL-测试 | 变更关联检查、小程序/管理端/API 规范 |
-| 助理橙子 | SKILL-助理橙子-文档同步 | - |
-
-### 场景 Skill
-
-| 场景 | Skill |
-|------|-------|
-| 跨端协同 | SKILL-角色流程控制 |
-| 变更检查 | SKILL-变更关联检查、soul-change-checklist |
-| 文档同步、经验升级 | SKILL-助理橙子-文档同步 |
-| **多角色会议** | **SKILL-团队会议** |
-| next-project | SKILL-next-project仅预览 |
-| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序 |
-
---
-
-## 文档与脚本
-
-| 文档 | 说明 |
-|------|------|
-| [开发团队职责定义](./docs/开发团队职责定义.md) | 六角色职责、Skills 分配 |
-| [三角色边界定义](./docs/三角色边界定义.md) | 开发三角色源码与业务边界 |
-| [config/目录地图](./config/目录地图.md) | paths.py 路径别名 |
-| [meeting/](./meeting/) | 会议纪要（橙子生成） |
-| [经验清单](./agent/开发助理/经验清单.md) | 跨角色经验索引 |
-| evolution 脚本 | `python .cursor/scripts/evolution.py list` 列出经验池；`add --stdin` 添加经验 |
-| 一键 bat | `agent/开发助理/script/一键-列出经验池.bat` 等 |
-
---
-
-## 会话启动自检
-
-新 Cursor 打开本项目时，优先执行 soul-project-boundary 中的「会话启动自检」：仅沿用本项目的 rules、skills、开发风格与配置，排除无关规则。
+- 架构与迭代说明：`docs/cursor规则与架构分析及优化建议.md`