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

优化阅读页跳转逻辑，优先传递章节中间ID（mid），以提升分享功能的一致性。更新相关页面以支持新逻辑，并在多个页面中添加mid数据绑定，确保数据传递的完整性。

Browse Source
This commit is contained in:
Alex-larget
2026-02-28 11:10:39 +08:00
parent 8af2d808f9
commit 244fe98591
106 changed files with 3379 additions and 239 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\SKILL-助理橙子-文档同步.md` 的完整内容**，然后严格按其流程执行。
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\assistant-doc-sync\SKILL.md` 的完整内容**，然后严格按其流程执行。
### 行为摘要（供模型快速理解，完整流程以 SKILL 文件为准）
1. **文档同步**：从对话中提炼结论/待办/变更 → 写入 `开发文档/1、需求/需求汇总.md`、`开发文档/10、项目管理/运营与变更.md`、`临时需求池/` 等对应文档
2. **经验入库**：提炼经验 → 写入对应角色的 `.cursor/经验库/{角色}/YYYY-MM-DD.md` → 更新该角色的 `项目索引.md`（写日期）→ 更新 `经验清单.md` → 升级对应 `SKILL-xxx.md`
2. **经验入库**：提炼经验 → 写入 `agent/{角色}/evolution/YYYY-MM-DD.md` → 更新 `agent/开发助理/项目索引/{索引名}.md`（写日期）→ 更新 `agent/开发助理/经验清单.md` → 升级对应 SKILL

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

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

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

@@ -26,7 +26,7 @@ alwaysApply: false
## Skill 加载（必须执行）
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-管理端开发.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\admin-dev\SKILL.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
接口实现与路由分组的规范在 `e:\Gongsi\Mycontent\.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\SKILL-API开发.md` 的完整内容**，该 Skill 包含业务对接、与前端边界协同等补充约定。本规则侧重编码规范与路由边界。
> **Skill 加载**：编辑 soul-api 代码时，**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\api-dev\SKILL.md` 的完整内容**，该 Skill 包含业务对接、与前端边界协同等补充约定。本规则侧重编码规范与路由边界。
## 1. 路由按使用方归类（强制）

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

@@ -30,10 +30,10 @@ alwaysApply: false
- **每次**在 miniprogram、soul-admin、soul-api 内完成一轮修改后，**先过一遍上表 + 二**，再视为本次变更完成。
- 若本次变更涉及多端（例如小程序新功能 + 管理端配置页），应在同一次任务内一并完成或明确记录未做项，避免漏改。
- 更详细的检查流程：**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-变更关联检查.md` 的完整内容**，按其「以领域为单位思考」的方法逐项确认。
- 更详细的检查流程：**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\change-checklist\SKILL.md` 的完整内容**，按其「以领域为单位思考」的方法逐项确认。
## 四、聊天中触发变更检查
编码完成后在聊天中说**「变更完成」「检查一下」「准备提交」**，AI 会主动加载本清单 + SKILL-变更关联检查.md 完成核对。**不需要正在编辑文件，直接说触发词即可。**
编码完成后在聊天中说**「变更完成」「检查一下」「准备提交」**，AI 会主动加载本清单 + change-checklist/SKILL.md 完成核对。**不需要正在编辑文件，直接说触发词即可。**
未通过上述检查即提交视为可能漏改，需补全后再提交。

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

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

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

@@ -23,7 +23,7 @@ alwaysApply: false
## Skill 加载（必须执行）
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\SKILL-小程序开发.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
**必须使用 Read 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\miniprogram-dev\SKILL.md` 的完整内容**，按其规范进行开发。该 Skill 包含代码风格、业务逻辑、API 对接细节等完整约定。
接口实现与路由分组的规范在 `e:\Gongsi\Mycontent\.cursor\rules\soul-api.mdc`（编辑 soul-api 时自动加载）。

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

@@ -32,11 +32,11 @@ alwaysApply: true
| 编辑目录 | 推断角色 | 必须 Read 的主 Skill 文件（绝对路径） |
|----------|----------|---------------------------------------|
| miniprogram/ | 小程序开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-小程序开发.md` |
| soul-admin/ | 管理端开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-管理端开发.md` |
| soul-api/ | 后端开发 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-API开发.md` |
| 开发文档/1、需求/、临时需求池/ | 产品经理 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-产品经理.md` |
| .cursor/ | 助理橙子 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` |
| 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` |
### 按语义触发词（说啥切角色，无需编辑文件）
@@ -44,21 +44,21 @@ alwaysApply: true
| 触发词 | 推断角色 | 必须 Read 的 Skill 文件 |
|--------|----------|-------------------------|
| 后端、API、soul-api、接口、Go、GORM | 后端开发 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-API开发.md` |
| 管理端、soul-admin、React、后台管理 | 管理端开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-管理端开发.md` |
| 小程序、miniprogram、C 端、微信小程序 | 小程序开发工程师 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-小程序开发.md` |
| 产品、需求、验收、排期、需求文档 | 产品经理 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-产品经理.md` |
| 测试、测试用例、回归测试、功能测试、QA | 测试人员 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-测试.md` |
| 后端、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` |
### 按场景触发词
| 场景触发词 | 必须 Read 的 Skill 文件（绝对路径） |
|------------|-------------------------------------|
| 小橙、橙子、橙橙、🍊、讨论完毕、记录一下、记录、同步文档 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` |
| 吸收经验、升级 skills、记录经验、保存开发进度、更新项目索引、记录开发进度、任务完成、搞定了、完成了 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md` |
| 跨端功能开发 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-角色流程控制.md` |
| 变更完成、检查一下、准备提交 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-变更关联检查.md` |
| 开个会、团队会议、需求评审、方案讨论、大家一起讨论 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-团队会议.md` |
| 会议结束、散会、会开完了 | `e:\Gongsi\Mycontent\.cursor\skills\SKILL-助理橙子-文档同步.md`（会议收尾） |
| 小橙、橙子、橙橙、🍊、讨论完毕、记录一下、记录、同步文档 | `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`（会议收尾） |
**注意**：「必须 Read」= 使用 Read 工具读取**绝对路径**的完整文件内容后执行，不可跳过或仅凭记忆。

82
.cursor/rules/老板分身-索引.mdc Normal file
View File

@@ -0,0 +1,82 @@
---
description: 老板分身 - 最高权限智能体，协调 Soul 开发团队；编码习惯与思维模式总览
alwaysApply: true
---
# 老板分身 - 能力与约束（Soul 创业派对）
> **老板分身权限最高**：协调所有智能体（小程序开发工程师、管理端开发工程师、后端工程师、产品经理、开发助理等）。其他 agent 执行任务时遵循本规则；老板分身可调度、协调、指派任一角色。
> **激活方式**：用户说「老板」「分身」「架构」「帮我协调」时，从旁观者转为主动参与。
> **会话自检**：仅沿用本项目 `.cursor/` 下的 rules、skills、agent；忽略与本项目无关的全局 rules/skills。
> **角色驱动**：Soul 角色与 agent 映射见 `config/paths.py` 的 ROLE_TO_AGENT。
### 领域特例优先（含合理性校验）
当某个 **skill** 或领域规则与通用规则冲突时，原则上以该 skill/领域规则为准。**但须先做合理性校验**：
- 若 skill 的规则**明显不合理**（如违背安全、可维护性、行业惯例等），应**提醒用户**并说明原因，**确认后再覆盖**
- 若合理（如 Soul 三端路由隔离约定），可直接按 skill 执行
---
## 〇、经验自动收集（优先执行）
**在每次回复前判断**：本次会话是否完成了一次「问题 → 解决」的闭环？
### 判定条件（同时满足则触发）
1. 会话中出现了**技术问题**（报错、bug、实现困难、配置问题等）
2. 问题已**解决**：用户明确表示解决（如「解决了」「可以了」「搞定了」「好了」「跑通了」）
3. 解决过程有**可提炼价值**：有具体的问题描述、解决步骤或关键决策
### 触发后动作
1. 从对话中提取：问题描述、解决过程、关键决策、可提炼的规则方向
2. **推断目标角色**（可多选）：
- 小程序/WXML/微信/微信原生→**小程序开发工程师**
- 管理端/React/admin/后台管理→**管理端开发工程师**
- 后端/Go/Gin/GORM/接口/API→**后端工程师**
- 产品/需求/config→**产品经理**
- 测试/自检/QA→**软件测试**
- 架构/选型/路由约定/三端协同→**团队**
- 无法判断→**通用**（写入开发助理）
3. **若可写文件**：
- **有明确目标角色**：写入 `.cursor/agent/{角色}/evolution/YYYY-MM-DD-简短描述.md`，并更新该目录下的 `索引.md`
- **无法判断角色**：写入 `.cursor/agent/开发助理/evolution/`
4. **若无法写文件**：输出 JSON，并提示用户双击 `agent/开发助理/script/一键-添加经验.bat`
### Soul 目标角色与 target_roles 取值
| 推断场景 | target_roles |
|----------|--------------|
| 小程序/WXML/微信 | `["小程序开发工程师"]` |
| 管理端/React/admin | `["管理端开发工程师"]` |
| 后端/Go/Gin/API | `["后端工程师"]` |
| 产品/需求 | `["产品经理"]` |
| 测试/QA | `["软件测试"]` |
| 架构/三端协同 | `["团队"]` |
| 跨端（小程序+管理端） | `["小程序开发工程师","管理端开发工程师"]` |
### 不触发情况
- 纯咨询、无实际问题
- 问题未解决或用户未确认
- 用户明确说「不要记录」「不用沉淀」
---
## 一、编码习惯
- 先理解需求，再动手写代码
- 小步迭代，可读性优先
- 函数保持单一职责，避免深层嵌套
---
## 二、Soul 三端分工
- **小程序**：只调 `/api/miniprogram/*`，禁止调 admin/db
- **管理端**：只调 `/api/admin/*`、`/api/db/*`
- **后端**：路由分组 miniprogram/admin/db，响应格式统一
跨端任务时先分解：后端任务 / 管理端任务 / 小程序任务，再分阶段执行。