AI Agent / 系统课时

提出清晰的开发请求

提出清晰的开发请求

本课把“帮我改一下代码”转化为可执行任务。你将使用目标、范围、约束和验收标准描述开发请求,减少 Claude Code 猜测需求、扩大改动范围或交付不可验证结果的情况。

学习目标

  • 用四个要素组织开发请求
  • 区分必须满足的约束与可选建议
  • 写出能够客观验收的完成标准

请求的四个核心要素

一个清晰请求至少回答四个问题:要得到什么结果、允许改哪里、必须遵守什么限制、怎样判断完成。它们分别对应目标、范围、约束和验收标准。

目标描述最终行为,不要只描述动作。例如“为登录接口增加失败次数限制”比“修改登录代码”更明确。范围指出允许调查和修改的目录、模块或文件;约束说明兼容性、依赖、编码规范和禁止事项;验收标准则要能够通过测试、命令或可观察行为判断。

使用可复用任务模板

下面的模板适合小型功能、缺陷修复和重构任务。方括号内容需要替换为项目事实。

text
目标:
[说明用户可观察到的最终结果]

范围:
- 重点检查:[目录、模块或文件]
- 允许修改:[明确边界]
- 不要修改:[排除项]

约束:
- [语言或运行时版本]
- [不能新增的依赖或必须遵守的规范]
- [兼容性、性能或安全要求]

验收标准:
1. [可执行测试或可观察结果]
2. [边界条件]
3. [需要汇报的改动与风险]

执行方式:
先阅读相关实现并给出简短计划;确认方案后再修改。完成后运行验证命令,并总结改动文件、验证结果和未解决事项。

这是会话输入模板,不是代码或 Shell 命令。模板不要求每次都写得很长,但四类信息不能相互替代。只有目标而没有范围,容易造成过度修改;只有范围而没有验收标准,则无法判断任务是否真正结束。

从模糊请求改成可执行请求

模糊请求通常把实现方案和业务结果混在一起,例如“优化订单代码”。更好的写法会说明实际问题,并给出可验证边界。

text
目标:
修复订单详情页在退款记录为空时出现空白区域的问题。

范围:
- 重点检查前端订单详情组件及其测试
- 只修改订单详情相关文件
- 不调整后端接口和全局样式

约束:
- 保持现有组件 API 不变
- 不新增第三方依赖
- 有退款记录时的现有展示不能变化

验收标准:
1. 退款记录为空时不渲染退款区域
2. 有一条或多条退款记录时正常展示
3. 相关单元测试通过
4. 最后列出修改文件和执行过的测试命令

这段请求把“什么算修好”说清楚,却没有强迫 Claude 使用某个未经验证的实现。除非架构已经确定,否则应优先约束结果和边界,而不是提前规定每一行代码怎样写。

控制任务粒度

一次会话可以处理复杂任务,但单个请求仍应保持一个主要目标。若请求同时包含数据库迁移、接口改造、页面重写和部署,应先让 Claude 梳理依赖并拆成阶段,再逐段执行。这样每一步都有独立验证点,也更容易在发现方向错误时停止。

对于高风险任务,可以要求“先只分析,不修改文件”或使用计划模式。对于小修复,也不要省略验收标准;一句“运行现有测试并报告结果”就能显著提升可交付性。

检查请求是否足够清晰

发送前快速检查:目标是否描述结果,范围是否能定位文件,约束是否来自真实项目,验收标准是否可以观察。如果某个条件暂时未知,可以明确让 Claude 先调查并报告,而不是让它默默假设。

好的请求不是信息越多越好,而是让每一条信息都影响执行决策。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提出清晰的开发请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通