3.7 KiB
3.7 KiB
角色驱动 Skills 方式 - 分析与完善
一、当前方式概述
开发团队五角色：小程序开发工程师、管理端开发工程师、后端开发、产品经理、助理橙子。Skills 按角色分配：
职责定义：开发团队职责定义.md | 源码边界：三角色边界定义.md | 入口：.cursor/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 开发者数据库操作时」 |
四、完善措施（已实施）
- README：增加「目录→角色→Skills」速查表；辅助 Skill 补充「何时选用」。
- soul-project-boundary：开发时增加「根据当前编辑目录推断角色，加载对应主 Skill」。
- 主 Skill：增加 YAML frontmatter，description 含触发词（miniprogram、soul-admin、soul-api）。
- 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