更新开发文档和技能索引，优化角色驱动的技能使用规范。调整了各角色的主技能和辅助技能的描述，确保开发者在不同目录下遵循相应的开发风格和流程。增加了变更关联检查的要求，确保代码变更后进行必要的检查以防漏改。

2026-02-25 11:04:08 +08:00
parent 28deb34645
commit 8e4d61e22b
369 changed files with 91393 additions and 16 deletions
--- a/.cursor/docs/角色协同流程图.html
+++ b/.cursor/docs/角色协同流程图.html
@@ -0,0 +1,140 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Soul 创业派对 - 角色协同流程图</title>
+  <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
+  <style>
+    * { box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; margin: 0; padding: 24px; background: #f5f5f5; }
+    h1 { color: #333; margin-bottom: 8px; }
+    .subtitle { color: #666; font-size: 14px; margin-bottom: 24px; }
+    .diagram { background: #fff; border-radius: 8px; padding: 24px; margin-bottom: 24px; box-shadow: 0 1px 3px rgba(0,0,0,.1); }
+    .diagram h2 { margin-top: 0; color: #444; font-size: 16px; border-bottom: 1px solid #eee; padding-bottom: 8px; }
+    .mermaid { display: flex; justify-content: center; }
+    .mermaid svg { max-width: 100%; }
+  </style>
+</head>
+<body>
+  <h1>Soul 创业派对 - 角色协同流程图</h1>
+  <p class="subtitle">小程序功能开发（新增/优化）驱动的三端协同流程 · 线框图</p>
+
+  <div class="diagram">
+    <h2>1. 主流程图（阶段划分）</h2>
+    <div class="mermaid">
+flowchart TB
+    subgraph 阶段1["阶段 1：需求分析与接口设计"]
+        A[需求/变更发起] --> B[API 开发者分析 miniprogram 接口]
+        A --> C[管理端开发者分析]
+        C --> C1{管理端是否需要?}
+        C1 -->|需要| C2[记录：字段/配置/审核/统计]
+        C1 -->|不需要| C3[无需管理端调整]
+        B --> D[输出接口契约]
+        C2 --> D
+    end
+
+    阶段1 --> 阶段2
+
+    subgraph 阶段2["阶段 2：并行开发"]
+        E[API 开发者实现 miniprogram 接口]
+        F[API 开发者实现 admin/db 接口<br/>若管理端需要]
+        G[小程序开发者实现功能]
+        E --> G
+    end
+
+    阶段2 --> 阶段3
+
+    subgraph 阶段3["阶段 3：小程序完成 → 管理端启动"]
+        H[小程序完成并自测 ✓]
+        H --> I{管理端需要?}
+        I -->|是| J[管理端开发者开始调整]
+        I -->|否| K[跳过]
+        J --> L[API 开发者补充 admin/db<br/>若有新增需求]
+    end
+
+    阶段3 --> 阶段4
+
+    subgraph 阶段4["阶段 4：联调与收尾"]
+        M[三端联调]
+        N[过 soul-change-checklist]
+        O[提交]
+        M --> N --> O
+    end
+    </div>
+  </div>
+
+  <div class="diagram">
+    <h2>2. 角色时序图（谁在何时做什么）</h2>
+    <div class="mermaid">
+sequenceDiagram
+    participant P as 产品/需求
+    participant MP as 小程序开发者
+    participant AD as 管理端开发者
+    participant API as API 开发者
+
+    P->>API: 1. 需求/变更
+    P->>AD: 1. 需求/变更
+
+    Note over API,AD: 阶段 1：需求分析
+    API->>API: 分析 miniprogram 接口需求
+    AD->>AD: 分析管理端是否需要字段/配置/审核/统计
+    AD->>API: 反馈：需要 / 不需要 + 具体项
+    API->>API: 输出接口契约
+
+    Note over API,MP: 阶段 2：并行开发
+    API->>API: 实现 miniprogram 接口
+    par 若管理端需要
+        API->>API: 实现 admin/db 接口
+    end
+    API->>MP: 接口可用
+    MP->>MP: 实现小程序功能
+
+    Note over MP,AD: 阶段 3：小程序完成 → 管理端
+    MP->>MP: 完成并自测 ✓
+    MP->>AD: 小程序完成
+    alt 管理端需要
+        AD->>AD: 开始管理端调整
+        AD->>API: 若有新增接口需求
+        API->>API: 补充 admin/db 接口
+    end
+
+    Note over API,AD: 阶段 4：联调
+    API->>API: 联调
+    MP->>MP: 联调
+    AD->>AD: 联调
+    Note over P,AD: 过 soul-change-checklist → 提交
+    </div>
+  </div>
+
+  <div class="diagram">
+    <h2>3. 三角色职责与依赖</h2>
+    <div class="mermaid">
+flowchart LR
+    subgraph 角色["三角色"]
+        MP[小程序开发者<br/>miniprogram/]
+        AD[管理端开发者<br/>soul-admin/]
+        API[API 开发者<br/>soul-api/]
+    end
+
+    subgraph 路径["API 路径"]
+        P1["/api/miniprogram/*"]
+        P2["/api/admin/*<br/>/api/db/*"]
+    end
+
+    MP -->|只调| P1
+    AD -->|只调| P2
+    API -->|提供| P1
+    API -->|提供| P2
+
+    MP -.->|依赖| API
+    AD -.->|依赖| API
+    AD -.->|小程序完成后启动| MP
+    </div>
+  </div>
+
+  <script>
+    mermaid.initialize({ startOnLoad: true, theme: 'neutral' });
+  </script>
+</body>
+</html>
--- a/.cursor/docs/角色驱动Skills分析.md
+++ b/.cursor/docs/角色驱动Skills分析.md
@@ -0,0 +1,88 @@
+# 角色驱动 Skills 方式 - 分析与完善
+
+## 一、当前方式概述
+
+Skills 按**三角色**（小程序开发者、管理端开发者、后端 API 开发者）组织，每个角色有：
+- **主 Skill**：开发风格与规范（必须遵循）
+- **辅助 Skill**：按顺序 1→2→3→4 选用
+- **协同 Skill**：跨端功能开发时使用
+
+---
+
+## 二、优点
+
+| 优点 | 说明 |
+|------|------|
+| **职责清晰** | 每个角色对应明确的主 Skill，开发风格不混用 |
+| **顺序明确** | 辅助 Skill 有推荐查阅顺序，减少「不知道该看哪个」 |
+| **协同有据** | SKILL-角色流程控制 统一跨端协作流程 |
+| **与 boundary 一致** | 角色 ↔ 目录 ↔ boundary 一一对应 |
+
+---
+
+## 三、可改进点
+
+| 问题 | 影响 | 改进方向 |
+|------|------|----------|
+| **目录→角色推断不显式** | Agent 需从「编辑目录」推断「当前角色」，再查 Skills | 增加「目录→角色→应加载 Skills」速查表 |
+| **辅助 Skill 何时选用不明确** | 辅助 1、2、3 的触发场景模糊 | 为每个辅助 Skill 补充「何时选用」 |
+| **主 Skill 缺少触发词** | Cursor 可能难以自动发现应加载的 Skill | 为主 Skill 增加 YAML description，含 miniprogram、soul-admin、soul-api 等触发词 |
+| **协同场景单一** | 仅覆盖「小程序驱动」流程 | 可补充「API 先行」「管理端先行」的简要说明 |
+| **通用 Skill 与角色关系** | 变更检查、MySQL 等何时介入不够清晰 | 在角色清单中标注「变更后必过」「API 开发者数据库操作时」 |
+
+---
+
+## 四、完善措施（已实施）
+
+1. **README**：增加「目录→角色→Skills」速查表；辅助 Skill 补充「何时选用」。
+2. **soul-project-boundary**：开发时增加「根据当前编辑目录推断角色，加载对应主 Skill」。
+3. **主 Skill**：增加 YAML frontmatter，description 含触发词（miniprogram、soul-admin、soul-api）。
+4. **SKILL-角色流程控制**：补充「API 先行」「管理端先行」的简要流程说明。
+
+---
+
+## 五、使用流程（完善后）
+
+```
+1. 用户/Agent 在 miniprogram/ 下编辑
+   → 推断：当前角色 = 小程序开发者
+   → 加载：主 Skill（SKILL-小程序开发）+ 对应 boundary
+
+2. 若涉及跨端功能（如新功能需管理端配置）
+   → 加载：SKILL-角色流程控制
+   → 按阶段执行
+
+3. 变更完成后
+   → 加载：SKILL-变更关联检查、soul-change-checklist
+   → 过一遍关联层
+
+4. 若 API 开发者需操作数据库且 MCP 不可用
+   → 加载：SKILL-MySQL直接操作
+```
+
+---
+
+## 六、优化效果
+
+| 优化项 | 效果 |
+|--------|------|
+| 速查表 | 目录→角色→Skills 一目了然，减少查找时间 |
+| 何时选用 | 辅助 Skill 触发场景明确，避免误用或漏用 |
+| 主/辅 Skill frontmatter | 含触发词，便于 Cursor Agent 自动发现 |
+| 角色推断表 | soul-project-boundary 中显式映射，开发时直接对照 |
+| API/管理端先行 | 角色流程控制补充多驱动场景 |
+
+---
+
+## 七、后续迭代方向
+
+| 方向 | 说明 |
+|------|------|
+| **Glob 自动加载** | 若 Cursor 支持按 glob 自动加载 Skill，可配置 miniprogram/** → soul-miniprogram-dev |
+| **Checklist 自动化** | 变更后自动提示「请过 soul-change-checklist」 |
+| **角色切换提醒** | 跨目录编辑时提醒「当前角色已切换」 |
+| **Skill 版本号** | 主 Skill 增加版本/更新日期，便于追踪迭代 |
+
+---
+
+**更新日期**：2026-02