AI-NEWS

Appearance

Cursor 配置 ​

🎯 学习目标

  • 配置 .cursor/rules/ 让 Agent 遵守项目约定
  • 编写与挂载 Skills（SKILL.md）
  • 连接 MCP Server，理解 Agent / Subagent 分工

引言 ​

Cursor 是当前集成度最高的 AI IDE 之一。配置核心在 .cursor/ 目录：Rules 约束行为，Skills 封装流程，MCP 扩展工具，Subagent 并行探索或专项任务。

章节正文 ​

第 1 步：Rules（项目规则） ​

路径：.cursor/rules/，每条规则一个 .md 或 .mdc 文件。

text
.cursor/rules/
├── general.mdc          # 全局：语言、commit 风格、最小 diff
├── frontend.mdc           # glob: **/*.{tsx,vue}
└── api.mdc                # glob: **/api/**

示例 general.mdc 要点：

  • 用中文写用户可见文案，代码注释保持英文或中文统一
  • 不提交 .env、密钥、generated dist
  • 改代码前先读周边文件，最小范围 diff

在 Cursor 设置中可切换 Always Apply / Apply Intelligently / Apply to Specific Files，与 frontmatter 中的 globs 配合。

第 2 步：Skills（技能包） ​

路径（项目级）：.cursor/skills/<skill-name>/SKILL.md

text
.cursor/skills/
└── deploy-check/
    └── SKILL.md

SKILL.md 结构建议：

markdown
---
name: deploy-check
description: 发布前检查 changelog、版本号与 CI 配置
---

# deploy-check

1. 读取 package.json 与 CHANGELOG
2. 确认 GitHub Actions workflow 无硬编码 secret
3. 输出检查清单，不自动 push

Agent 会根据 description 自动选用 Skill；复杂流程拆成多个小 Skill 优于一个大杂烩。

用户级 Skills 也可放在 ~/.cursor/skills-cursor/（个人通用，不进仓库）。

第 3 步：MCP ​

配置文件：.cursor/mcp.json（或 Cursor Settings → MCP）

json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GITHUB_TOKEN}"
      }
    }
  }
}

原则：一个 Server 一类能力；Token 用环境变量；仓库内只提交 不含密钥 的配置模板。

第 4 步：Multi-Agent / Subagent ​

Cursor 支持：

  • Agent 模式：自主规划、改多文件、跑终端
  • Subagent（Task 工具）：父 Agent 派发子任务（如 explore、shell、review）

团队实践：

  1. 在 Rule 里写清「何时用 Subagent 探索、何时本 Agent 直接改」
  2. 大重构：先 explore 子 agent 出报告，再实现 agent 改代码
  3. 限制并行子 agent 数量，避免上下文爆炸

可选：在仓库根增加 AGENTS.md，描述 explore / implement / review 三类子 agent 的职责，与 Cursor Rule 互相引用。

第 5 步：推荐工作流 ​

  1. 新仓库：先加 general.mdc + CLAUDE.md（可选，便于跨工具）
  2. 重复第三次以上的任务 → 抽成 Skill
  3. 需 Jira / DB / 浏览器 → 接 MCP
  4. 大需求 → Agent + Subagent 分阶段

小结 ​

  • Cursor 配置锚点：.cursor/rules/ + .cursor/skills/ + mcp.json
  • Rule 管约束，Skill 管流程，MCP 管外部系统，Subagent 管分工