模糊需求导致Agent输出质量不稳定,提出结构化任务描述模板:明确目标、边界、验收证据和「完成」定义,并给出上下文最优实践。
AI 编码 Agent 的能力正在变得越来越强大,能够处理越来越复杂的开发工作。但最终结果的质量,仍然很大程度上取决于任务的准备方式、分配方式、审查方式以及验收方式。
像「修复引导流程」这样模糊的请求,会留下太多悬而未决的决策。而结构化的任务则可以为 Agent 提供明确的目标、边界、证据要求以及完成定义。
下面是一个简单的workflow,可以让你的 Agent 辅助开发更加可靠。
描述工作完成后应该达成什么状态:
改进设置页面。
允许用户编辑通知偏好,保存更改,并在刷新页面后看到相同的值。
第二个版本给 Agent 和审查者都提供了可以验证的具体内容。
Agent 在了解以下信息时表现更好:
好的上下文可以减少不必要的探索,降低无关变更的风险。
一个有用的任务不仅要说明要改什么,还要说明不改什么:
约束条件帮助 Agent 保持在预期的范围内。
在工作开始之前,就决定如何证明完成。根据任务不同,证明可以包括:
这让审查更快,并防止「应该能用了」成为最终的验证方式。
Agent 可以实现并测试一个变更,但人类仍需确认产品意图、用户体验以及意外副作用。
实用的审查清单是:
当多个人和 Agent 协作时,workflow 本身就变得很重要。团队需要一个明确的地方来起草任务、分配工作、记录需求、审查证据以及跟踪交付。
我目前正在将 Wagglet 作为这种结构化任务 workflow 的一部分来探索。
核心思路很简单:AI Agent 在任务被视为可验证的工作单元而非孤立的 prompt 时,表现会更好。
Agent 辅助开发中最大的改进往往不是来自写一个更长的 prompt,而是来自在 prompt 周围创建一个更清晰的流程。
一个强有力的任务应该回答四个问题:
当这些答案清晰后,AI Agent 就更容易引导、审查和信任。