#接触一个新工具时，先了解它是啥?它能干啥？它不能干啥？等等这些非常重要。以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 更新本文档。*
