Cursor Agent CLI 编码任务执行

技能文档

---
name: cursor-agent-cli
title: Cursor Agent CLI 编码任务执行
category: 开发工具
description: 通过 Cursor Agent CLI 执行编码任务——编写、修改、重构、审查或规划代码，默认只读模式，修改前先展示方案并征得确认。当用户要求用 Cursor 执行编码任务、审查代码变更、做架构规划时触发。触发词：Cursor、编码任务、代码重构、代码审查。
---

# Cursor Agent CLI 编码任务执行

通过 Cursor Agent CLI（`agent` 命令）执行编码任务：编写、修改、重构、审查或规划代码，复用用户的 Cursor 订阅额度，无需额外 API 费用。

## 前置条件

**必需二进制：`agent`**（Cursor Agent CLI）

从官方文档安装：https://cursor.com/docs/cli/overview ，安装后用 `agent --version` 验证。辅助脚本 `scripts/run.sh` 会在找不到 `agent` 时报错退出。

## 用户确认要求（强制）

本技能**不得**被自主调用，每次调用都需要：

1. **先说明意图** —— 告知用户：目标仓库、任务内容、使用的模型、是否会修改文件
2. **等待明确同意** —— 未经用户明确批准不得继续
3. **默认只读** —— 使用 `run.sh <仓库> <任务> <模型> ask`，除非用户明确要求修改
4. **写文件前** —— 先用 `ask` 模式运行，向用户展示方案，再询问「是否应用这些修改？」
5. **使用 `--cloud` 前** —— 明确警告：「这会把仓库内容发送到 cursor.com，是否继续？」
6. **提交前** —— 展示 diff 并获得确认

辅助脚本 `scripts/run.sh` 默认 `ask`（只读）模式；仅在用户确认要应用修改后才传 `write` 模式。

## 技能工作流

1. **确认前置条件** - 检查 `agent` CLI 可用并获得用户明确同意
2. **选择模型与模式** - 按任务类型路由模型，默认只读 `ask` 模式
3. **执行任务** - 通过辅助脚本或无头命令运行
4. **审查与提交** - 展示变更，确认后手动 git 提交

### 步骤1：确认前置条件

用 `agent --version` 验证 CLI 可用；向用户说明仓库、任务、模型及是否改文件，等待同意。

### 步骤2：选择模型与模式

按下方「模型路由」表选择；不确定时用 `auto` 模型 + `ask` 只读模式起步。

### 步骤3：执行任务

```bash
scripts/run.sh <仓库路径> "<任务>" [模型] [ask|plan|write]
```

`write` 模式仅在用户确认计划后使用；`--cloud` 前必须警告数据出境。

### 步骤4：审查与提交

向用户总结关键变更；Cursor 沙箱会拦截 `git commit`，展示 diff 并确认后手动提交。

## 模型路由

| 任务类型 | 模型参数 | 模式参数 |
|---|---|---|
| 简单/探索性任务 | （省略，`auto`） | （省略） |
| 修 Bug / 新功能 / 重构 | `--model sonnet-4.6` | （省略） |
| 代码审查 / 解释（只读） | `--model sonnet-4.6` | `--mode=ask` |
| 架构 / 设计规划 | `--model opus-4.6-thinking` | `--mode=plan` |
| 长时后台任务 | `--model sonnet-4.6` | 用 `--cloud` 代替 `-p` |

## 无头命令

**只读优先** —— 总是先用 `--mode=ask` 审查再应用修改：

```bash
cd <repo> && agent -p "<task>" --model sonnet-4.6 --mode=ask --output-format text --trust
```

**应用修改** —— 仅在用户确认方案后：

```bash
cd <repo> && agent -p "<task>" --model sonnet-4.6 --force --output-format text --trust
```

**云端/后台** —— 先警告用户仓库数据将发送到 cursor.com：

```bash
cd <repo> && agent -c "<task>" --model sonnet-4.6 --trust
# Monitor at: cursor.com/agents
```

## Git 规则

Cursor 沙箱会阻止 `git commit`。Cursor 修改完成后需手动提交：

```bash
cd <repo> && git add -A && git commit -m "<conventional commit message>" && git push
```

改动较大或涉及敏感区域时，先向用户展示 diff 并确认再提交。

## 仓库与工作目录

- 运行前始终先 `cd` 到正确的仓库
- 检查仓库根目录的 `.cursor/rules` 与 `AGENTS.md` —— Cursor 会自动加载它们作为项目上下文

## 上下文与会话

- 提示词中用 `@<file>` 引入指定文件
- `--continue` 或 `--resume` 继续上次会话
- `agent ls` 列出历史会话

## 输出处理

- `--output-format text` → 干净的最终回答，向用户总结关键变更
- `--output-format json` → 结构化输出，适合脚本解析
- 结束后必须汇报：改了什么、提交了什么、发现了什么问题

## 技能工作流

### 步骤1：确认任务与意图

向用户说明：目标仓库、任务内容、拟用模型、是否修改文件，等待用户明确同意。

### 步骤2：选择模式与模型

按「模型路由」表选择模型与模式；默认只读（`ask`）。

### 步骤3：执行任务

通过 `scripts/run.sh <仓库> <任务> <模型> <模式>` 或直接调用 `agent` 命令执行；写模式下先展示方案再应用。

### 步骤4：审查与提交

查看输出与 diff；大改动或敏感改动先请用户确认，然后手动完成 git 提交。

### 步骤5：汇报结果

总结变更内容、提交情况与发现的问题。

## 参考资料

- 模型清单与选型：`references/models.md`
- 交互模式斜杠命令：`references/slash-commands.md`

使用说明

# Cursor Agent CLI 编码任务执行

在 Cursor 订阅下运行 Cursor Agent CLI 执行编写、重构、审查、规划等编码任务，零额外 API 成本，强制用户确认流程。

## 功能

- 按任务类型自动路由模型（编码用 Sonnet、规划用 Opus Thinking 等）
- 默认只读（ask）模式，确认后才应用更改
- 支持云/后台长任务与会话续接
- 附模型清单与交互式斜杠命令参考

## 使用示例

对用户说：

```text
用 Cursor Agent 帮我修复这个仓库的登录 bug
```

技能会确认仓库与任务，先以只读模式给出修改计划，经确认后再应用更改并手动提交。

## 依赖

- 已安装 Cursor Agent CLI（`agent` 命令）并登录 Cursor 账号

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。