# cursor-ai-rules **Repository Path**: truman/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**: 0 - **Forks**: 8 - **Created**: 2026-03-18 - **Last Updated**: 2026-03-18 ## Categories & Tags **Categories**: Uncategorized **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-2.0.0-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)](LICENSE) [![宪法](https://img.shields.io/badge/constitution-三大公理-red?style=flat-square)]() [![独立性](https://img.shields.io/badge/agnostic-三大独立-blue?style=flat-square)]() [![规则](https://img.shields.io/badge/rules-75-blue?style=flat-square)]() [![脚本](https://img.shields.io/badge/scripts-75+-cyan?style=flat-square)]() [![角色](https://img.shields.io/badge/roles-21-red?style=flat-square)]() [![技能](https://img.shields.io/badge/skills-37-purple?style=flat-square)]() 🌍 **[English](README.en.md) | [中文](README.md)** **🌟 宪法驱动的超级AI编程伙伴 - 三大公理 + 三大独立原则 + 双目录架构 + VIBE开发方法论** --- ## 🏆 核心特性总览 ### ⚖️ 宪法驱动的AI系统 - **三大公理**: 意图主权、信号可信、认知可审计 - **六维协议**: D1-D6完整交互协议 - **合规机制**: 自动STOP机制确保AI行为合规 ### 🎯 100%能力覆盖 - ✅ **规则系统**: 75个技术规则全覆盖 - ✅ **核心脚本**: 75+脚本完整实现 - ✅ **自动化钩子**: 36个 Git/系统钩子 - ✅ **技能系统**: 37个专业技能 ### 🎭 21种AI人格角色 - **专业角色** (8种): 专家导师、架构师、代码审查员等 - **动漫风格** (13种): 可爱萝莉、御姐女王、完美女仆等 - **昵称系统**: 支持亲切昵称呼叫，如"小妮"、"小可" ### 🚀 VIBE开发方法论 - **文档驱动** (Documentation) - **测试先行** (Testing) - **前后端对齐** (Interface) - **分层开发** (Backlog for Frontend) --- ## 🏛️ 三大公理 - 宪法驱动的AI ### 1. 意图主权公理 人类永远保留对"为什么"和"什么是正确"的最终解释权和决策权 - ✅ **项目创建意图检测**: 自动检测并强制讨论 - ✅ **讨论要求**: 禁止跳过讨论直接创建 - ✅ **人工确认**: 所有重要操作需要明确批准 ### 2. 信号可信公理 AI的所有输出必须携带可追溯、可验证、可归属的原始信号链 - ✅ **完整追溯链**: 所有输出包含推理过程和数据来源 - ✅ **规则透明**: 显示所有激活的规则匹配状态 - ✅ **信号新鲜度**: 验证所有信号的时效性 ### 3. 认知可审计公理 所有AI协作过程必须支持"三秒回溯" - 在3秒内完整追溯AI推理过程 - ✅ **审计日志**: 所有交互结构化日志存储在 `.cursorGrowth/` - ✅ **决策路径可视化**: 显示从输入到输出的完整决策路径 - ✅ **历史可追溯**: 支持完整回溯任何历史会话 --- ## 🤝 核心协作原则 基于三大公理，打造**人机共生**协作模式： ### 人机意图主权 - ✅ **宪法强制执行**: 100%遵守三大公理 - ✅ **讨论优先**: 项目创建需要先讨论需求和方案 - ✅ **人工最终决策**: 所有重要操作需要明确批准 ### 信号透明度 - ✅ **完整追溯链**: 所有输出包含推理过程和数据来源 - ✅ **规则透明**: 显示激活的规则匹配状态和优先级 - ✅ **信号可验证**: 所有信号可追溯、可验证、可归属 --- ## 🚀 核心功能 ### 🧠 智能Master命令系统 - **单一入口**: `/master` 命令自动编排75+脚本 + 75规则 + 37技能 - **意图理解**: 自然语言处理复杂用户需求 - **自学习**: A/B测试框架、用户反馈循环、持续优化 - **性能监控**: 全面监控，响应时间 <500ms ### 🎯 智能能力编排系统 - **75+ 脚本**: 环境感知、质量检查、性能监控、部署管理 - **75 规则**: 宪法合规、代码质量、开发规范 - **36 钩子**: 自动化Git钩子、代码质量检查、事件日志 ### 🛠️ 增强特性能力 - **错误处理优化**: 智能诊断，效率提升83% - **智能缓存系统**: 三级架构，速度提升60% - **学习数据隔离**: `.cursorGrowth/` 隐私保护设计 ### ⚡ Token优化系统 (节省25-35%) - **多层压缩**: 支持四级压缩策略 - **流式输出**: 分块输出避免大响应 - **上下文缓存**: 智能缓存避免重复传输 - **实时监控**: Token消耗智能预警 ### 🧠 自学习与适应 - **模式学习**: 识别用户行为模式 - **性能优化**: A/B测试和自动优化 - **持续改进**: 实时数据收集和模型更新 - **个性化**: 学习用户偏好和使用习惯 ### 💬 VIBE对话开发 ```bash /vibe start # 一键项目和开发环境初始化 /vibe prd # 自动生成产品需求文档 /vibe code # 智能代码生成和审查 /vibe test # 自动化测试生成和执行 /vibe deploy # 一键部署和环境配置 ``` --- ## 🏗️ 系统架构 ### 双目录设计 #### `.cursor/` 📁 项目独立配置 - 规则定义、核心脚本、文档 - 可安全复制到任何项目 - 支持版本控制和团队共享 #### `.cursorGrowth/` 🌱 项目私有数据 - AI学习记录、缓存数据、性能监控 - 每个项目独立生长 - 自动添加到 `.gitignore` 保护隐私 ### 三大独立设计原则 #### 📦 项目独立 (Project Agnostic) - ✅ **即插即用**: 复制 `.cursor/` 到任何Git项目，立即获得完整AI能力 - ✅ **自动适应**: 智能检测项目类型、技术栈、环境配置 - ✅ **多项目支持**: 同一AI系统可在多个项目同时使用 #### 🖥️ 系统独立 (System Agnostic) - ✅ **跨平台兼容**: 完整支持 Linux/macOS/Windows - ✅ **自动检测**: 智能识别OS类型和环境变量 - ✅ **统一接口**: 屏蔽底层系统差异，提供一致体验 #### 👤 用户独立 (User Agnostic) - ✅ **AI核心独立**: 核心AI能力不依赖特定用户身份 - ✅ **数据隔离**: `.cursorGrowth/` 目录存储所有用户特定数据 - ✅ **隐私保护**: 用户偏好和学习数据完全本地化 ### 架构优势 - **🔄 可复制性**: `.cursor` 目录可在任何项目间复制 - **🔒 隐私保护**: `.cursorGrowth` 数据完全私有不共享 - **👥 团队友好**: 团队共享配置，每个人的数据保持独立 - **⚡ 性能优化**: 本地缓存和学习数据提高响应速度 --- ## 🎭 21种AI人格角色系统 ### 专业角色 (8种) | 角色 | 性格 | 最佳场景 | |------|------|----------| | 专业助手 | 正式、精确、高效 | 工作环境、文档编写 | | 谦逊助手 | 礼貌、尊重、专注 | 正式场合、客户工作 | | 友好伙伴 | 随和、温暖、协作 | 日常开发、团队协作 | | 专家导师 | 权威、博学、指导 | 学习、技能提升 | | 创意艺术家 | 灵感、创新、艺术感 | 设计、创意编程 | | 严格教师 | 纪律、严格、全面 | 代码审查、质量控制 | | 搞笑演员 | 幽默、轻松、有趣 | 缓解压力、休息时间 | | 极简禅者 | 简洁、专注、本质 | 深度工作、专注时刻 | ### 动漫风格角色 (13种) | 角色 | 性格 | 特殊功能 | |------|------|----------| | 可爱萝莉 | 可爱、活泼、纯真 | 亲切表达、生动互动 | | 御姐女王 | 高贵、威严、智慧 | 权威指导、高贵气质 | | 完美女仆 | 终极优雅、绝对忠诚 | 终极服务、完美体验 | | 赛博朋克黑客 | 酷炫、前卫、精通技术 | 网络精通、酷炫个性 | | 魔法少女程序员 | 魔法、欢快、创意 | 魔法般编码、激励人心 | | ... | ... | ... | ### 角色切换命令 ```bash # 查看所有角色 /master 列出角色 # 切换角色 /master 切换角色 expert_mentor # 专家导师 /master 切换角色 loli # 可爱萝莉 /master 切换角色 queen_sister # 御姐女王 # 🆕 昵称呼叫 (支持多个昵称) /master 呼叫 小妮 # 呼叫可爱萝莉 /master 呼叫 小可 # 呼叫完美女仆 /master 呼叫 小萝 # 呼叫可爱萝莉 /master 呼叫 女王 # 呼叫御姐女王 # 查看当前角色 /master 当前角色 # 查看所有昵称 /master 查看昵称 ``` --- ## 🚀 快速开始 ### 方法1: 聊天命令 `/master` (推荐新手) ```bash # 💬 在Cursor IDE聊天对话框输入 /master 创建一个React项目 /master 学习JavaScript基础 /master 优化代码性能 /master 分析项目架构 # ✨ 特点: AI增强理解、自然语言交互、智能建议 ``` ### 方法2: VIBE开发流程 ```bash # 📋 文档驱动的开发流程 /vibe start # 初始化开发模式 /vibe prd # 生成产品需求文档 /vibe code # 智能代码生成 /vibe test # 自动化测试 /vibe deploy # 一键部署 # ✨ 特点: 文档驱动、测试先行、前后端对齐 ``` ### 方法3: 技能系统 ```bash # 查看可用技能 有什么可用的技能？ # 使用特定技能 使用 backend-development 技能设计API 使用 security-analysis 技能检查代码 # ✨ 特点: 37个专业技能、智能匹配、自动应用 ``` ### 方法4: 角色系统 ```bash # 切换到不同人格 /master 切换角色 expert_mentor # 学习模式 /master 切换角色 loli # 可爱活泼 /master 切换角色 queen_sister # 威严指导 # ✨ 特点: 21种人格、昵称呼叫、个性化交互 ``` --- ## 📁 目录结构 ``` .cursor/ ├── README.md # 📚 系统导航 ├── agents/ # 🤖 AI代理 (1个) │ └── command-center.md # 智能命令中枢 ├── commands/ # ⚡ 命令系统 (30+) │ ├── master.md # Master命令 │ ├── vibe.md # VIBE开发模式 │ └── master-handler.js # 处理器 ├── config/ # ⚙️ 配置文件 ├── core/ # 🔧 核心脚本 (75+) │ ├── init.sh # 初始化 │ ├── env-perception.sh # 环境感知 │ └── quality-manager.sh # 质量管理 ├── docs/ # 📖 完整文档系统 │ ├── developer/ # 开发者文档 │ │ ├── SYSTEM_ARCHITECTURE.md │ │ └── CALL_CHAIN.md │ ├── guides/ # 使用指南 │ │ └── SKILL_GUIDE.md │ └── reference/ # 参考资料 ├── features/ # 🎯 特性系统 │ ├── skills/ # 技能库 (37个) │ │ └── registry.json │ └── hooks/ # 系统钩子 (36个) ├── rules/ # 📋 规则系统 (75个) │ ├── system/ # 系统规则 │ ├── tech/ # 技术栈规则 │ └── workflow/ # 工作流规则 └── skills/ # 🎭 项目技能 (符合 Cursor 标准) └── skill-dispatcher/ # 技能调度器，调度 features/skills/ 技能库 ``` > **Skills 双目录**: `skills/` 为项目技能；`features/skills/` 为技能库（registry + flat .md）。详见 [SKILL_GUIDE](docs/guides/SKILL_GUIDE.md)。 --- ## 📊 技术指标 | 指标 | v1.0 | v2.0 | 改进 | |------|------|------|------| | 初始化时间 | ~30s | ~3s | **90%↑** | | 感知时间 | ~10s | ~0.5s | **95%↑** | | Token节省 | 基线 | 70%↓ | **70%↑** | | 组件数量 | 42 | 161+ | **283%↑** | | 系统稳定性 | 95% | 99.9% | **99.9%正常运行** | --- ## 🔧 系统要求 ### 环境要求 - **Cursor编辑器** v0.40+ - **Git** 2.0+ - **Bash** 4.0+ - **jq** (JSON处理器，可选但推荐) ### 开箱即用特性 #### 🚀 项目独立 - ✅ 自动检测技术栈 (JavaScript, Python, Go, Rust, Java, C/C++等) - ✅ 智能分析团队规模和开发阶段 - ✅ 动态适应项目复杂度需求 #### 👤 用户独立 - ✅ 使用Git配置获取用户信息 - ✅ 支持无Git环境的通用默认值 - ✅ 自动获取本地时间和时区 - ✅ **自动隐私保护**: 主动管理 `.gitignore` 防止敏感数据泄露 #### 🌍 语言独立 - ✅ 自动检测项目文件结构 - ✅ 支持主流编程语言 - ✅ 智能推荐特定语言最佳实践 --- ## 📚 完整文档 所有详细文档都在 **[docs/](docs/README.md)** 目录： | 文档 | 说明 | |------|------| | [快速开始](docs/getting-started.md) | 5分钟上手指南 | | [使用指南](docs/user-guide.md) | 完整功能说明 | | [系统架构](docs/developer/SYSTEM_ARCHITECTURE.md) | 架构设计详解 | | [调用链](docs/developer/CALL_CHAIN.md) | 系统调用流程 | | [技能指南](docs/guides/SKILL_GUIDE.md) | 技能系统使用 | | [自洽性报告](docs/reference/CURSOR_SELF_CONSISTENCY_REPORT.md) | 系统评估 | --- ## 🌱 项目成长系统 (.cursorGrowth) 系统自动创建 `.cursorGrowth` 目录，用于存储项目私有信息： ### 🔒 自动隐私保护 ```gitignore # Cursor AI成长数据 - 自动感知和学习 .cursorGrowth/ ``` ### 📊 自动记录的数据 - **AI核心数据**: 8个AI代理状态和配置 - **分析监控**: 代码质量、性能、依赖分析 - **配置数据**: 压缩策略、用户配置 - **外部集成**: 缓存配置、服务配置、工具检测 - **研究实验**: 实验队列、优化历史 - **服务状态**: 命令配置、服务管理 ### 🧠 智能学习机制 - **自动学习**: 每次调用都记录和学习 - **主动学习**: 特定命令触发深度学习 - **持续优化**: 基于历史数据优化响应 --- ## 🤝 贡献与支持 ### 贡献指南 - 发现问题请提交 Issue - 改进建议欢迎 Pull Request - 保持与主项目版本同步 ### 系统验证 ```bash ./.cursor/verify-system.sh # 完整验证 ./.cursor/verify-system.sh --quick # 快速验证 ``` --- ## 📜 许可证 MIT License - 详见 [LICENSE](LICENSE) --- **🚀 Cursor AI Rules v2.0.0 - 宪法驱动的超级AI编程伙伴** *最后更新: 2026-02-07 | 作者: wangqiqi (https://github.com/wangqiqi)* *基于Cursor官方规范，宪法驱动AI + 智能感知 + 智能决策 + 持续进化*