Files
soul-yongping/.cursor
..

Soul 创业派对 - .cursor 配置说明

本目录的 rules 与 skills 均为**当前项目Soul 创业派对)**服务,用于约束开发、防止互窜、减少漏改。

会话启动自检:新 Cursor 打开本项目时,应优先执行 soul-project-boundary 中的「会话启动自检」,仅沿用本项目的 rules、skills、开发风格与配置参数排除无关的全局或其它项目规则。


一、Rules 执行顺序与生效范围

规则文件 生效范围 alwaysApply 用途
soul-project-boundary.mdc **(全项目) 总入口:项目组成、防互窜原则、开发时索引
soul-change-checklist.mdc miniprogram、soul-admin、soul-api 变更后必过:关联层检查清单,防漏改
soul-miniprogram-boundary.mdc miniprogram/**/* 小程序:只调 /api/miniprogram/*
soul-admin-boundary.mdc soul-admin/**/* 管理端:只调 /api/admin/、/api/db/
soul-api-boundary.mdc soul-api/**/*.go soul-api路由按使用方归类
soul-api-coding.mdc soul-api/**/*.go soul-apiGORM、Model、响应等编码规范
api-reliability.mdc next-project/**/* 仅 next-project 参考TypeScript/Next API

执行逻辑alwaysApply 的规则始终生效;其余按当前编辑文件路径匹配 glob匹配到的规则同时生效无先后依赖。


二、Skills 索引(按编辑目录选用)

编辑目录 主 Skill 辅助 Skill
miniprogram/ SKILL-小程序开发.md SKILL-三端架构与框架分析.md框架/语法、SKILL-API开发.md、SKILL-变更关联检查.md
soul-admin/ SKILL-管理端开发.md SKILL-三端架构与框架分析.md、SKILL-API开发.md、SKILL-变更关联检查.md
soul-api/ SKILL-API开发.md soul-api-coding.mdc、SKILL-三端架构与框架分析.md、SKILL-变更关联检查.md
next-project/ SKILL-next-project仅预览.md api-reliability.mdc若改 Next API

拆解项目时:有类似 next-project 的 Next.js 全栈项目需拆为前后端分离 + 小程序时,使用 SKILL-Next全栈拆解为前后端分离与小程序.md;拆解前必读 SKILL-三端架构与框架分析.md(小程序/H5/UniApp 语法与框架约束)。

变更时:无论改哪端,改完都需过 soul-change-checklist.mdc,并参考 SKILL-变更关联检查.md

Skills 迭代Skills 会随 bug 修复与项目演进持续升级。修 bug 时若发现规则、流程或约定有遗漏或错误,应同步更新对应 Skill避免同类问题复现。


三、无冲突、无顺序依赖

  • 各 boundary 规则按目录互斥(改 miniprogram 不会触发 soul-admin-boundary
  • soul-api-boundary 与 soul-api-coding 同作用于 soul-api内容互补边界 vs 编码),不冲突。
  • soul-change-checklist 与各 boundary 互补boundary 管「能做什么」checklist 管「改完要检查什么」)。