# cursor-guide **Repository Path**: cuone/cursor-guide ## Basic Information - **Project Name**: cursor-guide - **Description**: 常用 Cursor AI 编程开发规则和文档管理 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 1 - **Created**: 2025-06-19 - **Last Updated**: 2025-08-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: cursor, rules ## README # Cursor Guide **Cursor Guide** 是专为 Cursor IDE 设计的通用规则模板和使用指南,提供标准化的开发规范、MCP工具配置以及使用记录,便于在不同项目中复用和定制。 ## 核心特性 - **规则模板库**:完整的 `.cursor/rules/` 目录结构,包含通用规则模板 - **开发规范系统**:涵盖通用开发规范、Git规范、多语言多框架规范 - **MCP 工具集成**:集成 Context 7、Sequential Thinking、MCP Feedback Enhanced - **多技术栈**:内置主流框架及语言规范 - **可复用性**:模板化设计,便于在不同项目中复用和定制 ## 项目结构 ``` cursor-guide/ ├── .cursor/rules/ # Cursor 规则配置目录 │ ├── always/ # 始终应用规则 │ │ ├── core.mdc # 通用开发规范 │ │ └── git.mdc # Git版本控制规范 │ ├── auto-select/ # 自动选择规则 │ │ ├── languages/ # 编程语言规则 │ │ ├── frameworks/ # 框架规则 │ │ └── tools/ # 工具规则 │ ├── agent/ # AI助手专用规则 (预留) │ └── manual/ # 手动选择规则 │ ├── dev-document.mdc # 开发文档编写规则 │ ├── mcp-feedback.mdc # MCP反馈工具规则 │ └── riper5.mdc # Riper5工具规则 ├── .docs/ # 文档目录 │ └── 01-常用MCP安装配置.md # MCP 工具安装配置指南 ├── LICENSE # MIT开源协议 └── README.md # 项目说明 ``` ## 快速上手 1. **复制规则模板**:将 `.cursor/rules/` 目录复制到新项目中,根据需求定制 2. **应用开发规范**:根据项目需求选择合适的规则文件,通过开发规范提高代码质量和一致性 3. **配置 MCP**:安装和配置 MCP 工具增强 AI 能力,充分利用 MCP 工具 4. **项目文档**:建议放置在 `.docs` 目录中 ## 最佳实践 ### 结构化开发流程 结合使用项目中的规范工具,建立完整的开发工作流: 1. **问题分析阶段**:使用 `@riper5.mdc` 的研究模式,深入分析项目需求和问题 2. **方案设计阶段**:按照 `@dev-document.mdc` 的规范,输出需求分析文档和概要设计 3. **开发规划阶段**:使用 `@riper5.mdc` 的规划模式,制定详细的开发计划和实施清单 4. **代码实施阶段**:严格按照 `@riper5.mdc` 的执行模式,按计划实施代码修改 5. **质量审查阶段**:使用 `@riper5.mdc` 的审查模式,验证实施与计划的一致性 6. **文档完善阶段**:按照 `@dev-document.mdc` 的规范,输出详细设计文档和部署说明 ### 工具协作原则 - **RIPER-5模式**:确保开发过程的严格控制和可追溯性 - **文档规范**:保证项目文档的标准化和完整性 - **Git规范**:使用 `@git.mdc` 生成标准化的提交信息,确保版本控制的一致性 - **规范驱动**:通过开发规范提高代码质量和团队协作效率 - **持续改进**:根据使用反馈不断完善规则模板和工作流程 ## 最新更新 ### 2025-08-21 - **项目结构更新**:根据实际目录结构更新了README.md - **规则文件完善**:已完成核心规则文件的创建 - **内容准确性修正**:修正了README中关于AI指令系统的错误描述,使其准确反映实际文件内容 - **文件命名修正**:修正了dev-document.mdc的拼写错误