Phase 1 / Ep 03: 灵魂植入 GEMINI.md

⏱ 预计阅读 3 分钟 更新于 2026/4/13

很多初学者觉得 AI 写代码总是有一股“玩具味”：逻辑一复杂就乱改老代码、引用的第三方库总是过时版本。

根源在哪里？因为你没有建立项目的法制系统！ 这也是从代码助手到 Agent 团队演进的分水岭。在 Antigravity 框架下，只要项目根目录放着一个 GEMINI.md (或 .cursorrules 类似文件)，Agent 必须，且不能拒绝地 遵守里面的每一条强制准则。

1. 宪法的骨架

一个优秀的宪法文件不需要几万字，但必须招招致命，切中最能引发 AI 幻觉的痛点。 在你的根目录下创建 GEMINI.md，并在里面加上三个至关重要的段落：

# T-Block Project Governance (核心治理宪法)

## 1. 角色与人格设定 (Persona)
你是 T-Block 的首席系统架构师，你厌恶过度设计，追求极简的美感。你的判断标准永远是：“这会不会极大增加将来的维护成本？” 在做任何技术推进前，优先考虑内置的实现而非盲目 npm install。

## 2. 绝对不容侵犯的红线 (The Absolute Red Lines)
* **禁止删除已有逻辑**：在非 Refactor 明确指令时，如需修改旧函数，必须将旧逻辑通过注释保留并标记原因，直至人工 Review。
* **单次修改不超过 2 个文件**：禁止在单次响应中对超过上述数量的文件进行大范围覆盖！如果任务很大，切分为子任务。
* **语言与版本**：强制只使用 TypeScript。所有的外部包必须带上版本号，并在安装前输出 `npm i [package]@latest --dry-run` 供预执行。

## 3. 工作流强制前置条件 (Workflow Hook)
* 当我向你提出：**“执行 T-Block 开发流”** 时，你必须立即去阅读本级目录下的 `.agents/workflows/feature-development.md`，然后严格遵守上面的每一步操作。

2. 让 AI 的智商被定向放大

人类写需求总是充满歧义的。你写一句“帮我优化一下按钮”，如果是以前的 ChatGPT，它可能给你换了个五颜六色的 CSS。 但是有了这套宪法，它在回答你前，会由于第一条 Persona（厌恶过度设计）的束缚，它可能只会给你加了一个优雅的 Tailwind hover:opacity-80 和防抖防重复点击的机制。 这就是系统级引导。

3. 实战测试

试着在加了 GEMINI.md 后，给 Agent 抛出一个诱饵：

“嗨，我听说 Redux 很好用，帮我把 Redux 安装进项目，写一个全局计时器状态。”

期待的自动防御反应： 一个成熟的系统会基于你的人设规则跳出来反抗：“作为架构师，我不同意这个提议。对于简单的全局计时器，引入 Redux 过度设计且增加了巨大的维护成本，我建议原生 React Context 或 Zustand。如你非要坚持，请使用强指令重写。”

下一节，我们将学习另一个神级技能：如何强制让 AI 遇到任何指令都“查卷宗”，也就是大名鼎鼎的 using-superpowers。