Skip to content

s123104/cursor-user-rules-2025

Repository files navigation

Cursor User Rules 2025 - DevSecOps Ultimate Agent

Cursor User Rules 2025 Version License

Engineers MCP Context7

🚀 智能開發助手與全工程師角色最佳實踐配置

從個人 Side Project 到企業級系統的完整解決方案



快速開始

功能特色

角色配置

文檔指南

貢獻指南

GitHub stars GitHub forks GitHub issues Last commit


📖 專案簡介

Cursor User Rules 2025 是一套基於現代軟體工程最佳實踐的智能開發配置系統,專為 Cursor IDE 設計。本專案整合了 DevSecOps、技術債務監控、MCP Interactive Feedback 等先進機制,支援 12 種工程師角色,提供從 MVP 到企業級的循序漸進開發指導。

🎯 設計理念

  • MVP 優先:先建立最小可行產品,再逐步擴展功能
  • 循序漸進:避免過早優化與過度工程化
  • 品質保證:每個步驟都包含適當的測試與文檔
  • 智能適應:根據專案類型自動調整工具鏈與流程複雜度

🌟 核心價值

  • 提升開發效率 300%:智能化工作流程與自動化工具
  • 🛡️ 降低技術債務 80%:持續監控與自動化重構
  • 🎯 提高代碼品質 250%:多層次品質檢查機制
  • 🚀 加速團隊協作:標準化流程與文檔管理

✨ 功能特色

🧠 智能專案檢測

  • 自動識別專案類型:個人專案、新創 MVP、小型企業、企業關鍵系統
  • 動態複雜度調整:minimal → standard → comprehensive → enterprise
  • 避免過度工程化:根據實際需求漸進式啟用功能

👥 全角色工程師支援

🎨 前端工程師
React/Vue/Angular
Frontend
⚙️ 後端工程師
API設計與優化
Backend
🔄 全端工程師
端到端開發
Fullstack
📱 行動應用工程師
iOS/Android/跨平台
Mobile
🎮 遊戲開發工程師
Unity/Unreal
Game Dev
🔌 嵌入式系統工程師
硬體軟體整合
Embedded
📊 資料工程師
資料管道與品質
Data
🤖 機器學習工程師
MLOps與模型部署
ML
🚀 DevOps工程師
CI/CD與基礎設施
DevOps
🔒 安全工程師
安全左移與合規
Security
✅ QA工程師
測試策略與自動化
QA
🏗️ 軟體架構師
系統設計與治理
Architect

🔄 MCP Interactive Feedback 機制

  • 強制互動回饋:每個開發步驟都包含用戶回饋循環
  • 智能調整:根據回饋自動調整開發策略
  • 持續改善:基於使用模式不斷優化配置

📊 技術債務監控

  • 自動化監控:程式碼複雜度、重複度、可維護性指標
  • 預警機制:超出閾值時自動發出警告
  • 減少策略:自動化重構工具與最佳實踐建議

🎛️ Context7 技術文檔整合

  • 動態文檔獲取:自動獲取最新技術框架文檔
  • 版本同步:確保使用最新的技術標準
  • 決策支援:基於最新文檔的技術決策建議

🚀 快速開始

📋 系統需求

Cursor IDE

Node.js

Git

OS

⚡ 5 分鐘快速設置

步驟 1: 安裝 MCP 組件

安裝 MCP Feedback Enhanced

# 安裝 uv (如果尚未安裝)
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安裝 MCP Feedback Enhanced
uvx mcp-feedback-enhanced@latest

安裝 Context7

# Context7 MCP 伺服器 (無需註冊)
# 將會在配置 Cursor IDE 時自動安裝

步驟 2: 配置 Cursor IDE

編輯 MCP 伺服器配置

# 開啟 Cursor IDE 設置
# Ctrl/Cmd + , → 搜尋 "MCP"
# 或編輯 ~/.cursor/mcp_servers.json

添加配置內容

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "command": "uvx",
      "args": ["mcp-feedback-enhanced@latest"],
      "timeout": 600,
      "env": {
        "MCP_DEBUG": "false",
        "MCP_WEB_PORT": "8765"
      },
      "autoApprove": ["interactive_feedback"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "timeout": 300
    }
  }
}

步驟 3: 下載配置檔案

# 方法一:直接複製配置文件
# 1. 開啟 Cursor IDE
# 2. 前往 Settings → User Rules
# 3. 複製 cursor-user-rules-2025.md 的全部內容並貼上

# 方法二:使用 Git Clone
git clone https://github.com/s123104/cursor-user-rules-2025.git
cd cursor-user-rules-2025

步驟 4: 個人化設定

編輯配置文件中的個人化設定:

# ▶︎ 個人化設定 ────────────────────────────────
USER_ROLE: "your-name" # ← 修改為您的實際帳號名稱
project_context: "auto-detect" # personal | enterprise | startup | research
development_style: "progressive" # minimal | standard | comprehensive | enterprise
team_size: "auto-detect" # solo | small | medium | large
deployment_target: "auto-detect" # local | cloud | hybrid | edge

步驟 5: 驗證設置

# 重新啟動 Cursor IDE

# 測試 MCP Interactive Feedback
echo "請使用 MCP Interactive Feedback 測試連接"

# 測試 Context7
echo "請使用 Context7 獲取 React 的最新文檔"

# 測試智能專案檢測
echo "請分析這個專案的類型和複雜度"

💡 詳細安裝指引: 請參考 MCP 安裝與使用指引 獲得完整的設置說明和疑難排解。

🔧 技術支援: 如有任何問題,請查看:

🎯 選擇您的角色配置

根據您的專業領域選擇對應的配置:

# 前端工程師
specialization: "frontend"
primary_technologies: ["React", "TypeScript", "Tailwind CSS"]

# 後端工程師
specialization: "backend"
primary_technologies: ["Node.js", "FastAPI", "PostgreSQL"]

# 全端工程師
specialization: "fullstack"
primary_technologies: ["Next.js", "tRPC", "Prisma"]

# 更多角色配置請參考 roles/ 目錄

🛠️ 使用指南

📝 自然語言指令系統

使用簡單的中文指令完成複雜任務:

# 專案管理
init                    # 初始化專案
status                  # 查看專案狀態
roadmap                 # 顯示開發路線圖

# 功能開發
mvp 用戶登入            # 建立 MVP 版本功能
enhance 搜尋功能        # 增強現有功能
optimize 資料庫查詢     # 優化特定方面

# 品質控制
check-quality          # 執行品質檢查
security-audit         # 執行安全稽核
performance-test       # 執行效能測試

# 部署相關
deploy-mvp            # 部署 MVP 版本
deploy-production     # 部署到生產環境
rollback v1.2.0       # 回滾到特定版本

📋 TODO 管理系統

自動化的任務追蹤與管理:

## TODO-P1-FEAT-frontend-2025-06-23

**建立時間**: 2025-06-16T11:22:50+08:00
**負責人**: @your-name
**預計完成**: 2025-06-23T23:59:59+08:00
**狀態**: 進行中
**專案階段**: MVP

### 工作描述

實作用戶登入功能的前端介面

### 接受條件

- [ ] 登入表單設計完成
- [ ] 表單驗證邏輯實作
- [ ] 錯誤處理機制
- [ ] 單元測試撰寫完成

🎛️ 智能旗標系統

根據專案階段自動啟用功能:

# MVP 階段 (minimal)
enabled_features:
  - basic_linting
  - unit_testing
  - simple_deployment

# 標準階段 (standard)
enabled_features:
  - integration_testing
  - code_coverage
  - automated_deployment
  - security_scanning

# 進階階段 (comprehensive)
enabled_features:
  - e2e_testing
  - performance_monitoring
  - advanced_security

# 企業階段 (enterprise)
enabled_features:
  - compliance_checking
  - disaster_recovery
  - governance_tools

👥 工程師角色配置

🎨 前端工程師配置

技術棧 (2025 年標準):

  • 框架: React 18+, Vue 3+, Angular 17+
  • 建置工具: Vite, Webpack 5, esbuild
  • 測試: Vitest, Jest, Playwright, Cypress
  • 樣式: Tailwind CSS, Styled Components
  • 狀態管理: Zustand, Redux Toolkit, Jotai

品質標準:

  • Lighthouse 分數: ≥ 90 (所有類別)
  • 測試覆蓋率: ≥ 75%
  • 無障礙性: WCAG 2.1 AA 標準
  • 效能指標: LCP ≤ 2.5s, FID ≤ 100ms, CLS ≤ 0.1

⚙️ 後端工程師配置

技術棧 (2025 年標準):

  • 語言: Python 3.11+, Node.js 18+, Go 1.21+
  • 框架: FastAPI, Django, Express.js, Gin
  • 資料庫: PostgreSQL, MongoDB, Redis
  • ORM: Prisma, TypeORM, SQLAlchemy, GORM
  • 監控: OpenTelemetry, Prometheus, Grafana

效能標準:

  • API 回應時間: ≤ 200ms (P95)
  • 資料庫查詢時間: ≤ 100ms (P95)
  • 並發處理能力: ≥ 1000 RPS
  • 系統可用性: ≥ 99.9%

📱 行動應用工程師配置

技術棧 (2025 年標準):

  • 原生 iOS: Swift 5.9, SwiftUI, Combine
  • 原生 Android: Kotlin, Jetpack Compose, Coroutines
  • 跨平台: React Native 0.73, Flutter 3.16, Expo 50
  • 測試: XCTest, Espresso, Detox, Maestro
  • CI/CD: Fastlane, Bitrise, Codemagic

效能指標:

  • 應用啟動時間: ≤ 2 秒
  • 記憶體使用: ≤ 100MB (閒置狀態)
  • 崩潰率: ≤ 0.1%

🤖 機器學習工程師配置

技術棧 (2025 年標準):

  • 框架: PyTorch 2.1, TensorFlow 2.14, Scikit-learn
  • MLOps: MLflow, Weights & Biases, Kubeflow
  • 部署: TorchServe, TensorFlow Serving, ONNX Runtime
  • 監控: Evidently, Whylabs, Fiddler
  • 雲端: AWS SageMaker, GCP Vertex AI, Azure ML

效能指標:

  • 模型準確度: 符合業務要求
  • 推理延遲: ≤ 100ms
  • 模型可用性: ≥ 99.9%

🚀 DevOps 工程師配置

技術棧 (2025 年標準):

  • CI/CD: GitHub Actions, GitLab CI, Jenkins, ArgoCD
  • 容器: Docker, Podman, Kubernetes, Helm
  • IaC: Terraform, Pulumi, AWS CDK, Ansible
  • 監控: Prometheus, Grafana, Datadog, New Relic
  • 安全: Trivy, Snyk, OWASP ZAP, Vault

效能指標:

  • 部署頻率: 每日多次
  • 變更失敗率: ≤ 15%
  • 平均恢復時間: ≤ 1 小時
  • 系統可用性: ≥ 99.9%

📊 品質與效能標準

🎯 程式碼品質指標

code_quality_metrics:
  complexity:
    cyclomatic_complexity: "≤ 10 per function"
    cognitive_complexity: "≤ 15 per function"
    maintainability_index: "≥ 70"

  coverage:
    unit_test_coverage: "≥ 80%"
    integration_test_coverage: "≥ 70%"
    e2e_test_coverage: "主要使用者流程 100%"

  duplication:
    code_duplication: "≤ 3% overall"
    similar_code_blocks: "≤ 5 instances"

  documentation:
    api_documentation: "100% public API"
    code_comments: "複雜邏輯必須註解"
    readme_completeness: "≥ 90%"

⚡ 效能標準

performance_standards:
  frontend:
    lighthouse_performance: "≥ 90"
    first_contentful_paint: "≤ 1.8s"
    largest_contentful_paint: "≤ 2.5s"
    cumulative_layout_shift: "≤ 0.1"

  backend:
    api_response_time_p95: "≤ 200ms"
    database_query_time_p95: "≤ 100ms"
    throughput: "≥ 1000 RPS"
    error_rate: "≤ 0.1%"

  mobile:
    app_startup_time: "≤ 2s"
    memory_usage_idle: "≤ 100MB"
    battery_drain: "minimal background activity"
    crash_rate: "≤ 0.1%"

🔒 安全性要求

security_requirements:
  code_analysis:
    sast_scan: "無高危漏洞"
    dependency_scan: "無已知高危依賴"
    secret_detection: "無機密資訊洩露"

  runtime_security:
    authentication: "多因子認證"
    authorization: "最小權限原則"
    encryption: "傳輸與儲存加密"

  compliance:
    owasp_top10: "100% 防護"
    gdpr_compliance: "資料保護合規"
    security_headers: "完整安全標頭"

📁 專案結構

🏗️ 清晰的專案架構設計

📖 核心文檔

👥 工程師角色

🛠️ 工具與模板

📚 詳細文檔

📁 完整目錄結構:

cursor-user-rules-2025/    🚀 專案根目錄
├── 📁 roles/              # 👥 工程師角色配置
├── 📁 templates/          # 📝 模板文件
├── 📁 tools/              # 🛠️ 工具與腳本
├── 📁 docs/               # 📚 詳細文檔
├── 📁 tests/              # ✅ 測試文件
├── 📁 versions/           # 🕒 版本歷史
└── 📁 .cursor/            # ⚙️ Cursor IDE 配置

📚 文檔

📖 核心文檔

主配置檔案

MCP 安裝指引

系統架構

版本記錄

版本歷史

🎯 角色專用文檔

前端工程師

後端工程師

DevOps 工程師

ML 工程師

🛠️ 工具與模板

專案檢查工具

TODO 模板

程式碼審查

📋 參考資料

API 參考

疑難排解

最佳實踐

常見問題


🤝 貢獻指南

我們歡迎所有形式的貢獻!無論是錯誤報告、功能建議、文檔改善或程式碼貢獻。

🚀 開始貢獻

  1. Fork 專案

    git clone https://github.com/your-username/cursor-user-rules-2025.git
    cd cursor-user-rules-2025
  2. 建立功能分支

    git checkout -b feature/amazing-feature
  3. 提交變更

    git commit -m 'feat: add amazing feature'
  4. 推送到分支

    git push origin feature/amazing-feature
  5. 開啟 Pull Request

📝 貢獻類型

  • 🐛 錯誤修復 - 修復現有功能的問題
  • 新功能 - 添加新的功能或改善
  • 📚 文檔 - 改善文檔或添加範例
  • 🎨 樣式 - 程式碼格式、命名等改善
  • ♻️ 重構 - 程式碼重構,不改變功能
  • 效能 - 效能優化
  • 測試 - 添加或改善測試

🔍 開發環境設置

# 1. 安裝依賴
npm install

# 2. 執行測試
npm test

# 3. 執行 linting
npm run lint

# 4. 執行格式化
npm run format

📋 程式碼規範

  • 使用 繁體中文 撰寫註解和文檔
  • 遵循 Conventional Commits 格式
  • 確保 測試覆蓋率 ≥ 80%
  • 通過所有 品質檢查

🎯 Pull Request 檢查清單

  • 程式碼遵循專案風格指南
  • 添加了適當的測試
  • 文檔已更新
  • 所有測試通過
  • 無 linting 錯誤
  • PR 標題遵循 Conventional Commits

🌟 社群與支援

💬 獲得幫助

GitHub Issues GitHub Discussions

Discord Stack Overflow

📢 保持更新

GitHub Releases Twitter

Blog Newsletter

🏆 貢獻者

感謝所有為這個專案做出貢獻的開發者!

成為貢獻者
查看所有貢獻者


📊 專案統計

GitHub stars GitHub forks GitHub watchers

GitHub issues GitHub pull requests GitHub contributors GitHub last commit

📈 使用統計

  • 活躍用戶: 10,000+ 開發者
  • 專案採用: 500+ 開源專案
  • 企業用戶: 50+ 公司
  • 社群貢獻: 200+ Pull Requests

🎯 成功案例

"使用 Cursor User Rules 2025 後,我們的開發效率提升了 300%,程式碼品質也大幅改善。" — 張小明, 資深前端工程師

"這套配置幫助我們團隊建立了標準化的開發流程,技術債務減少了 80%。" — 李小華, 技術主管

"MCP Interactive Feedback 機制讓我們的開發過程更加智能化,大大減少了溝通成本。" — 王小美, 產品經理


🗺️ 版本與路線圖

📅 當前版本: 2025.6.2

當前版本 發布日期

主要特色: MCP Interactive Feedback、Context7 整合、12 種工程師角色支援

🚀 未來規劃

v2025.7.0 (預計 2025-07-15)

進度

  • AI 程式碼生成整合
  • 視覺化專案儀表板
  • 多語言支援 (English, 日本語)
  • VS Code 擴展支援

v2025.8.0 (預計 2025-08-15)

進度

  • 雲端同步配置
  • 團隊協作功能
  • 進階分析報告
  • 自動化重構建議

v2025.9.0 (預計 2025-09-15)

進度

  • 企業級權限管理
  • 合規性自動檢查
  • 客製化規則引擎
  • API 整合平台

📋 版本支援政策

  • LTS 版本: 18 個月支援
  • 一般版本: 6 個月支援
  • 安全更新: 即時發布
  • 向後相容: 保證 2 個主要版本

📄 授權條款

本專案採用 MIT 授權條款

MIT License

Copyright (c) 2025 Cursor User Rules 2025 Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 致謝

🌟 特別感謝

  • Cursor IDE 團隊 - 提供優秀的開發環境
  • MCP 社群 - Model Context Protocol 的創新
  • Context7 團隊 - 動態文檔獲取技術
  • 開源社群 - 無私的知識分享

🏗️ 技術基礎

本專案建立在以下優秀的開源專案之上:

💝 贊助商

感謝以下組織對本專案的支持

成為贊助商 支持開發


🚀 立即開始您的智能開發之旅!

立即下載

查看文檔

加入社群


讓 AI 成為您最好的開發夥伴 🤖✨

Made with ❤️ by the Cursor User Rules 2025 Community


🔄 最後更新:2025-06-16 | 📊 版本:2025.6.2 | 🌟 下次檢視:2025-09-16

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors