# 角色驱动 Skills 方式 - 分析与完善

## 一、当前方式概述

**开发团队**五角色：小程序开发工程师、管理端开发工程师、后端开发、产品经理、助理橙子。Skills 按角色分配：

> 职责定义：[开发团队职责定义.md](./开发团队职责定义.md) | 源码边界：[三角色边界定义.md](./三角色边界定义.md) | 入口：[.cursor/README.md](../README.md)

- **主 Skill**：开发风格与规范（必须遵循）
- **辅助 Skill**：按需选用
- **协同 Skill**：跨端时用 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