在 Cursor 里完成一次可审阅的小步改动

# 在 Cursor 里完成一次可审阅的小步改动

计划、实现、差异和验证围绕同一个目标。

资料核实：2026-10-20

## 学习目标

交付一个范围清楚、有实际检查结果的小改动。

## 图示：一个小改动的闭环

1. **一个小目标**：只处理一项可观察变化，写清布局、接口等保留行为。
2. **Plan Mode**：需要探索时先研究代码，提出最小方案和涉及文件。
3. **审阅计划**：核对复用点与验证入口，无关改进单独列出不纳入本次。
4. **差异与检查**：最终差异只含必要文件，用实际测试对照最初目标。

计划、差异和检查都围绕同一个用户可观察的变化。

## 适用场景

想给输入框增加空值提示，却担心 AI 顺手重构组件、改接口或覆盖已有行为。

## 准备条件

- 可运行的项目，能够找到现有测试或检查入口。
- 知道这次修改成功后用户会看到什么变化。

## 操作步骤

### 1. 先写清一个小目标

只处理一项用户可观察的变化。明确保留的行为，避免把视觉重设计、接口改动和输入校验混在同一次任务里。

**任务描述示例**

```text
只给昵称输入增加空值提示。
保留现有布局、接口和保存成功行为。
不要重构无关组件。
完成后验证空值、合法值与请求失败时输入保留。
```

### 2. 需要探索时切换 Plan Mode

在 Agent 输入框按 Shift\+Tab 切到 Plan Mode，让它先研究代码和提出方案。范围已清晰的低风险修改也可以直接请求实现。

### 3. 审阅计划后逐步构建

检查涉及文件、现有复用点和验证方法。计划满足本轮目标后再构建；发现新问题时先记录，不把每项发现都扩展成本次改动。

**检查计划提示词**

```text
请说明每个计划修改的文件与本目标的关系。
优先复用现有校验方式，并给出实际可运行的验证入口。
将无关的改进建议单独列出，不纳入本次实现。
```

### 4. 查看差异并核对执行结果

使用 Cursor 的改动差异检查实现范围，再让它执行项目已有检查。代码写完、计划勾完和用户流程通过是不同的证据。

**结束前核对**

```text
对照最初三项验收逐条给出实际结果。
说明执行过的检查、失败与未运行项，以及最终改动文件。
如果结果不符合预期，先定位原因再修改。
```

## 常见误区

### 计划被勾完就认为功能完成

要求实际测试或页面操作结果，并对照原始目标。

### 每次发现问题都顺手一起改

保持本次目标单一；新问题独立记录后再排优先级。

## 验收清单

- 最终差异只涉及本目标需要的文件。
- 空值、合法值和失败保留都得到实际验证。
- 报告清楚区分已通过、失败和未运行。

## 资料与版本

本文为原创整理，示例需按项目调整；工具界面与功能以当前版本为准。

- [Cursor：Quickstart](https://cursor.com/docs/get-started/quickstart)