# Vibe Coding 哲学原理

> 用自然语言定义目标，用 AI CLI 执行工程动作，用文档、测试与 Git 固化结果。

---

## 核心判断

Vibe Coding 不是把代码外包给 AI，也不是让 AI 随机试错。

它是一套工程协作方式：人负责目标、约束、判断与验收；AI 负责读取上下文、提出计划、修改文件、运行命令与整理证据。

## 四层能力

**一：连接**

安装 Codex CLI，获得能直接操作仓库的 AI 编程入口。

**二：读写**

AI 能读取项目结构、修改文件、生成文档、补充测试，不再只停留在聊天框里。

**三：闭环**

AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认目标和验收结果。

**万物：复用**

把一次成功经验沉淀成 README、AGENTS、prompt、skill、workflow，下次直接复用。

## 人机分工

**你负责：**

- 说清目标：要做什么、不要做什么、成功标准是什么
- 设定约束：技术栈、时间、成本、风险、边界
- 做最终判断：方案是否合理、结果是否可接受

**AI 负责：**

- 读取上下文：代码、文档、配置、错误日志
- 拆解任务：计划、步骤、验证方式
- 执行动作：写代码、改文档、跑命令、查问题
- 沉淀证据：测试结果、diff、commit、风险说明

## 入门铁律

1. 先定义问题，再让 AI 写代码。
2. 先让 AI 给计划，再让 AI 执行。
3. 每一步都要能验证，不把“看起来对”当成完成。
4. 频繁提交 Git，把每次进展变成可回滚的检查点。
5. 让 README、AGENTS、任务文档持续更新，避免上下文丢失。

---

## 下一步

→ [Codex-CLI配置](./Codex-CLI配置.md) - 默认 AI CLI 路线

→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选路线