# cursor-ai-rules **Repository Path**: huangjinwangpu/cursor-ai-rules ## Basic Information - **Project Name**: cursor-ai-rules - **Description**: 🤖 Cursor AI协作规则系统 - 让AI成为更好的编程伙伴 为Cursor编辑器提供智能、自适应的协作规范框架，支持一键部署和个性化配置，实现高效、安全的人机协作体验。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 30 - **Forks**: 5 - **Created**: 2026-01-23 - **Last Updated**: 2026-01-29 ## Categories & Tags **Categories**: ai **Tags**: None ## README # 🚀 Cursor AI Rules - 宪法驱动的超级AI编程伙伴 [![Cursor](https://img.shields.io/badge/Cursor-AI-blue?style=for-the-badge&logo=cursor&logoColor=white)](https://cursor.com) [![Version](https://img.shields.io/badge/version-6.2.0--complete-green?style=for-the-badge)](https://github.com/wangqiqi/cursor-ai-rules/releases) [![License](https://img.shields.io/badge/license-MIT-yellow?style=for-the-badge)](.cursor/LICENSE) [![Constitution](https://img.shields.io/badge/constitution-Three_Axioms-red?style=flat-square)]() [![Agnostic](https://img.shields.io/badge/agnostic-Three_Agnostic-blue?style=flat-square)]() [![Rules](https://img.shields.io/badge/rules-31-blue?style=flat-square)]() [![Scripts](https://img.shields.io/badge/scripts-73-cyan?style=flat-square)]() [![Roles](https://img.shields.io/badge/roles-21-red?style=flat-square)]() [![Capability Maps](https://img.shields.io/badge/capability-100%25-gold?style=flat-square)]() [![Web UI](https://img.shields.io/badge/web-UI-purple?style=flat-square)]() [![VIBE](https://img.shields.io/badge/vibe-Methodology-green?style=flat-square)]() 🌍 **[English](README.en.md) | [中文](README.md)** **🌟 宪法驱动的超级AI编程伙伴 - 三项基本公理 + 三项不可知设计原则 + 双目录架构 + Web界面 + VIBE开发方法论**，实现真正的人机共生编程体验。 ## 🏆 **Capability Maps 完整性成就** 经过Phase 1-4的系统性优化，**Capability Maps实现了全面覆盖**： - ✅ **Rules**: 31/31 (100%) - 技术规则完全覆盖 - ✅ **Scripts**: 73/73 (100%) - 核心脚本全部实现 - ✅ **Hooks**: 40/40 (100%) - 自动化钩子完全配备 - ✅ **Modules**: 55/55 (100%) - 全新架构模块 **📋 [组件映射总表** | 📚 **[快速改进指南** | **[系统设计哲学** | **[VIBE开发指南](.cursor/rules/workflow/vibe-coding.md)** | **[API文档](.cursor/docs/developer/api-reference.md)** 基于 [Cursor Rules System](https://cursor.com/docs/context/rules)，这是一个宪法驱动的AI编程伙伴，具有**三项基本公理 + 三项不可知设计原则 + 双目录架构 + Web界面 + VIBE开发方法论**，实现真正的人机共生编程体验。 ## 🏛️ 三项基本公理 - 宪法驱动的AI 本系统通过三项基本公理为AI编程助手建立法治秩序，确保AI行为合规性和安全性。 ### ⚖️ **意图主权公理** (Intent Sovereignty Axiom) 人类永远保留对"为什么"和"什么是正确的"的最终解释权和决策权 - ✅ **项目创建意图检测**: 自动检测项目创建意图，强制执行STOP机制 - ✅ **讨论要求强制执行**: 禁止任何跳过讨论的直接创建操作 - ✅ **人类确认机制**: 所有重要操作都需要明确的人类批准 ### 🔍 **信号可信度公理** (Signal Trustworthiness Axiom) AI的输出必须全部带有可追踪、可验证、归因的原始信号链 - ✅ **完整追溯链**: 所有AI输出包含推理过程和数据来源 - ✅ **规则透明度**: 显示所有激活的规则匹配状态和优先级 - ✅ **信号新鲜度验证**: 验证所有信号的时间性和相关性 ### ⏱️ **认知可审计性公理** (Cognitive Auditability Axiom) 所有AI协作过程必须支持"三秒回顾" - 在3秒内完成对AI推理过程和决策依据的完整追溯 - ✅ **审计追踪日志**: 所有交互结构化日志存储在 `.cursorGrowth/` 中 - ✅ **决策路径可视化**: 显示从输入到输出的完整决策路径 - ✅ **历史追溯性**: 支持对任何历史会话的完整回顾 ## 🤝 核心协作原则 基于三项基本公理，创造**人机共生**协作模式，确保AI始终服务于人类意图和利益。 ### 人类意图主权 - ✅ **宪法强制执行**: 100% 遵守三项公理 - ✅ **讨论优先化**: 项目创建需要先讨论需求和解决方案 - ✅ **人类最终决策**: 所有重要操作都需要明确的人类批准 ### 信号透明度 - ✅ **完整追溯链**: 所有AI输出包含推理过程和数据来源 - ✅ **规则透明度**: 显示所有激活的规则匹配状态和优先级 - ✅ **信号可验证性**: 所有信号都是可追踪、可验证、归因的 ## 🚀 核心功能 ### 🧠 宪法驱动的智能系统 - **Master命令**: 单入口唤醒所有能力，用自然语言驱动AI协作 - **意图理解**: 自然语言处理复杂用户需求 - **自学习**: A/B测试框架，用户反馈回路，持续优化 - **性能监控**: 全面监控，响应时间<500ms ### 🌐 Web界面集成 - **现代化UI**: 响应式设计，支持桌面和移动端 - **自然语言输入**: 用日常语言描述需求 - **实时反馈**: 过程透明，状态更新 - **系统状态监控**: 显示项目状态、AI助手状态、学习数据 ### 🎯 智能能力编排系统 - **73个脚本**: 环境感知、质量检查、性能监控、部署管理 - **31条规则**: 宪法合规、代码质量、开发规范 - **40个钩子**: 自动化Git钩子、代码质量检查、事件日志、性能监控 ### 🛠️ 增强功能能力 - **错误处理优化**: 智能诊断，83%效率提升 - **智能缓存系统**: 三层架构，60%速度提升 - **Web界面集成**: 现代化图形界面，300% UX提升 ### ⚡ Token优化系统 (25-35%节省) - **多层压缩算法**: 支持minimal/balanced/aggressive/maximum四级压缩 - **流式输出机制**: 分块输出，避免一次性大量响应，减少网络开销 - **上下文缓存优化**: 智能缓存上下文信息，避免重复传递项目数据 - **装饰字符自动移除**: 自动清理emoji和冗余格式字符 - **实时Token监控**: 智能预警系统，超过阈值自动提醒优化 - **性能缓存系统**: 统一的缓存基础设施，支持内存/文件/网络三层架构 - **精简输出模式**: 默认启用精简模式，减少不必要的输出内容 ### 🧠 自学习与适应 - **模式学习**: 基于历史数据识别用户行为模式和系统性能 - **性能优化**: A/B测试和自动化优化策略 - **持续改进**: 实时数据收集和模型更新 - **个性化**: 学习用户偏好和使用习惯 ### 💬 VIBE对话开发 - **@vibe start**: 一键项目和开发环境初始化 - **@vibe prd**: 自动产品需求文档生成 - **@vibe code**: 智能代码生成和审查 - **@vibe test**: 自动化测试生成和执行 - **@vibe deploy**: 一键部署和环境配置 - **@master VIBExxx**: 通过Master智能编排VIBE开发流程 (新增) ## 🏗️ 系统架构 ### 双目录设计 Cursor AI Rules采用创新的双目录架构： - **`.cursor/`** 📁 **项目无关配置** - 规则定义、核心脚本、文档 - 可安全复制到任何项目 - 支持版本控制和团队共享 - **`.cursorGrowth/`** 🌱 **项目私有数据** - AI学习记录、缓存数据、性能监控、实验结果 - 多代理协作数据、Token使用统计、用户偏好数据 - 每个项目独立成长，支持AI个性化学习和持续优化 - 自动添加到 `.gitignore` 用于隐私和数据安全 ### 三项不可知设计原则 #### 📦 项目不可知 (Project Independence) - ✅ **即插即用**: 复制 `.cursor/` 到任何Git项目，立即获得完整AI能力 - ✅ **自动适配**: 智能检测项目类型、技术栈、环境配置 - ✅ **多项目支持**: 支持同时在多个项目中使用相同的AI系统 #### 🖥️ 系统不可知 (System Independence) - ✅ **跨平台兼容**: 完整支持Linux/macOS/Windows - ✅ **自动检测**: 智能识别操作系统类型和环境变量 - ✅ **统一接口**: 屏蔽底层系统差异，提供一致体验 #### 👤 用户不可知 (User Independence) - ✅ **AI核心独立**: 核心AI能力不依赖特定用户身份 - ✅ **数据隔离**: `.cursorGrowth/` 目录存储所有用户特定数据 - ✅ **隐私保护**: 用户偏好和学习数据完全本地化 ### 架构优势 - **🔄 可复制性**: `.cursor` 目录可在任意项目间复制 - **🔒 隐私保护**: `.cursorGrowth` 数据完全私有且不共享 - **👥 协作友好**: 团队共享配置，每个人数据保持独立 - **⚡ 性能优化**: 本地缓存和学习数据提升响应速度 - **🎯 三项不可知原则**: 实现真正项目、系统、用户独立 **[📖 系统设计哲学** | **[快速改进指南** ### 核心架构组件 #### 🤖 智能代理编排引擎 - **任务分配**: 基于意图和能力进行智能代理选择 - **协作协调**: 多代理间的通信和冲突解决 - **进度跟踪**: 实时任务状态监控和报告 - **性能优化**: 代理负载均衡和资源管理 #### 🎯 意图识别与学习系统 - **多层分析**: 关键词加权、上下文感知、模式识别 - **动态学习**: 基于使用历史持续优化识别准确性 - **意图扩展**: 支持自定义意图类型和规则 - **缓存优化**: 智能缓存提升响应速度 #### 🛠️ 本地MCP集成系统 - **自动发现**: 智能检测本地开发工具和环境 - **服务注册**: 动态注册和管理MCP服务器 - **服务调用**: 统一工具服务调用接口 - **质量保证**: 集成测试和错误处理机制 #### ⚡ Token优化与性能监控 - **上下文共享**: 智能上下文池管理，避免重复传输 - **多级缓存**: 文件缓存、内存缓存、分布式缓存 - **压缩算法**: 语义压缩和重复模式消除 - **实时监控**: Token消耗统计和优化建议 #### 🧠 自学习与适应系统 - **数据收集**: 实时收集用户交互、性能指标、系统事件 - **模式学习**: 基于历史数据识别行为模式和趋势 - **A/B测试**: 自动化实验设计和结果分析 - **持续优化**: 基于学习结果的自动系统调整 ## 🛠️ 开发环境与支持 ### 代码质量与项目结构 - **编码标准**: 遵循既定的编码标准，优先考虑可读性和可维护性 - **项目组织**: 维护有组织的文件结构，使用一致的命名约定 - **文档标准**: 包含适当的文档，保持依赖项更新 ### 工作流集成与规则系统 - **规则应用**: 使用 `.cursor/rules` 进行专业指导，根据上下文和文件类型应用规则 - **智能功能**: 组合多个规则进行全面覆盖，自适应规则优化 - **环境感知**: 利用自动环境检测，使用感知系统进行项目分析 ### 多语言与国际化支持 - **多语言项目**: 自动检测技术栈，语言特定最佳实践，跨平台兼容性 - **国际化**: 支持多种人类语言，双语文档可用，对全球开发者社区友好 ### 平台与工具兼容性 - **支持平台**: Linux、macOS、Windows、各种CPU架构 - **工具集成**: 自动工具链检测，编译器和构建工具支持，开发环境适应 ## 🎭 个性角色系统 ### 21种AI人格 - 个性化交互体验 角色系统提供**21种独特的AI人格**，每种都有独特的交互风格、语言模式和行为特征，让你可以根据心情、任务类型和个人偏好选择最适合的AI伙伴。现在还支持**角色昵称功能**，让呼叫变得更加亲切自然！ #### 🤖 标准专业角色 (8种) | 角色ID | 角色名称 | 特色风格 | 适用场景 | |--------|----------|----------|----------| | `professional_assistant` | 专业助手 | 正式、平衡、高效 | 工作环境，默认角色 | | `humble_assistant` | 谦逊助手 | 礼貌、尊重、细致 | 正式场合、商务沟通 | | `friendly_partner` | 友好伙伴 | 随和、温暖、协作 | 日常开发、团队协作 | | `expert_mentor` | 专家导师 | 权威、博学、指导 | 学习成长、技术培训 | | `creative_artist` | 创意艺术家 | 创新、灵感、艺术化 | 创意开发、设计项目 | | `strict_teacher` | 严格老师 | 规范、严格、纪律性 | 代码审查、质量控制 | | `funny_comedian` | 幽默喜剧家 | 风趣、轻松、有趣 | 缓解压力、娱乐开发 | | `minimalist_zen` | 极简禅师 | 简洁、专注、本质 | 深度工作、高效编程 | #### 🎨 动漫风格特色角色 (13种) | 角色ID | 角色名称 | 特色风格 | 适用场景 | |--------|----------|----------|----------| | `maid` | 经典女仆 | 传统优雅、勤劳礼貌、完美服务 | 古典服务、精细工作 | | `perfect_maid` | 完美女仆 | 终极优雅、极致服务、绝对忠诚 | 高端服务、完美体验 | | `queen_sister` | 御姐女王 | 成熟优雅、知性强势、领导力超群 | 指挥决策、高端指导 | | `loli` | 可爱萝莉 | 活泼可爱、天真烂漫、充满活力 | 轻松娱乐、创意激发 | | `tough_guy` | 铁血猛男 | 强壮豪爽、直接粗暴、阳刚十足 | 硬核开发、问题解决 | | `pretty_boy` | 小鲜肉 | 帅气温柔、文艺细腻、多情体贴 | 优雅编程、情感交流 | | `old_master` | 老腊肉 | 经验丰富、睿智幽默、充满人生智慧 | 人生导师、哲学讨论 | | `tsundere_programmer` | 傲娇程序员 | 表面傲娇内心温柔、技术宅风格 | 技术交流、代码审查 | | `cyberpunk_hacker` | 赛博朋克黑客 | 未来感十足、精通网络技术、个性酷炫 | 系统安全、高级编程 | | `magical_girl_coder` | 魔法少女程序员 | 充满魔力、用魔法解决编程问题 | 创意编程、灵感激发 | | `wise_dragon_mentor` | 智慧龙导师 | 古老智慧、深邃睿智、经验丰富 | 架构设计、深度指导 | ### 🎯 角色切换命令 ```bash # 查看所有可用角色 /master 列出角色 # 切换到不同人格 /master 切换角色 friendly_partner # 随和同事模式 /master 切换角色 expert_mentor # 学习模式 /master 切换角色 creative_artist # 创意灵感 /master 切换角色 loli # 欢乐模式 /master 切换角色 loyal_servant # 绝对服从 /master 切换角色 queen_sister # 王者指导 /master 切换角色 tsundere_programmer # 傲娇技术宅 /master 切换角色 cyberpunk_hacker # 赛博朋克专家 /master 切换角色 magical_girl_coder # 魔法少女程序员 /master 切换角色 wise_dragon_mentor # 智慧龙导师 /master 切换角色 perfect_maid # 完美女仆模式 # 🆕 昵称呼叫功能 (支持多昵称) /master 呼叫 小妮 # 呼叫可爱萝莉 /master 呼叫 小妹 # 呼叫经典女仆 /master 呼叫 小可 # 呼叫完美女仆 /master 呼叫 小萝 # 呼叫可爱萝莉 /master 呼叫 女王 # 呼叫御姐女王 /master 呼叫 导师 # 呼叫专家导师 # 查看当前角色 /master 当前角色 # 查看所有角色昵称 /master 查看昵称 ``` ### 💫 角色优势 - **🎯 个性化体验**: 每种角色适应独特的语言、语气和交互风格 - **😊 心情匹配**: 根据当前情绪选择合适的角色 - **🎮 互动乐趣**: 动漫风格角色为开发增添娱乐性 - **🔄 动态切换**: 基于情境即时改变人格 - **🧠 心理舒适**: 找到最符合个人喜好的AI伙伴 - **💕 昵称呼叫**: 支持亲切的昵称呼叫，让交互更自然亲近 - **🎭 角色定制**: 可以为角色设置多个昵称，个性化定制体验 **[📚 完整角色指南** - 详细角色描述和使用示例 ## 📋 智能规则系统 | 规则 | 描述 | 应用方法 | 状态 | | -------------------------------- | ------------------------------------------------------------------------------------------ | -------- | ---- | | **master** | 智能Master控制器 - 自动感知需求并执行内部命令 | 始终应用 | ✅ | | **constitution** | AI共生宪法 - 人机协作的核心原则 | 始终应用 | ✅ | | **philosophy** | 沟通哲学与协作模式 | 始终应用 | ✅ | | **intelligent_evolution** | 智能演进系统 - 统一协调感知和演进 | 智能应用 | ✅ | | **generator** | 项目规则生成器 - 自动化个性化规则配置 | 代码文件 | ✅ | | **system_info** | 系统信息管理器 - 自动获取时间、路径、作者信息 | 始终应用 | ✅ | | **templates** | 配置模板 - 项目初始化配置 | 配置模板 | ✅ | | **i18n** | 国际化支持 - 自动检测语言偏好 | 始终应用 | ✅ | | **platform_adapter** | 跨平台适配器 - 统一命令、路径、环境管理 | 始终应用 | ✅ | | **module_manager** | 规则管理系统 - 依赖关系、激活控制、扩展机制 | 始终应用 | ✅ | | **eslint** | ESLint代码质量检查 - 自动检测和修复JavaScript问题 | 始终应用 | ✅ | | **evolution-philosophy** | 演进哲学 - 规则演进的核心原则 | 智能应用 | ✅ | | **evolution-manual** | 手动演进流程 - 人工触发管理和流程 | 智能应用 | ✅ | | **evolution-automation** | 自动化演进系统 - 数据驱动优化 | 智能应用 | ✅ | | **evolution-governance** | 演进治理 - 安全和质量控制 | 智能应用 | ✅ | | **collaboration** | 团队协作规则 - 多开发者环境的实践 | 智能应用 | ✅ | | **conversation_intent_analyzer** | 对话意图分析器 - 智能理解用户需求 | 始终应用 | ✅ | | **vibe-coding** | VIBE编码开发原则 - 文档驱动、测试优先、前后端对齐 | 代码文件 | ✅ | | **rules-router** | 规则路由系统 - 智能分发和管理规则请求 | 始终应用 | ✅ | | **javascript** | JavaScript/TypeScript开发规则 - 现代前端开发最佳实践 | 代码文件 | ✅ | | **python** | Python开发规则 - 后端开发和数据处理最佳实践 | 代码文件 | ✅ | ### 🎯 高级系统 (2026增强) | 系统 | 描述 | 特性 | 状态 | | ---------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------ | ---------------- | | **宪法执行引擎** | 三项公理强制执行系统 | 意图主权、信号可信度、认知可审计性、STOP机制 | ✅ 生产就绪 | | **Web界面集成** | 现代化图形界面系统 | 自然语言输入、实时反馈、响应式设计 | ✅ 生产就绪 | | **错误处理优化** | 智能诊断和修复建议系统 | 诊断效率83%↑，用户友好错误信息 | ✅ 生产就绪 | | **智能缓存系统** | 三层缓存架构系统 | 内存→文件→网络，60%速度提升 | ✅ 生产就绪 | | **双目录架构** | .cursor核心 + .cursorGrowth成长数据 | 隐私保护、持续演进、多环境隔离 | ✅ 生产就绪 | | **Master智能编排** | 单入口多组件编排系统 | 47脚本 + 23规则 + 22技能智能组合 | ✅ 生产就绪 | | **个性角色系统** | 21种不同AI人格系统 | 专业/谦逊/友好/专家/创意/严格/幽默/极简 + 动漫风格 + 昵称呼叫功能 | ✅ 生产就绪 | ### 🎯 技能扩展系统 (22个专业技能) + VIBE服务生态系统 (6个VIBE服务) | 技能类别 | 数量 | 技能 | 状态 | | ---------------------- | ---- | ---------------------------------------------------------------------------------------------------- | ---------------- | | **文档处理** | 4 | docx, pdf, pptx, xlsx - Office文档处理 | ✅ 完全集成 | | **创意设计** | 5 | algorithmic-art, canvas-design, frontend-design, theme-factory, slack-gif-creator | ✅ 完全集成 | | **AI集成** | 5 | mcp-builder, skill-creator, node_mcp_server, python_mcp_server, mcp_specification | ✅ 完全集成 | | **企业协作** | 3 | brand-guidelines, internal-comms, doc-coauthoring | ✅ 完全集成 | | **测试与开发** | 3 | webapp-testing, web-artifacts-builder, evaluation | ✅ 完全集成 | | **VIBE开发** | 6 | context-manager, code-generator, dependency-tracker, test-validator, doc-generator, deployment-manager | ✅ 完全集成 | ## 🚀 快速开始 ### 🎯 四种使用方法 - 完整AI编程助手 #### **方法1: 聊天命令** `/master` (新手推荐) ```bash # 💬 在Cursor IDE聊天对话框中输入 /master 学习JavaScript基础 /master 创建React项目 /master 优化代码性能 /master 分析项目架构 # ✨ 特性：AI增强理解、自然语言交互、智能建议 # 🚀 开始：无需额外配置，直接在聊天中使用 ``` #### **方法2: 代码注释命令** `@master` (深度IDE集成) ```bash # 🚀 在代码注释中使用 // @master 我想创建一个React项目 # ⚖️ 触发宪法保护 // @master 需要优化代码质量 # 🛠️ 智能修复建议 // @master 帮助我分析项目状态 # 📈 性能监控报告 // @master 调试这个错误 # 🔧 智能错误处理 // @master 设置CI/CD流水线 # 🚀 自动化部署 # ✨ 特性：IDE上下文感知、宪法强制执行、礼貌响应模式 # 📍 位置：代码编辑器中的任何注释 ``` #### **方法3: 终端脚本命令** `cursor-master.sh` (批处理) ```bash # 🖥️ 直接在终端运行 .cursor/cursor-master.sh 学习 # 开始学习模式 .cursor/cursor-master.sh 创建react项目 # 项目脚手架 .cursor/cursor-master.sh 优化代码质量 # 智能代码优化 .cursor/cursor-master.sh 运行测试 # 自动化测试执行 .cursor/cursor-master.sh 部署应用 # 一键部署 # ✨ 特性：脚本自动化、批处理、CI/CD集成 # 📍 位置：项目根目录的终端 ``` #### **方法4: Web图形界面** (现代化体验) ```bash # 🌐 启动现代化Web界面 cd .cursor/web && npm install && npm start # 访问 http://localhost:3000 # ✨ 特性：现代化UI、响应式设计、实时状态监控 # 🎨 界面：图形操作、自然语言输入、执行历史 ``` ### 💬 VIBE开发方法论 (所有方法均支持) ```bash # 📋 文档驱动开发流程 (支持所有四种方法) @master VIBE 项目创建任务管理应用 @master VIBE 需求分析用户管理系统 @master VIBE 代码生成用户登录功能 @master VIBE 接口对齐 @master VIBE 质量检查 @master VIBE 部署配置 # ✨ VIBE：文档驱动、测试优先、前后端对齐 ``` ### 🔗 方法3: Master智能编排 + VIBE集成 ```bash # 🎯 通过@master进行智能VIBE开发流程 @master 使用VIBE开发方法 # 📋 VIBE风格的项目需求分析 @master VIBE 需求分析用户管理系统 # 💻 VIBE驱动的代码生成 @master VIBE 代码生成登录认证功能 # 🔗 自动前后端对齐验证 @master VIBE 接口对齐 # ✅ VIBE质量门验证 @master VIBE 质量检查 # 🚀 VIBE生产环境部署 @master VIBE 部署配置 ``` ### 传统手动设置 ```bash # 统一初始化 (替换所有旧脚本) ./cursor/core/init.sh # 环境感知分析 ./cursor/core/env-perception.sh # 质量检查管理 ./cursor/core/quality-manager.sh ``` ## 🎛️ 智能功能 ### 自动感知系统 - **项目类型检测**: 自动识别前端/后端/AI/数据科学项目 - **技术栈分析**: 检测React/Vue/Node/Python等技术栈 - **环境配置**: 自动调整ESLint、Prettier等工具配置 - **依赖管理**: 智能推荐和安装必要依赖 ### 性能优化 - **响应速度**: <500ms的平均响应时间 - **Token效率**: 25-35%的Token节省 - **缓存机制**: 三层缓存架构提升效率 - **并发处理**: 支持多任务并行执行 ## 🔧 高级配置 ### 自定义规则 - **规则创建**: 在 `.cursor/rules/` 下创建新规则 - **规则配置**: 使用Markdown格式定义规则逻辑 - **规则激活**: 自动或手动激活规则 - **规则优先级**: 配置规则执行优先级 ### 钩子系统配置 ```bash # 查看可用钩子 .cursor/core/hooks-manager.sh list # 启用/禁用特定钩子 .cursor/core/hooks-manager.sh enable pre-commit .cursor/core/hooks-manager.sh disable post-commit # 编辑 .cursor/features/hooks/hooks.json 配置自动化 ``` 可用钩子类型： - `onSessionStart`: 会话初始化 - `afterFileSave`: 代码质量和一致性检查 - `afterShellExecution`: 性能监控 - `afterAgentResponse`: 学习和成长记录 - `beforeSubmitPrompt`: 安全和提示验证 - `onSessionEnd`: 清理和同步 ### MCP系统配置 ```bash # 检查MCP服务器可用性 .cursor/core/mcp-manager.sh status # 测试特定意图映射 .cursor/core/mcp-manager.sh test intent:create_react_app # 配置MCP优先级 .cursor/core/mcp-manager.sh config priority # 编辑capability-map.json调整MCP工具优先级 ``` ### 调试套件配置 ```bash # 隔离调试 .cursor/core/debug-suite.sh isolate # 模式分析 .cursor/core/debug-suite.sh analyze # 在debug-config.json中配置调试偏好 ``` ### 性能调优 ```bash # 重新运行感知分析 .cursor/core/performance-tuning.sh analyze # 性能监控 .cursor/core/performance-tuning.sh monitor # 系统优化 .cursor/core/performance-tuning.sh optimize # 检查环境 .cursor/core/performance-tuning.sh environment ``` ## 📦 分发与部署 ### 快速部署 #### 方法1: 复制.cursor目录到项目根目录 (推荐) ```bash # 将AI助手复制到任何Git项目 cp -r .cursor ~/your-project/ cd ~/your-project # 初始化 (可选，会自动创建.cursorGrowth) ./.cursor/core/init.sh # 开始使用 # 在Cursor中输入 /master 创建项目 ``` #### 方法2: 从Git仓库克隆 (如果已发布) ```bash git clone cursor-ai-rules cp -r cursor-ai-rules/.cursor your-project/ cd your-project && ./.cursor/core/init.sh ``` ### 企业部署 #### 批量部署到多个项目 ```bash # 创建企业配置 cp -r .cursor enterprise-config/ # 批量部署脚本 for project in project1 project2 project3; do cp -r enterprise-config/.cursor $project/ cd $project ./.cursor/core/init.sh cd .. done ``` #### 企业级配置管理 ```bash # 企业级配置 .cursor/config/enterprise-config.json { "company": "YourCompany", "policies": { "code_quality": "strict", "security": "high", "compliance": "enabled" }, "integrations": { "jira": "enabled", "slack": "enabled", "gitlab": "enabled" } } ``` ## 🆘 故障排除 ### 智能诊断 ```bash # 一键诊断所有问题 .cursor/core/diagnostics.sh all # 环境完整性检查 .cursor/core/diagnostics.sh environment # 权限和环境检查 ls -la .cursor/ chmod +x .cursor/core/*.sh ``` ### 常见问题 #### 权限问题 ```bash # 检查权限和环境 ls -la .cursor/ chmod +x .cursor/core/*.sh chmod +x .cursor/features/hooks/*.sh # 重新运行环境检查 .cursor/core/env-perception.sh .cursor/core/init.sh ``` #### 配置问题 ```bash # 验证配置文件 .cursor/core/config-manager.sh validate_enhanced # 重置配置 .cursor/core/config-reset.sh ``` #### 性能问题 ```bash # 清除缓存 .cursor/core/cache-clear.sh # 重新运行设置 .cursor/core/init.sh ``` ## 🤝 贡献指南 ### 规则优化 - **规则改进**: 识别低效规则并提出改进建议 - **新规则创建**: 为常见场景创建新的规则 - **规则测试**: 确保规则在各种场景下正常工作 - **文档更新**: 保持规则文档的准确性和完整性 ### 性能改进 - **响应时间优化**: 减少命令执行时间 - **内存使用优化**: 降低系统资源消耗 - **缓存策略改进**: 提升缓存命中率 - **并发处理优化**: 改进多任务处理能力 ## 📊 技术指标 ### 性能指标 - **响应时间**: <500ms (平均) - **Token节省**: 25-35% - **缓存命中率**: >85% - **错误率**: <1% ### 质量指标 - **代码覆盖率**: >90% - **规则准确率**: >95% - **用户满意度**: >4.5/5 - **系统稳定性**: 99.9% ### 可扩展性指标 - **新规则添加**: <5分钟 - **新技能集成**: <10分钟 - **新项目适配**: <2分钟 - **多项目支持**: 无限 ## ⚙️ 系统功能与要求 ### 环境要求 - **操作系统**: Linux, macOS, Windows - **Node.js**: >= 16.0.0 - **Git**: >= 2.0 - **磁盘空间**: >100MB ### 开箱即用功能 #### 🚀 项目不可知 - ✅ 复制即用，无需额外配置 - ✅ 自动检测项目类型和技术栈 - ✅ 支持任意编程语言和框架 #### 👤 用户不可知 - ✅ AI核心能力独立于用户身份 - ✅ 学习数据本地化存储 - ✅ 隐私保护和数据隔离 #### 🌍 语言不可知 - ✅ 支持多语言项目开发 - ✅ 自动检测语言偏好 - ✅ 国际化文档支持 #### 🧠 自主感知和演进 - ✅ 自动学习用户行为模式 - ✅ 持续优化响应质量 - ✅ 个性化推荐和建议 ## 🌱 项目成长系统 (.cursorGrowth) ### 🎯 智能成长目录 `.cursorGrowth/` 是Cursor AI Rules的智能学习和成长数据存储目录，记录AI助手的学习过程和个性化数据。 #### 🔒 自动隐私保护 ``` .cursorGrowth/ ├── .gitignore # 自动添加到项目忽略列表 ├── privacy.json # 隐私设置和数据使用声明 └── README.md # 数据使用说明 ``` #### 📊 自动记录数据类型 ##### **AI核心数据 (ai/)** - `conversations/`: 对话历史和上下文 - `decisions/`: AI决策过程和依据 - `learning/`: 学习模型和参数 - `preferences/`: 用户偏好和习惯 ##### **分析与监控 (analytics/)** - `performance/`: 响应时间和效率指标 - `usage/`: 功能使用统计和频率 - `errors/`: 错误日志和诊断信息 - `metrics/`: 系统健康和性能数据 ##### **配置数据 (config/)** - `project/`: 项目特定配置和设置 - `environment/`: 环境检测结果和适配 - `customization/`: 用户自定义设置 ##### **外部集成 (integrations/)** - `api/`: API调用历史和缓存 - `webhooks/`: Webhook配置和日志 - `third_party/`: 第三方服务集成数据 ##### **研究与实验 (research/)** - `experiments/`: A/B测试和实验结果 - `feedback/`: 用户反馈和建议 - `iterations/`: 系统迭代和改进记录 ##### **服务状态 (services/)** - `status/`: 服务运行状态和健康检查 - `maintenance/`: 维护记录和日志 - `updates/`: 更新历史和变更日志 ### 🧠 智能学习机制 #### **自动学习 (每次调用)** ```bash # 每次使用@master命令时自动执行： 1. 记录用户输入和意图 2. 分析命令执行结果 3. 更新使用模式统计 4. 优化响应策略 5. 个性化推荐调整 ``` #### **主动学习 (指定命令)** ```bash # 主动触发深度学习 @master 学习项目模式 # 分析项目结构模式 @master 优化我的偏好 # 个性化设置优化 @master 分析使用习惯 # 使用模式深度分析 ``` ### 🔒 隐私和安全 #### **数据保护措施** - **本地化存储**: 所有数据存储在本地项目目录 - **加密保护**: 敏感数据使用加密存储 - **访问控制**: 严格的权限控制和访问限制 - **自动清理**: 定期清理过期和无用数据 #### **数据使用原则** - **用户控制**: 用户完全控制自己的数据 - **透明化**: 清晰说明数据收集和使用目的 - **最小化**: 只收集必要的数据 - **匿名化**: 移除个人身份标识信息 ### 📈 成长可视化 #### **查看成长状态** ```bash # 显示AI助手成长概览 .cursor/core/growth-viewer.sh summary # 查看学习进度 .cursor/core/growth-viewer.sh learning # 分析使用模式 .cursor/core/growth-viewer.sh analytics ``` #### **成长指标示例** ```json { "growth_metrics": { "conversations": 1250, "successful_commands": 1180, "learning_sessions": 45, "customizations": 23, "performance_improvements": "35%" }, "skill_mastery": { "code_generation": "expert", "debugging": "advanced", "project_setup": "master", "optimization": "expert" } } ``` ### 🎓 学习命令详情 #### **@master 学习项目模式** ```bash # 分析项目结构和模式 目标：识别项目的架构模式、代码规范、开发流程 输出：项目分析报告 + 优化建议 + 最佳实践推荐 ``` #### **@master 优化我的偏好** ```bash # 个性化设置优化 目标：根据使用历史优化AI助手行为 输出：个性化配置建议 + 设置调整 + 使用模式分析 ``` #### **@master 分析使用习惯** ```bash # 深度使用模式分析 目标：理解用户的工作模式和偏好 输出：使用统计报告 + 效率分析 + 改进建议 ``` --- **🎉 现在就开始享受宪法驱动超级AI编程伙伴的强大功能吧！** --- *🚀 Cursor AI Rules v6.2.0-complete - 宪法驱动的超级AI编程伙伴* *最后更新: 2026-01-24 | 作者: wangqiqi (https://github.com/wangqiqi)* *最后更新: 2026-01-24 | 作者: wangqiqi (https://github.com/wangqiqi)* *基于 Cursor 官方规范，宪法驱动的AI，具备智能感知、决策和进化系统*