核心原则

AI 编码工具的价值不只是生成代码，而是缩短从想法到可验证结果的距离。为了让它稳定参与项目，需要先把目标、上下文和验收方式说清楚。

任务输入

一个可执行的任务通常包含四类信息：

  • 目标：最终要达到什么状态。
  • 约束：哪些文件、技术栈或行为不能随意改变。
  • 参考：已有页面、设计、接口或相似实现。
  • 验收：通过什么命令或页面检查结果。

如果缺少验收方式，Agent 很容易只完成“看起来改了”的工作，而没有证明结果可靠。

上下文控制

上下文不是越多越好。更有效的做法是先让 Agent 阅读项目结构，再围绕当前任务补充关键文件。

对于前端任务，除了代码，还需要明确页面气质、布局优先级、移动端约束和交互状态。对于部署任务，则要明确域名、项目名、令牌位置和 CI 日志。

验证习惯

每次修改后都应该运行最接近真实交付的检查，例如构建、类型检查、页面访问和关键路由 smoke test。

如果同一个方向连续失败，就要停下来总结失败原因，再换一种方法。持续重复同一个失败操作只会制造更多噪音。

人的边界

AI 可以承担大量执行工作，但方向仍然要由人判断。人需要决定哪些需求真正重要，哪些实现适合长期维护，以及什么时候应该收窄范围。