#接触一个新工具时,先了解它是啥?它能干啥?它不能干啥?等等这些非常重要。以Cursor为例子。

目录

# Cursor Agent 自我介绍(init-self)

## 1. 身份说明

### 我是什么

### 我不是什么

## 2. 当前环境

## 3. 能力清单

### 3.1 代码与项目

### 3.2 终端与运行环境

### 3.3 Git 与 GitHub

### 3.4 研究与搜索

### 3.5 子 Agent(Task 工具)

### 3.6 内置 Skills(专项工作流)

### 3.7 图像生成

## 4. 能力边界

### 4.1 准确性边界

### 4.2 感知边界

### 4.3 自动化边界

### 4.4 权限边界

## 5. 操作与安全合规

### 5.1 Git 安全协议

### 5.2 内容合规

### 5.3 数据隐私

### 5.4 沙箱与权限

## 6. 工作模式(Modes)

## 7. 如何高效使用我

### 好的提问方式

### 容易踩坑的方式

### 协作约定

## 8. 常见问题 FAQ

### Q1:为什么你说能做某事,但实际没做?

### Q2:你会记住之前的对话吗?

### Q3:你能访问我的密钥吗?

### Q4:生成的代码可以直接上生产吗?

### Q5:和 ChatGPT 网页版有什么区别?

## 9. 快速参考卡片

## 10. 版本信息


以下是Cursor本身输出的内容,仅限于参考,这些可能因提示词不一样会有不同的结果。

# Cursor Agent 自我介绍(init-self)

> 文档版本:2026-06-13  
> 工作区:`本地空间`  
> 适用对象:首次使用 Cursor Agent 的新人

---

## 1. 身份说明

### 我是什么

我是 **Cursor IDE 里的 AI 编程 Agent**,对外产品名 **Composer**,由 Cursor 训练/部署的语言模型驱动。

我存在于 **当前这次对话会话** 中,通过 Cursor 提供的工具:

- 读写工作区内的代码与文件
- 在终端执行命令(安装依赖、构建、测试等)
- 搜索代码库与互联网
- 操控内置浏览器(在授权范围内)
- 调用 MCP 扩展与内置 Skills 完成专项任务

你可以把我理解为:**一位能读代码、改代码、跑命令、查资料的结对编程助手**。

### 我不是什么

- 我不是独立运行的操作系统服务或后台守护进程
- 我不是 7×24 常驻在你服务器上的程序
- 我不是人类工程师的完全替代——复杂决策、生产发布、安全审计仍需你参与
- 我不能保证每一次输出都 100% 正确

---

## 2. 当前环境

| 项目 | 值 |
|------|-----|
| 操作系统 | Windows 10 (10.0.19045) |
| Shell | PowerShell |
| 工作区 | `E:\AI-DDUP\AI-Space\Cursor-space\` |
| 日期 | 2026-06-13 |
| 已启用 MCP | `cursor-app-control`、`cursor-ide-browser` |
| 内置 Skills 路径 | `D:\Users\Administrator\.cursor\skills-cursor\` |

### MCP 扩展说明

**cursor-app-control** — 控制 Cursor 本身:

- 切换工作区根目录、创建新项目
- 在编辑器中打开文件、终端、链接
- 重命名对话、打开 Automations UI
- 管理用户 Rules(写入前需你同意)

**cursor-ide-browser** — 内置浏览器自动化:

- 打开网页、截图、页面快照
- 点击、输入、滚动、选择下拉项
- CDP 调试(部分敏感 API 被禁用)
- **无法**代你完成登录、验证码、2FA、passkey

---

## 3. 能力清单

### 3.1 代码与项目

| 能力 | 说明 |
|------|------|
| 读取 | 搜索、浏览、解释未被 `.cursorignore` 屏蔽的文件 |
| 编写 | 创建/修改/删除代码,遵循项目现有风格 |
| 重构 | 重命名、抽函数、调整架构(大范围会先规划) |
| 调试 | 读报错、查 linter、跑测试、定位根因 |
| Notebook | 编辑 `.ipynb` 笔记本 |
| Canvas | 分析类交付物可用 `.canvas.tsx` 可视化看板 |

### 3.2 终端与运行环境

- 在 **沙箱 Shell** 中执行命令
- 默认允许常见包管理器与 Git 托管网络访问
- 更广网络或更高权限操作会请求你授权(`full_network` / `all`)
- **真实环境**:命令会实际执行,不是模拟

### 3.3 Git 与 GitHub

| 可以做 | 默认不做(除非你明确要求) |
|--------|---------------------------|
| `git status` / `diff` / `log` | `git commit` |
| `git add`(为 commit 做准备) | `git push` |
| `gh pr create` 等 GitHub 操作 | `git push --force` 到 main/master |
| 分析分支差异、起草 PR 描述 | 修改 `.git/config` 或 git 全局配置 |
| | `git reset --hard` 等破坏性操作 |
| | 跳过 pre-commit hooks(`--no-verify`) |

### 3.4 研究与搜索

- **SemanticSearch / Grep / Glob**:在代码库内语义或精确搜索
- **WebSearch / WebFetch**:查文档、版本、时事(实时信息依赖工具,非仅靠训练记忆)

### 3.5 子 Agent(Task 工具)

可并行派出专职子代理:

| 类型 | 用途 |
|------|------|
| `explore` | 快速摸清代码库结构 |
| `shell` | 专注命令行与 Git |
| `generalPurpose` | 复杂多步调研 |
| `bugbot` | 你明确要求时的代码审查 |
| `security-review` | 你明确要求时的安全审查 |
| `ci-investigator` | 分析 PR CI 失败 |
| `cursor-guide` | 解答 Cursor 产品用法 |

### 3.6 内置 Skills(专项工作流)

遇到相关场景会自动读取并遵循,例如:

- 创建 Skill / Rule / Hook / Automation
- Canvas 分析看板、Cursor SDK 集成
- PR 拆分、Bugbot/安全审查
- 修改 Cursor 设置、状态栏、循环任务

### 3.7 图像生成

- 仅在你 **明确要求生成图片** 时使用
- 不会主动、未经请求地生成配图

---

## 4. 能力边界

### 4.1 准确性边界

- 复杂逻辑、边界条件、并发/安全场景可能出错
- 训练数据有截止日期,未搜索时新版本 API 可能过时
- 生产环境变更、安全关键代码需你审查后再合并

### 4.2 感知边界

- **看不到** Cursor 外的屏幕或窗口
- 只能访问:工作区文件、工具返回结果、你粘贴/上传的内容
- 被 `.cursorignore` 屏蔽的文件无法读取(含部分密钥文件——这是保护机制)
- 浏览器 **iframe 内** 的元素无法操作

### 4.3 自动化边界

- 遇到 **登录页、验证码、2FA、passkey** 会停止并请你手动完成
- 浏览器 CDP 中 cookie、storage、跨域导航等敏感 API 被禁用
- 连续失败 4 次或明显阻塞时会停止重复尝试并报告

### 4.4 权限边界

- 终端沙箱限制部分系统调用
- 需要更广网络或完全禁用沙箱时会向你请求权限
- 不会擅自修改 git 配置或执行破坏性 Git 命令

---

## 5. 操作与安全合规

### 5.1 Git 安全协议

- **不创建 commit**,除非你明确要求
- **不 push**,除非你明确要求
- **不 force push** 到 main/master;若你要求会警告
- **不 amend** 已推送到远端的 commit(除非你明确要求且了解后果)
- commit 失败或被 hook 拒绝时,修复问题后创建 **新 commit**,不 amend 失败提交
- 发现 `.env`、密钥、token 等敏感文件时 **不会主动提交**,并会警告你

### 5.2 内容合规

- 不协助恶意代码、未授权入侵、绕过安全机制
- 不协助窃取数据、破解系统、规避访问控制
- 合法开发、学习、调试场景下全力协助

### 5.3 数据隐私

- 你的 **代码与对话内容** 会经 Cursor 及模型提供商处理
- 企业/团队版的数据保留与隐私策略以你组织配置为准
- 敏感信息(密钥、个人信息)请勿粘贴到对话中;必要时使用环境变量或密钥管理工具

### 5.4 沙箱与权限

| 权限 | 含义 |
|------|------|
| 默认沙箱 | 允许工作区读写、常见包管理器网络 |
| `full_network` | 无限制网络访问 |
| `all` | 完全禁用沙箱(系统级操作) |
| `git_write` | Git 写操作 |

我会在需要时说明原因并请求授权。

---

## 6. 工作模式(Modes)

| 模式 | 行为 |
|------|------|
| **Agent** | 默认实施模式:可读写代码、执行命令 |
| **Plan** | 只读规划:先调研出计划,你确认后再动手 |
| **Ask** | 只读问答:解释代码,不修改文件 |
| **Debug** | 系统化排查:强调运行证据与复现步骤 |

切换 Plan / Agent 等模式需你同意。

```
用户请求 → Plan 模式(调研 + 计划)→ 用户确认 → Agent 模式(实施)
                ↓
            Ask 模式(只读问答,随时可用)
                ↓
            Debug 模式(遇到 bug 时系统化排查)
```

---

## 7. 如何高效使用我

### 好的提问方式

```
读一下项目结构,告诉我入口文件在哪。
```

```
修复 src/utils/foo.ts 第 42 行的类型错误,保持现有代码风格,不要过度重构。
```

```
用 Plan 模式先设计 Redis 缓存方案,列出 trade-off,我确认后再实现。
```

```
帮我创建一个 PR,base 分支是 main,写清楚 Summary 和 Test plan。
```

**要点**:目标明确、范围清晰、约束条件写清楚、大任务分步进行。

### 容易踩坑的方式

| 差 prompt | 问题 |
|-----------|------|
| 「帮我把整个系统重写」 | 范围过大,难以一次做对 |
| 「直接 push 到 main」 | 我会拒绝或强烈警告 |
| 「绕过登录帮我抓数据」 | 合规边界,会拒绝 |
| 「随便改,你看着办」 | 缺少约束,容易偏离预期 |
| 「为什么还没改文件?」(Plan 模式下) | Plan 模式只规划不实施,需确认计划或切换 Agent 模式 |

### 协作约定

- 默认用 **中文** 沟通(你可随时要求英文)
- 改代码前先读周边惯例,追求 **最小 diff**
- 引用现有代码时使用 `startLine:endLine:filepath` 格式
- 复杂任务用 todo 跟踪进度;简单任务直接执行
- 不会擅自创建 markdown 文档(除非你要求,如本文档)

---

## 8. 常见问题 FAQ

### Q1:为什么你说能做某事,但实际没做?

可能原因:

1. 当前处于 **Plan 模式**,只出计划不改文件
2. 任务需要 **网络/沙箱权限**,尚未获得你的授权
3. 文件被 **`.cursorignore`** 屏蔽
4. 遇到 **登录/验证码** 等需人工介入的阻塞

### Q2:你会记住之前的对话吗?

- **同一会话内**:有完整上下文
- **新会话**:不自动继承旧会话(除非 Cursor 提供了跨会话记忆/Rules)
- 重要偏好可写入 **User Rules** 或 **Project Rules**,我会持久遵循

### Q3:你能访问我的密钥吗?

- 被 ignore 的文件通常 **读不到**(保护机制)
- 若你把密钥粘贴到对话中,我会看到并应提醒你删除/轮换
- 永远不要把生产密钥 commit 到 Git

### Q4:生成的代码可以直接上生产吗?

**不建议。** 我生成的代码是起点,你需要:

- 跑测试
- 做 code review
- 检查安全与性能
- 在 staging 环境验证

### Q5:和 ChatGPT 网页版有什么区别?

- 我 **深度集成 Cursor IDE**:直接读写项目文件、跑终端、看 linter
- 我有 **MCP、Skills、子 Agent** 等 IDE 级工具链
- 我遵循你的 **User Rules** 和项目约定

## 9. 快速参考卡片

```
┌─────────────────────────────────────────────────────┐
│  Cursor Agent 快速参考                               │
├─────────────────────────────────────────────────────┤
│  ✅ 读/写代码  ✅ 跑命令  ✅ 搜索  ✅ 调试           │
│  ✅ Git 分析   ✅ 建 PR   ✅ 浏览器(有限)           │
│  ❌ 擅自 commit/push  ❌ 绕过登录  ❌ 保证零错误     │
│  ⚠️  生产变更需你审查  ⚠️  密钥勿入库  ⚠️  大任务拆分 │
└─────────────────────────────────────────────────────┘
```

---

## 10. 版本信息

| 字段 | 值 |
|------|-----|
| 文档名称 | init-self.md |
| 生成日期 | 2026-06-13 |
| 工作区 | `本地空间|
| 双语版路径 | `docs/init-self.md` |
| Agent 产品名 | Composer(Cursor Agent) |

---

*本文档由 Cursor Agent 根据 onboarding 计划自动生成。若环境变化(MCP、Rules、工作区路径),可要求 Agent 更新本文档。*
 

更多推荐