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

Made-with: Cursor

.cursor/docs/cursor规则与架构分析及优化建议.md

@@ -0,0 +1,156 @@
+# Soul 创业派对 · .cursor 规则与架构分析及优化建议
+
+> 分析日期：2026-03-19  
+> 范围：`.cursor/` 下 rules、skills、agent、config、meeting、scripts  
+> **2026-03-20**：已批量将 `e:\Gongsi\...` 改为仓库相对路径 `.cursor/...`；`party-ai-dev.mdc` 已补充与 `.cursor` 的优先级；根目录 `.gitignore` 已忽略 `karuo-party/credentials/`；新增 `.cursor/README.md`、`.cursorignore`（db-exec node_modules）。
+
+---
+
+## 整体架构图
+
+![Soul 项目与 .cursor 架构](./soul-project-cursor-architecture.png)
+
+---
+
+## 一、整体架构总览
+
+### 1.1 项目与 .cursor 的关系
+
+```
+项目根（一场soul的创业实验-永平）
+├── miniprogram/           # 微信原生小程序 C 端 → /api/miniprogram/*
+├── soul-admin/            # React 管理后台（主用）→ /api/admin/*、/api/db/*
+├── soul-api/              # Go + Gin + GORM 接口服务
+├── next-project/          # 仅预览，非线上
+├── new-soul/soul-admin/   # 新版参考，迁移时对照
+└── .cursor/               # Cursor AI 规则与智能体配置
+    ├── rules/             # 全局/场景规则（alwaysApply 或 globs）
+    ├── skills/            # 按角色/场景的 Skill（写作、上传、开发、会议等）
+    ├── agent/             # 角色经验与项目索引（evolution、项目索引）
+    ├── config/            # paths.py、workspace 等
+    ├── meeting/           # 会议纪要
+    ├── scripts/           # 进化脚本、Gitea 同步、db-exec 等
+    └── docs/              # 本分析等文档
+```
+
+### 1.2 规则层（Rules）与技能层（Skills）关系
+
+| 类型 | 作用 | 典型文件 |
+|------|------|----------|
+| **Rules** | 会话自检、项目边界、谁调哪组 API、何时加载哪个 Skill | soul-project-boundary.mdc、老板分身-索引.mdc、soul-meeting.mdc、soul-change-checklist.mdc、party-ai-dev.mdc |
+| **Skills** | 具体执行规范：怎么写代码、怎么开会、怎么检查变更 | miniprogram-dev、admin-dev、api-dev、team-meeting、change-checklist、assistant-doc-sync |
+
+- **角色推断**：按「当前编辑目录」或「用户触发词」→ 确定角色 → **必须 Read 对应 Skill 文件**后执行。
+- **老板分身**：权限最高，可调度所有角色；开会时由乘风按 team-meeting 主持；经验自动收集写各角色 evolution。
+
+### 1.3 三端与 API 路由（核心原则）
+
+| 端 | 目录 | 允许调用的 API | 禁止 |
+|----|------|----------------|------|
+| 小程序 | miniprogram/ | `/api/miniprogram/*` | admin、db |
+| 管理端 | soul-admin/ | `/api/admin/*`、`/api/db/*` | miniprogram 混用 |
+| 后端 | soul-api/ | 按使用方挂 miniprogram / admin / db 分组 | 通用路径混用 |
+
+---
+
+## 二、优化与迭代建议
+
+### 2.1 路径可移植性（高优先级）✅ 已落地
+
+**原问题**：rules 与部分 skills 中曾写死 **Windows 绝对路径** `e:\Gongsi\Mycontent\.cursor\skills\...`，在 macOS/Linux 或不同机器上会失效。**当前**：已统一为仓库根相对路径 `.cursor/skills/...` 等，详见 `rules/soul-project-boundary.mdc` 的「路径约定」。
+
+**涉及文件**：
+
+- `rules/老板分身-索引.mdc`：team-meeting SKILL 路径
+- `rules/soul-project-boundary.mdc`：所有「必须 Read 的主 Skill 文件」表格（按编辑目录、按语义触发词、按场景触发词）
+- `rules/soul-meeting.mdc`：team-meeting、assistant-doc-sync 路径
+- `rules/soul-change-checklist.mdc`：change-checklist SKILL 路径
+- `skills/assistant-doc-sync/SKILL.md`：项目索引路径
+- `skills/mysql-direct/SKILL.md`：`cd e:\Gongsi\Mycontent`
+
+**建议**：
+
+1. **统一改为相对项目根的路径**  
+   例如：`项目根/.cursor/skills/team-meeting/SKILL.md`，或在规则中明确写：  
+   「以当前项目根为基准，Read `.cursor/skills/{skill-name}/SKILL.md`」。
+2. 若 Cursor 支持「工作区根」变量，可写成占位符（如 `{workspace}/.cursor/skills/...`），在文档中说明各系统下的解析方式。
+3. **config/paths.py** 已定义 `SKILLS = CURSOR / "skills"`，可在 `.cursor/README.md` 或 rules 中说明：**所有 Skill 路径以 `paths.py` 的 SKILLS 为准，规则中仅写相对 SKILLS 的路径**（如 `skills/team-meeting/SKILL.md`），由 AI 结合当前项目根解析。
+
+### 2.2 跨平台脚本与入口
+
+**问题**：老板分身规则里「若无法写文件则输出 JSON，并提示用户双击 `agent/开发助理/script/一键-添加经验.bat`」。`.bat` 仅适用于 Windows，Mac/Linux 用户无法使用。
+
+**建议**：
+
+1. 增加 **Shell 版**：`一键-添加经验.sh`，实现相同逻辑（或调用同一份 Python/Node 脚本）。
+2. 在规则中改为：「提示用户执行 `agent/开发助理/script/一键-添加经验.bat`（Windows）或 `一键-添加经验.sh`（Mac/Linux），或根据环境说明」。
+
+### 2.3 party-ai-dev.mdc 与 老板分身 的优先级
+
+**问题**：`party-ai-dev.mdc` 要求「优先使用派对 AI（派对AI/BOOTSTRAP.md、SKILL_REGISTRY.md）」，而老板分身等规则在 `.cursor/rules` 下，若同时生效可能产生「先读卡若还是先读派对」的冲突。
+
+**建议**：
+
+1. 在 **party-ai-dev.mdc** 或 **老板分身-索引.mdc** 中明确写清：  
+   「当本仓库为 Soul 派对项目且存在 派对AI/ 目录时，优先按 party-ai-dev 启动顺序；否则按 .cursor/rules 与 skills 执行。」
+2. 或约定：**派对AI 仅用于「在派对AI 目录下开发」的会话**；**在 miniprogram/soul-admin/soul-api 等目录下开发时，仅用 .cursor 的 rules+skills**，避免双重入口。
+
+### 2.4 soul-change-checklist 与 change-checklist Skill 的引用方式
+
+**问题**：soul-change-checklist.mdc 第三十条要求 Read 的路径仍是 Windows 绝对路径。
+
+**建议**：与 2.1 一致，改为「项目根/.cursor/skills/change-checklist/SKILL.md」或相对路径说明，并在 checklist 规则末尾加一句：「Skill 详细流程见 `.cursor/skills/change-checklist/SKILL.md`」。
+
+### 2.5 会议纪要与收尾路径
+
+**问题**：soul-meeting.mdc 中会议纪要、项目索引、会议记录索引等路径未写死 Windows，但 assistant-doc-sync SKILL 里项目索引写的是 `e:\Gongsi\Mycontent\.cursor\agent\...`。
+
+**建议**：assistant-doc-sync 内所有路径改为「项目根/.cursor/agent/...」或相对路径，与 config/paths.py 中的 AGENT、PROJECT_INDEX 等保持一致表述。
+
+### 2.6 角色与 Skill 的集中索引
+
+**现状**：角色→Skill 的映射分散在 soul-project-boundary（按目录、按触发词、按场景）和 paths.py（ROLE_TO_AGENT）。
+
+**建议**：在 `.cursor/README.md` 或 `docs/` 下维护一份「角色 ↔ Skill 一览表」，便于新人/新 Agent 快速查阅；rules 中可写「详见 .cursor/README.md#角色与Skill映射」。
+
+### 2.7 经验自动收集的脚本与 Mac 兼容
+
+**现状**：evolution 写入由 scripts/evolution.py 等完成，paths 来自 config/paths.py，已跨平台；仅「一键-添加经验」的入口是 .bat。
+
+**建议**：同 2.2，补充 .sh 或统一用 Python 脚本入口，在规则中同时给出 Windows 与 Mac/Linux 的说明。
+
+---
+
+## 三、规则与 Skill 清单速查
+
+| 名称 | 类型 | 作用 |
+|------|------|------|
+| soul-project-boundary.mdc | Rule | 项目边界、三端 API 约定、角色推断与 Skill 加载 |
+| 老板分身-索引.mdc | Rule | 老板分身权限、经验自动收集、编码习惯、三端分工 |
+| soul-meeting.mdc | Rule | 开会/散会触发、会议纪要路径、收尾流程 |
+| soul-change-checklist.mdc | Rule | 变更后关联检查清单（防漏改） |
+| party-ai-dev.mdc | Rule | 优先派对 AI、飞书复盘、小程序上传约定 |
+| miniprogram-dev | Skill | 小程序开发规范 |
+| admin-dev | Skill | 管理端开发规范 |
+| api-dev | Skill | 后端 API 规范 |
+| product-manager | Skill | 产品需求与验收 |
+| testing | Skill | 测试与回归 |
+| team-meeting | Skill | 多角色会议流程 |
+| assistant-doc-sync | Skill | 小橙/文档同步/经验入库/会议收尾 |
+| change-checklist | Skill | 变更关联检查详细流程 |
+| role-flow-control | Skill | 跨端协同与角色流程 |
+| three-tier-arch | Skill | 三端架构与框架分析 |
+| new-version-analyze | Skill | 新版分析、迁移对比 |
+| next-preview / next-split | Skill | next-project 仅预览、拆解指引 |
+| mysql-direct | Skill | MySQL 直接操作、db-exec |
+
+---
+
+## 四、总结
+
+- **架构**：项目为三端（小程序 + 管理端 + soul-api），.cursor 通过 rules 定边界与触发、skills 定执行细节、agent 存经验与项目索引，**config/paths.py** 为路径与角色映射中心。
+- **优先迭代**：  
+  1）所有 **Skill/agent 路径** 改为可移植（相对项目根或相对 .cursor）；  
+  2）**一键-添加经验** 增加 Mac/Linux 入口；  
+  3）**party-ai 与 .cursor** 的适用场景或优先级写清楚。  
+- 按上述调整后，在不同系统和不同克隆路径下都能一致生效，且便于后续扩展角色或 Skill。