project-rules.mdc 1.4 KB

1234567891011121314151617
  1. ---
  2. description: 全项目 AI 代码生成规范、复用原则与生产安全底线
  3. alwaysApply: true
  4. ---
  5. # Project Rules
  6. - AI 必须优先遵守 `docs/AI_SPECS.md`,生成代码前先理解现有目录、技术栈和局部实现风格。
  7. - 优先复用已有组件、工具函数、API 封装、Vuex 模块、SCSS 变量、图表配置和服务端工具;不要为单个需求创建新的架构方案。
  8. - 保持现有 JavaScript / Vue 2 Options API 风格,不主动迁移到 TypeScript、Vue 3、Composition API 或其他框架。
  9. - 修改范围应尽量小、可回滚;不得无理由重构无关文件或格式化大文件。
  10. - 不得输出、复制或硬编码密钥、token、数据库密码、MinIO 凭据、私有服务口令或 `.env*` 中的敏感值。
  11. - 禁止修改 PM2 配置、部署脚本、nginx 配置、生产环境变量和代理目标,除非用户明确要求并确认风险。
  12. - 修改接口必须保持兼容:原 URL、请求方法、字段名、返回结构不破坏;新增字段必须可选并兼容旧数据。
  13. - 涉及数据库结构或数据迁移时,先生成迁移方案、回滚方案和兼容性说明,不得直接改库。
  14. - 新增或修改主题时须主题隔离:不得因新主题改动 `tech-blue`、`green` 等已有主题的样式;见 `.cursor/rules/theme-rules.mdc`。
  15. - 修改后优先使用项目现有 lint/构建/局部验证方式;无法验证时必须说明风险。