fnvtk/soul-yongping
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Made-with: Cursor
This commit is contained in:
卡若
2026-03-20 18:41:30 +08:00
parent 939e9cc6b7
commit 17ce20c8ee
39 changed files with 2385 additions and 245 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.cursor/rules/assistant-xiaofeng.mdc
View File

@@ -8,9 +8,9 @@ alwaysApply: false
当用户提及**小橙、橙子、橙橙、🍊**，或说**「讨论完毕」「记录一下」「同步到开发文档」「更新文档」「吸收经验」「升级 skills」「记录经验」「保存开发进度」「更新项目索引」「记录开发进度」「任务完成」「搞定了」「完成了」「会议结束」「散会」「会开完了」**时：
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md` 的完整内容**，然后严格按其流程执行。
**必须使用 Read 工具读取 `.cursor/skills/assistant-doc-sync/SKILL.md` 的完整内容**，然后严格按其流程执行。
### 行为摘要（供模型快速理解，完整流程以 SKILL 文件为准）
1. **文档同步**：从对话中提炼结论/待办/变更 → 写入 `开发文档/1、需求/YYYY-MM-DD-需求.md`（当日文件，以日期最新为主）、`开发文档/10、项目管理/运营与变更.md`、`临时需求池/` 等对应文档
1. **文档同步**：从对话中提炼结论/待办/变更 → 写入 `开发文档/1、需求/需求汇总.md`、`开发文档/10、项目管理/运营与变更.md`、`临时需求池/` 等对应文档
2. **经验入库**：提炼经验 → 写入 `agent/{角色}/evolution/YYYY-MM-DD.md` → 更新 `agent/开发助理/项目索引/{索引名}.md`（写日期）→ 更新 `agent/开发助理/经验清单.md` → 升级对应 SKILL

10
.cursor/rules/party-ai-dev.mdc
View File

@@ -1,8 +1,14 @@
# 派对 AI 开发规则
## 强制：使用派对 AI 进行开发
## 与本仓库 `.cursor` 的优先级（避免入口打架）
所有开发操作**优先使用派对 AI**（路径：`/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验-永平/派对AI/`），派对 AI 优先于卡若 AI 读取使用。
- **三端编码与接口**：以本仓库 `.cursor/rules`（如 `soul-project-boundary.mdc`）与 `.cursor/skills` 为准——小程序/管理端/soul-api 路由隔离、变更检查、角色 Skill 加载等**不因派对 AI 而绕过**。
- **派对 AI 目录**：若仓库根下存在 `派对AI/`，开发前可补充读取其 `BOOTSTRAP.md`、`SKILL_REGISTRY.md`，用于派对域身份、运营与流程；与 `.cursor` 冲突时，**代码与 API 约定以 `.cursor` 为准**。
- **卡若 AI 全局规则**：仅在本会话需要时参考；本仓库会话自检仍以 **本仓库 `.cursor/`** 为主。
## 强制：使用派对 AI 进行开发（当 `派对AI/` 存在时）
所有开发操作**优先结合派对 AI**（路径：**仓库根下的** `派对AI/`，与 `miniprogram/` 同级）。若本仓库无 `派对AI/` 目录，则跳过本节启动顺序，仅按 `.cursor` 执行。
### 启动顺序

2
.cursor/rules/product-manager.mdc
View File

@@ -8,4 +8,4 @@ alwaysApply: false
当编辑 **开发文档/1、需求/**、**临时需求池/**、**开发文档/10、项目管理/** 时，推断当前角色为**产品经理**。
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\product-manager\SKILL.md` 的完整内容**，然后按其规范执行需求分析、文档编写、验收标准制定。
**必须使用 Read 工具读取 `.cursor/skills/product-manager/SKILL.md` 的完整内容**，然后按其规范执行需求分析、文档编写、验收标准制定。

4
.cursor/rules/soul-admin-boundary.mdc
View File

@@ -26,8 +26,8 @@ alwaysApply: false
## Skill 加载（必须执行）
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\admin-dev\SKILL.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
**必须使用 Read 工具读取 `.cursor/skills/admin-dev/SKILL.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
接口实现与路由分组的规范在 `e:\Gongsi\Mycontent\.cursor\rules\soul-api.mdc`（编辑 soul-api 时自动加载）。
接口实现与路由分组的规范在 `.cursor/rules/soul-api.mdc`（编辑 soul-api 时自动加载）。
违反上述路径或职责边界即视为「互窜」，需纠正后再提交。

2
.cursor/rules/soul-api.mdc
View File

@@ -6,7 +6,7 @@ alwaysApply: false
# soul-api 开发规范
> **Skill 加载**：编辑 soul-api 代码时，**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\api-dev\SKILL.md` 的完整内容**，该 Skill 包含业务对接、与前端边界协同等补充约定。本规则侧重编码规范与路由边界。
> **Skill 加载**：编辑 soul-api 代码时，**必须使用 Read 工具读取 `.cursor/skills/api-dev/SKILL.md` 的完整内容**，该 Skill 包含业务对接、与前端边界协同等补充约定。本规则侧重编码规范与路由边界。
## 1. 路由按使用方归类（强制）

2
.cursor/rules/soul-change-checklist.mdc
View File

@@ -30,7 +30,7 @@ alwaysApply: false
- **每次**在 miniprogram、soul-admin、soul-api 内完成一轮修改后，**先过一遍上表 + 二**，再视为本次变更完成。
- 若本次变更涉及多端（例如小程序新功能 + 管理端配置页），应在同一次任务内一并完成或明确记录未做项，避免漏改。
- 更详细的检查流程：**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\change-checklist\SKILL.md` 的完整内容**，按其「以领域为单位思考」的方法逐项确认。
- 更详细的检查流程：**必须使用 Read 工具读取 `.cursor/skills/change-checklist/SKILL.md` 的完整内容**（相对本仓库根），按其「以领域为单位思考」的方法逐项确认。
## 四、聊天中触发变更检查

12
.cursor/rules/soul-meeting.mdc
View File

@@ -6,7 +6,7 @@ alwaysApply: true
# Soul 创业派对 - 会议触发器
当用户表达**开会意图**时（包括但不限于以下触发词），**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\team-meeting\SKILL.md` 的完整内容**，然后严格按其流程主持会议。
当用户表达**开会意图**时（包括但不限于以下触发词），**必须使用 Read 工具读取 `.cursor/skills/team-meeting/SKILL.md` 的完整内容**（相对本仓库根），然后严格按其流程主持会议。
## 语义化触发词（理解意图，不必完全匹配）
@@ -24,9 +24,9 @@ alwaysApply: true
当用户说**「会议结束」「散会」「会开完了」「结束会议」**时：
1. 助理橙子立即执行收尾流程
2. **生成会议纪要**：`e:\Gongsi\Mycontent\.cursor\meeting\YYYY-MM-DD_主题.md`
3. **各角色经验入库**：`e:\Gongsi\Mycontent\.cursor\agent\{角色}\evolution\YYYY-MM-DD.md`
4. **更新项目索引**：`agent/开发助理/项目索引/{索引名}.md` 开发进度表追加一行
5. **更新会议记录索引**：`e:\Gongsi\Mycontent\.cursor\meeting\README.md`
2. **生成会议纪要**：`.cursor/meeting/YYYY-MM-DD_主题.md`
3. **各角色经验入库**：`.cursor/agent/{角色}/evolution/YYYY-MM-DD.md`
4. **更新项目索引**：`.cursor/agent/开发助理/项目索引/{索引名}.md` 开发进度表追加一行
5. **更新会议记录索引**：`.cursor/meeting/README.md`
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md` 执行收尾。**
**必须使用 Read 工具读取 `.cursor/skills/assistant-doc-sync/SKILL.md` 执行收尾。**

4
.cursor/rules/soul-miniprogram-boundary.mdc
View File

@@ -23,8 +23,8 @@ alwaysApply: false
## Skill 加载（必须执行）
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\miniprogram-dev\SKILL.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
**必须使用 Read 工具读取 `.cursor/skills/miniprogram-dev/SKILL.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
接口实现与路由分组的规范在 `e:\Gongsi\Mycontent\.cursor\rules\soul-api.mdc`（编辑 soul-api 时自动加载）。
接口实现与路由分组的规范在 `.cursor/rules/soul-api.mdc`（编辑 soul-api 时自动加载）。
违反上述路径或职责边界即视为「互窜」，需纠正后再提交。

62
.cursor/rules/soul-project-boundary.mdc
View File

@@ -20,31 +20,30 @@ alwaysApply: true
| 预览/参考 | 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 / agent / meeting）
- 下表及本仓库 Skill 中的路径均以 **本 Git 仓库根目录** 为基准（与 `miniprogram/`、`soul-api/` 同级），**不使用盘符或另一台机器上的绝对路径**。
- 使用 Read / Write 工具时：填写 **`仓库根/.cursor/...`**，例如 `.cursor/skills/api-dev/SKILL.md`（与规则中的写法一致即可）。
- 脚本中的物理路径以 `config/paths.py` 的 `ROOT`、`SKILLS`、`AGENT`、`MEETING` 为准。
## 角色推断与 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 文件（相对仓库根） |
|----------|----------|----------------------------------------|
| miniprogram/ | 小程序开发工程师 | `.cursor/skills/miniprogram-dev/SKILL.md` |
| soul-admin/ | 管理端开发工程师 | `.cursor/skills/admin-dev/SKILL.md` |
| soul-api/ | 后端开发 | `.cursor/skills/api-dev/SKILL.md` |
| 开发文档/1、需求/、临时需求池/ | 产品经理 | `.cursor/skills/product-manager/SKILL.md` |
| .cursor/ | 助理橙子 | `.cursor/skills/assistant-doc-sync/SKILL.md` |
### 按语义触发词（说啥切角色，无需编辑文件）
@@ -52,26 +51,23 @@ alwaysApply: true
| 触发词 | 推断角色 | 必须 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` |
| 后端、API、soul-api、接口、Go、GORM | 后端开发 | `.cursor/skills/api-dev/SKILL.md` |
| 管理端、soul-admin、React、后台管理 | 管理端开发工程师 | `.cursor/skills/admin-dev/SKILL.md` |
| 小程序、miniprogram、C 端、微信小程序 | 小程序开发工程师 | `.cursor/skills/miniprogram-dev/SKILL.md` |
| 产品、需求、验收、排期、需求文档 | 产品经理 | `.cursor/skills/product-manager/SKILL.md` |
| 测试、测试用例、回归测试、功能测试、QA | 测试人员 | `.cursor/skills/testing/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 的 Skill 文件（相对仓库根） |
|------------|----------------------------------------|
| 小橙、橙子、橙橙、🍊、讨论完毕、记录一下、记录、同步文档 | `.cursor/skills/assistant-doc-sync/SKILL.md` |
| 吸收经验、升级 skills、记录经验、保存开发进度、更新项目索引、记录开发进度、任务完成、搞定了、完成了 | `.cursor/skills/assistant-doc-sync/SKILL.md` |
| 跨端功能开发 | `.cursor/skills/role-flow-control/SKILL.md` |
| 变更完成、检查一下、准备提交 | `.cursor/skills/change-checklist/SKILL.md` |
| 开个会、开会、团队会议、乘风开会、需求评审、方案讨论、大家一起讨论 | `.cursor/skills/team-meeting/SKILL.md`（老板分身/乘风主持） |
| 会议结束、散会、会开完了 | `.cursor/skills/assistant-doc-sync/SKILL.md`（会议收尾） |
| **加个需求**、加个需求：xxx | `.cursor/skills/product-manager/SKILL.md`（产品经理三端分析 → 功能规划 → 指派） |
| **新版分析**、版本对比、迁移分析、甲方代码分析、快速分析新版、抽取需求 | `.cursor/skills/new-version-analyze/SKILL.md`（新版快速分析 → 差异清单 → 接口冲突 → 迁移迭代） |
**注意**：「必须 Read」= 使用 Read 工具读取**绝对路径**的完整文件内容后执行，不可跳过或仅凭记忆。
**注意**：「必须 Read」= 使用 Read 工具读取上述路径相对于**当前工作区仓库根**的完整文件内容后执行，不可跳过或仅凭记忆。

5
.cursor/rules/老板分身-索引.mdc
View File

@@ -6,7 +6,7 @@ alwaysApply: true
# 老板分身 - 能力与约束（Soul 创业派对）
> **老板分身权限最高**：协调所有智能体（小程序开发工程师、管理端开发工程师、后端工程师、产品经理、开发助理等）。其他 agent 执行任务时遵循本规则；老板分身可调度、协调、指派任一角色。
> **激活方式**：用户说「老板」「分身」「乘风」「架构」「帮我协调」时，从旁观者转为主动参与。**开会时**：用户说「开会」「开个会」「团队会议」「乘风开会」「需求评审」「方案讨论」等表达开会意图时，**必须先**用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\team-meeting\SKILL.md` 完整内容，然后由老板分身（乘风）按该协议主持多角色会议，不可仅回复而不执行流程。
> **激活方式**：用户说「老板」「分身」「乘风」「架构」「帮我协调」时，从旁观者转为主动参与。**开会时**：用户说「开会」「开个会」「团队会议」「乘风开会」「需求评审」「方案讨论」等表达开会意图时，**必须先**用 Read 工具读取 `.cursor/skills/team-meeting/SKILL.md` 完整内容（相对本仓库根），然后由老板分身（乘风）按该协议主持多角色会议，不可仅回复而不执行流程。
> **会话自检**：仅沿用本项目 `.cursor/` 下的 rules、skills、agent；忽略与本项目无关的全局 rules/skills。
> **角色驱动**：Soul 角色与 agent 映射见 `config/paths.py` 的 ROLE_TO_AGENT。
@@ -39,12 +39,11 @@ alwaysApply: true
- 产品/需求/config→**产品经理**
- 测试/自检/QA→**软件测试**
- 架构/选型/路由约定/三端协同→**团队**
- 挖矿/安全/服务器操作/部署/入侵排查→**安全工程师**
- 无法判断→**通用**（写入开发助理）
3. **若可写文件**：
- **有明确目标角色**：写入 `.cursor/agent/{角色}/evolution/YYYY-MM-DD-简短描述.md`，并更新该目录下的 `索引.md`
- **无法判断角色**：写入 `.cursor/agent/开发助理/evolution/`
4. **若无法写文件**：输出 JSON，并提示用户双击 `agent/开发助理/script/一键-添加经验.bat`
4. **若无法写文件**：输出 JSON，并提示用户在仓库根执行：`.cursor/agent/开发助理/script/一键-添加经验.bat`（Windows）或同目录下的 `.sh` / Python 入口（macOS/Linux，若已提供）
### Soul 目标角色与 target_roles 取值