# 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的拼写错误