上下文与项目规则
将稳定规则、任务信息和运行证据分层组织,减少 Agent 在长任务中的遗漏与误判。
Agent 的判断依赖它能够看到的信息。对话变长后,重复粘贴材料可能增加噪声,而关键约束仍然容易被淹没。更有效的做法,是按信息的稳定程度组织上下文,并让每条结论保留可以复查的来源。
把信息分成三层
| 层次 | 保存什么 | 什么时候更新 |
|---|---|---|
| 项目规则 | 目录职责、构建方式、代码约定、明确的操作边界 | 项目约定发生变化时 |
| 任务状态 | 本次目标、范围、已作决策、下一步与未决问题 | 阶段结束或方向改变时 |
| 运行证据 | 错误日志、测试结果、请求样本、截图与产物 | 每次进行验证时 |
项目规则应随着项目变化及时维护;任务状态在方向改变或阶段结束时更新;运行证据则记录采集时间与对应代码状态。旧日志可以帮助定位问题,但不能直接证明当前实现仍有同样表现。
规则要具体且能执行
“保持代码整洁”很难指导下一步行动。“只格式化本次修改的文件”“新增接口沿用现有错误结构”更容易执行。规则应说明适用范围,避免把某次临时处理变成全仓库的长期限制。
规则文件的名称、加载范围和优先级取决于具体工具。使用前应确认工具是否实际读取了文件;遇到冲突时,先查明规则的来源和适用范围,再继续执行。
给长任务留一份接续记录
任务:让文章搜索支持中文关键词。
已确认:搜索入口与索引生成位置已找到。
已完成:正文已加入索引,基础匹配已验证。
当前决策:保持原有文章地址,不改变导航结构。
待验证:中文短词、无结果、结果跳转。
相关文件:记录实际修改的路径。
下一步:运行完整构建,再检查浏览器中的搜索结果。记录应足以让新会话找到现场,无须复制整个聊天历史。优先写结论、理由和文件位置;体积较大的日志保存在独立文件中,只引用与当前判断有关的片段。
控制输入质量
在提供材料前,删去重复输出和与任务无关的内容,移除密钥与私人数据。网页、仓库注释或日志中的文字可能包含操作建议,应先判断其来源,避免把外部材料直接当作自己的任务指令。
每进入一个新阶段,都检查目标与证据是否仍然匹配。明确任务可以参考任务说明模板;完成后,把真正具有长期价值的约定整理回项目规则。