Phase 1 / Ep 02: Antigravity 环境准备与边界划定

在上一期中，我们准备了 T-Block 项目的一页纸规划。在此刻，你可能会打开终端并说：“按要求用 Next.js 建立项目吧。”

停。你还需要最后一点耐心。一个任由 AI 在根目录下随意增删改查的仓库，是一个随时会爆炸的盲盒。

在真正的 Agentic 开发中，“环境准备”指的是为 Agent 立规矩，从物理文件夹层面划定出哪些是系统指令层，哪些是业务代码层。

1. 让项目变成一个“国家”

普通开发者创建一个文件夹。Agent 开发者创建一套“行政机构”。 进入你的项目根目录，我们需要建立这样几个最基本的物理架构：

/t-block-monorepo
  ├── .agents/          # <- 你的 AI 管理团队的“办公室”
  │   ├── workflows/    # 流水线规范
  │   └── skills/       # AI 的大招/绝技技能树
  ├── docs/             # 强制要求的持久化脑区（findings.md 等会放在这里）
  ├── web-client/       # 前端 Next.js 代码
  └── backend-api/      # 后端 Nest.js 货 Prisma 代码（如果拆开的话）

2. 为什么需要明确分离？

灾难场景一：如果没有 docs/ 和明确的作用域，大模型极容易在生成代码时，由于 Token 上下文混乱，把你本来放在根目录的配置直接删掉，或者把前端配置和后端的配置合并起来揉成一团。

规范化约定：你要在下达任何创建命令前，给 Agent 发出不可跨越的行政指令：

“以后业务代码必须只能放在 web-client/ 下。而所有关于开发流程的文档、反思，只能存放在 .agents/ 和 docs/ 目录下。”

3. 实战：唤醒系统底层建筑

你不需要自己去 mkdir 创建这些内容，这是绝佳的第一次“操练你的 Agent”的机会。

把这句话投喂给 Antigravity/Agent：

“当前是一个全新的多仓项目。请在当前根目录下创建一个名为 .agents/workflows/ 和 .agents/skills/ 的目录结构。并创建一个 docs/ 目录。不要写任何业务库代码，执行结束后向我报告。”

你看，通过让 Agent 自己建出这些目录，它的大脑里已经种下了“这是一个具备自治理层架构”的项目认知。 这远比你自己手动新建文件夹，然后再给它描述，来得深刻得多。

下一节，我们将为这个空荡荡的 办公室，颁发至高无上的系统宪法：《GEMINI.md》。