[收藏]【侄女零基础升级打怪】Vibe Coding氛围编程 AI编程之Cursor Agent 自我介绍
#接触一个新工具时,先了解它是啥?它能干啥?它不能干啥?等等这些非常重要。以Cursor为例子。
目录
# Cursor Agent 自我介绍(init-self)

以下是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 更新本文档。*
更多推荐


所有评论(0)