把任务说清楚

一个任务至少讲清四件事#

• 目标：希望用户最终能做什么。
• 上下文：项目位置、技术栈、已有实现与相关文件。
• 范围：允许改哪里，哪些数据与功能需要保留。
• 验收：怎样证明改动满足了要求。

可以直接改写的任务模板#

请在当前项目完成以下改动：

目标：给使用文档增加标题与正文搜索。
上下文：沿用现有页面结构、字体、颜色和路由。
范围：只修改文档相关文件，保留其他未提交改动。
验收：
- 中文与英文关键词都能找到相关文章。
- 无结果时给出明确提示。
- 键盘可以打开结果并关闭搜索。
- 桌面和手机宽度没有横向溢出。

先检查相关实现，再完成改动与必要验证。
交付时说明修改内容、验证结果与尚未解决的问题。

纠错时给出可复现线索#

比起“效果不对”，更有帮助的描述是“在 390 像素宽度打开搜索，输入框被右侧按钮挤出屏幕；期望输入框保持在视口内”。代码问题附文件、错误信息与触发步骤；视觉问题说明位置、现状与期望。

需要计划时说清执行边界#

如果目前只想讨论方案，可以明确“先分析与列方案，暂不修改文件”。如果已经决定实施，则直接写出目标和允许范围，让工具持续完成可验证的结果。