2026-02-25 11:04:08 +08:00
|
|
|
|
# 角色驱动 Skills 方式 - 分析与完善
|
|
|
|
|
|
|
|
|
|
|
|
## 一、当前方式概述
|
|
|
|
|
|
|
2026-02-26 18:55:22 +08:00
|
|
|
|
**开发团队**五角色：小程序开发工程师、管理端开发工程师、后端开发、产品经理、助理橙子。Skills 按角色分配：
|
|
|
|
|
|
|
|
|
|
|
|
> 职责定义：[开发团队职责定义.md](./开发团队职责定义.md) | 源码边界：[三角色边界定义.md](./三角色边界定义.md) | 入口：[.cursor/README.md](../README.md)
|
2026-02-26 18:25:34 +08:00
|
|
|
|
|
2026-02-25 11:04:08 +08:00
|
|
|
|
- **主 Skill**：开发风格与规范（必须遵循）
|
2026-02-26 18:55:22 +08:00
|
|
|
|
- **辅助 Skill**：按需选用
|
|
|
|
|
|
- **协同 Skill**：跨端时用 SKILL-角色流程控制
|
2026-02-25 11:04:08 +08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 二、优点
|
|
|
|
|
|
|
|
|
|
|
|
| 优点 | 说明 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| **职责清晰** | 每个角色对应明确的主 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
|
