78 lines
5.4 KiB
Plaintext
78 lines
5.4 KiB
Plaintext
---
|
||
description: Soul 创业派对项目整体边界、角色推断与 Skill 加载（alwaysApply）
|
||
globs: ["**"]
|
||
alwaysApply: true
|
||
---
|
||
|
||
# Soul 创业派对 - 项目边界
|
||
|
||
## 会话自检
|
||
|
||
仅沿用本项目 `.cursor/` 下的 rules、skills、配置；忽略与本项目无关的全局 rules/skills。
|
||
|
||
## 项目组成
|
||
|
||
| 子项目 | 目录 | 用途 | 后端对接 |
|
||
|--------|------|------|----------|
|
||
| 小程序 | miniprogram/ | 微信原生小程序 C 端 | soul-api |
|
||
| 管理端 | soul-admin/ | React 管理后台（稳定版，主用） | soul-api |
|
||
| API 后端 | soul-api/ | Go + Gin + GORM 接口服务 | - |
|
||
| 预览/参考 | next-project/ | 仅预览，非线上 | 不依赖 |
|
||
| **新版管理端** | **new-soul/soul-admin/** | 新版参考实现，迁移时对照 | soul-api |
|
||
|
||
## 需求目录与命名约定
|
||
|
||
- **需求目录**：`开发文档/1、需求/`
|
||
- **命名**：`YYYY-MM-DD-需求.md` 或 `YYYY-MM-DD-简短描述.md`
|
||
- **主需求**：以日期最新的需求文件为主；同步需求时新建/更新当日文件，并更新 `1、需求/索引.md`
|
||
- **基准**：`以界面定需求.md` 为界面级需求基准，新增/改版界面或业务规则时先更新该文档
|
||
|
||
## 核心原则
|
||
|
||
- 小程序只调 `/api/miniprogram/*`；管理端只调 `/api/admin/*`、`/api/db/*`；禁止混用。
|
||
- 变更完成必过 soul-change-checklist.mdc；聊天中说「变更完成」「检查一下」「准备提交」时主动触发检查。
|
||
|
||
## 角色推断与 Skill 加载（必须执行）
|
||
|
||
根据**当前编辑目录**或**语义触发词**，**必须使用 Read 工具读取对应的主 Skill 文件完整内容**，然后按其规范执行开发：
|
||
|
||
### 按编辑目录
|
||
|
||
| 编辑目录 | 推断角色 | 必须 Read 的主 Skill 文件（绝对路径） |
|
||
|----------|----------|---------------------------------------|
|
||
| miniprogram/ | 小程序开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\miniprogram-dev\SKILL.md` |
|
||
| soul-admin/ | 管理端开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\admin-dev\SKILL.md` |
|
||
| soul-api/ | 后端开发 | `e:\Gongsi\Mycontent\.cursor\skills\api-dev\SKILL.md` |
|
||
| 开发文档/1、需求/、临时需求池/ | 产品经理 | `e:\Gongsi\Mycontent\.cursor\skills\product-manager\SKILL.md` |
|
||
| .cursor/ | 助理橙子 | `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md` |
|
||
|
||
### 按语义触发词（说啥切角色，无需编辑文件）
|
||
|
||
用户说出以下词时，推断对应角色并 Read 其 Skill（理解意图即可，不必完全匹配）：
|
||
|
||
| 触发词 | 推断角色 | 必须 Read 的 Skill 文件 |
|
||
|--------|----------|-------------------------|
|
||
| 后端、API、soul-api、接口、Go、GORM | 后端开发 | `e:\Gongsi\Mycontent\.cursor\skills\api-dev\SKILL.md` |
|
||
| 管理端、soul-admin、React、后台管理 | 管理端开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\admin-dev\SKILL.md` |
|
||
| 小程序、miniprogram、C 端、微信小程序 | 小程序开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\miniprogram-dev\SKILL.md` |
|
||
| 产品、需求、验收、排期、需求文档 | 产品经理 | `e:\Gongsi\Mycontent\.cursor\skills\product-manager\SKILL.md` |
|
||
| 测试、测试用例、回归测试、功能测试、QA | 测试人员 | `e:\Gongsi\Mycontent\.cursor\skills\testing\SKILL.md` |
|
||
| 挖矿、安全、服务器操作、部署、miner_guard、xmrig、入侵排查 | 安全工程师 | `e:\Gongsi\Mycontent\.cursor\skills\security-miner-guard\SKILL.md`、`e:\Gongsi\Mycontent\.cursor\skills\security-server-ops\SKILL.md` |
|
||
|
||
### 按场景触发词
|
||
|
||
| 场景触发词 | 必须 Read 的 Skill 文件（绝对路径） |
|
||
|------------|-------------------------------------|
|
||
| 小橙、橙子、橙橙、🍊、讨论完毕、记录一下、记录、同步文档 | `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md` |
|
||
| 吸收经验、升级 skills、记录经验、保存开发进度、更新项目索引、记录开发进度、任务完成、搞定了、完成了 | `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md` |
|
||
| 跨端功能开发 | `e:\Gongsi\Mycontent\.cursor\skills\role-flow-control\SKILL.md` |
|
||
| 变更完成、检查一下、准备提交 | `e:\Gongsi\Mycontent\.cursor\skills\change-checklist\SKILL.md` |
|
||
| 开个会、开会、团队会议、乘风开会、需求评审、方案讨论、大家一起讨论 | `e:\Gongsi\Mycontent\.cursor\skills\team-meeting\SKILL.md`（老板分身/乘风主持） |
|
||
| 会议结束、散会、会开完了 | `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md`（会议收尾） |
|
||
| **加个需求**、加个需求：xxx | `e:\Gongsi\Mycontent\.cursor\skills\product-manager\SKILL.md`（产品经理三端分析 → 功能规划 → 指派） |
|
||
| **新版分析**、版本对比、迁移分析、甲方代码分析、快速分析新版、抽取需求 | `e:\Gongsi\Mycontent\.cursor\skills\new-version-analyze\SKILL.md`（新版快速分析 → 差异清单 → 接口冲突 → 迁移迭代） |
|
||
| **帮我部署api到线上** | `e:\Gongsi\Mycontent\.cursor\skills\security-server-ops\SKILL.md`（安全工程师 → 执行 soul-api/master.py） |
|
||
| **管理端帮我部署到xx环境** | `e:\Gongsi\Mycontent\.cursor\skills\security-server-ops\SKILL.md`（安全工程师 → 语义化解析 xx：正式/线上/生产→master.py，测试/dev→deploy.py） |
|
||
|
||
**注意**：「必须 Read」= 使用 Read 工具读取**绝对路径**的完整文件内容后执行，不可跳过或仅凭记忆。
|