🚀 Cursor AI Rules - 宪法驱动的超级AI编程伙伴

# 🚀 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.1.0--polite-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-23-blue?style=flat-square)]()
[![Skills](https://img.shields.io/badge/skills-24-orange?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开发方法论**，实现真正的人机共生编程体验。

📚 **[快速改进指南](docs/guides/quick-improvements-and-web-guide.md)** | **[系统设计哲学](docs/architecture/system-design-philosophy.md)** | **[VIBE开发指南](rules/workflow/vibe-coding.md)** | **[API文档](docs/api/hooks-api.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助手状态、学习数据

### 🎯 智能能力编排系统
- **47个脚本**: 环境感知、质量检查、性能监控、部署管理、VIBE服务集成
- **23个规则**: 宪法合规、代码质量、开发规范
- **22个技能**: 文档处理、图像生成、数据分析、AI集成
- **23个钩子**: 自动化Git钩子、代码质量检查、事件日志、性能监控

### 🛠️ 增强功能能力
- **错误处理优化**: 智能诊断，83%效率提升
- **智能缓存系统**: 三层架构，60%速度提升
- **Web界面集成**: 现代化图形界面，300% UX提升

### ⚡ Token优化系统 (25-35%节省)
- **上下文共享**: 智能上下文池管理，避免重复传输
- **智能缓存**: 多层缓存策略，提升响应速度
- **压缩算法**: 重复模式识别和语义压缩
- **性能监控**: 实时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` 数据完全私有且不共享
- **👥 协作友好**: 团队共享配置，每个人数据保持独立
- **⚡ 性能优化**: 本地缓存和学习数据提升响应速度
- **🎯 三项不可知原则**: 实现真正项目、系统、用户独立

**[📖 系统设计哲学](docs/architecture/system-design-philosophy.md)** | **[快速改进指南](docs/guides/quick-improvements-and-web-guide.md)**

### 核心架构组件

#### 🤖 智能代理编排引擎
- **任务分配**: 基于意图和能力进行智能代理选择
- **协作协调**: 多代理间的通信和冲突解决
- **进度跟踪**: 实时任务状态监控和报告
- **性能优化**: 代理负载均衡和资源管理

#### 🎯 意图识别与学习系统
- **多层分析**: 关键词加权、上下文感知、模式识别
- **动态学习**: 基于使用历史持续优化识别准确性
- **意图扩展**: 支持自定义意图类型和规则
- **缓存优化**: 智能缓存提升响应速度

#### 🛠️ 本地MCP集成系统
- **自动发现**: 智能检测本地开发工具和环境
- **服务注册**: 动态注册和管理MCP服务器
- **服务调用**: 统一工具服务调用接口
- **质量保证**: 集成测试和错误处理机制

#### ⚡ Token优化与性能监控
- **上下文共享**: 智能上下文池管理，避免重复传输
- **多级缓存**: 文件缓存、内存缓存、分布式缓存
- **压缩算法**: 语义压缩和重复模式消除
- **实时监控**: Token消耗统计和优化建议

#### 🧠 自学习与适应系统
- **数据收集**: 实时收集用户交互、性能指标、系统事件
- **模式学习**: 基于历史数据识别行为模式和趋势
- **A/B测试**: 自动化实验设计和结果分析
- **持续优化**: 基于学习结果的自动系统调整



... (truncated)