当你深度依赖 AI 进行日常开发时，历史对话记录、精心调校的提示词一旦丢失，代价极其惨重。本文基于一位开发者的真实踩坑经历，沉淀出 vibe-coding-template 模板，带你系统性地理解并迁移这套可复用的 Agent 协作工作流。无论你是初次接触 vibe coding，还是已经在使用 Codex、GPT 等工具编写项目，这份教程都能帮你建立安全、高效、可迭代的开发流水线。
为什么需要一套 Agent 协作模板？
让 Agent 写出第一版代码通常不难，真正困难的是长期协作。项目写久了，会反复遇到以下问题：
- 换一个仓库，又得重新告诉 Agent 项目规则、测试方式、交付格式以及不能乱改的边界规定。
- 想让 Agent 做 code review，很难真正围绕当前 diff、项目规则和潜在风险找出问题。
- 想把一个高频流程沉淀下来，结果 prompt 只能解决当下任务，下次换个场景又要重新编写。
- 深度 vibe coding 之后，自己可能反而看不懂 Agent 生成的代码和方案。遇到不熟悉的技术点，必须先补齐背景知识，把核心原理、关键术语和项目落点讲清楚，否则后续开发方向很容易失控。
- 任务依赖最新官方文档、论文、API 或 benchmark 时，Agent 可能凭旧知识给出很确定的回答，后续实现也会被模型幻觉带偏。
