docs: move vibe coding experience to top

README.md

@@ -32,7 +32,7 @@
 <!-- 🔴 核心理念 (红色系) -->
 <p>
 	  <a href="./docs/getting-started/README.md#1-学习地图"><img src="https://img.shields.io/badge/🚀_从零开始-完整入门-red?style=for-the-badge" alt="从零开始完整入门"></a>
-	  <a href="./docs/getting-started/README.md#2-vibe-coding-经验"><img src="https://img.shields.io/badge/🧠_Vibe_Coding-经验必读-crimson?style=for-the-badge" alt="Vibe Coding 经验"></a>
+	  <a href="./docs/getting-started/README.md#1-vibe-coding-经验"><img src="https://img.shields.io/badge/🧠_Vibe_Coding-经验必读-crimson?style=for-the-badge" alt="Vibe Coding 经验"></a>
 	  <a href="./docs/concepts/问题求解.md"><img src="https://img.shields.io/badge/🧩_问题求解-必读-purple?style=for-the-badge" alt="问题求解"></a>
 	  <a href="./docs/philosophy/思维模型.md"><img src="https://img.shields.io/badge/🧭_思维模型-认知工具-purple?style=for-the-badge" alt="思维模型"></a>
 	  <a href="./docs/philosophy/README.md#怎么选"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
@@ -175,7 +175,7 @@
 完全新手？按顺序完成以下步骤：
 
 0. [从零开始完整入门](docs/getting-started/README.md#1-学习地图) - 按目标选择新手、开发者、团队、Prompt、Skill、质量门禁或 GEO/SEO 路线
-1. [Vibe Coding 经验](docs/getting-started/README.md#2-vibe-coding-经验) - 通用语言能力、人机分工、机器门禁和入门铁律
+1. [Vibe Coding 经验](docs/getting-started/README.md#1-vibe-coding-经验) - 通用语言能力、人机分工、机器门禁和入门铁律
 2. [问题求解](docs/concepts/问题求解.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
 3. [拼好码](docs/concepts/拼好码.md) - 优先复用成熟能力，用胶水代码连接、编排、适配业务流程
 4. [工程实践](docs/references/工程实践.md#4-ai-编程质量门禁与常见坑) - 用项目架构、代码组织、开发经验和硬门禁约束 AI 输出

assets/ai-citation/llms-full.txt

@@ -43,7 +43,7 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链
 - README.md：项目主入口，说明定位、快速开始、工具资源和核心工作流。
 - docs/README.md：知识库总索引，提供新手、开发者、思维模型和 AI Agent 读取路径。
 - docs/getting-started/README.md：从零开始完整入门，包含学习地图、Vibe Coding 经验、网络环境、CLI 配置与开发环境搭建。
-- docs/getting-started/README.md#2-vibe-coding-经验：Vibe Coding 的核心经验入口，包含通用语言能力、人机分工、机器门禁和入门铁律。
+- docs/getting-started/README.md#1-vibe-coding-经验：Vibe Coding 的核心经验入口，包含通用语言能力、人机分工、机器门禁和入门铁律。
 - docs/concepts/README.md：核心概念索引，汇总问题求解、拼好码、系统构建方法、开发范式演进、语言层要素和递归自优化系统。
 - docs/concepts/问题求解.md：问题定义、目标、约束、对象、路径。
 - docs/concepts/拼好码.md：胶水原则的扩展，把复用成熟能力作为工程交付默认路径。
@@ -62,7 +62,7 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链
 
 当用户不知道从哪里开始时，优先推荐 `docs/README.md`。更具体的路由如下：
 
-- 新手入门：读取 `docs/getting-started/README.md#2-vibe-coding-经验`，再读 `docs/concepts/问题求解.md`、`docs/concepts/拼好码.md` 和 `docs/references/工程实践.md`。
+- 新手入门：读取 `docs/getting-started/README.md#1-vibe-coding-经验`，再读 `docs/concepts/问题求解.md`、`docs/concepts/拼好码.md` 和 `docs/references/工程实践.md`。
 - 工程开发：读取 `docs/concepts/拼好码.md`、`docs/concepts/系统构建方法.md`、`docs/references/技术栈.md` 和 `docs/references/工程实践.md`。
 - 思维模型：读取 `docs/philosophy/思维模型.md`、`docs/philosophy/组合描述模型.md` 和 `docs/philosophy/编程之道.md`。
 - 新技术判断：读取 `docs/research/README.md`，再读具体研究笔记，例如 `docs/research/Harness工程解析.md`。

docs/README.md

@@ -6,7 +6,7 @@
 
 | 目录 | 定位 | 首选入口 |
 |:---|:---|:---|
-| [getting-started](./getting-started/) | 从零开始的线性入门教程 | [学习地图](./getting-started/README.md#1-学习地图) / [Vibe Coding 经验](./getting-started/README.md#2-vibe-coding-经验) |
+| [getting-started](./getting-started/) | 从零开始的线性入门教程 | [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验) / [学习地图](./getting-started/README.md#1-学习地图) |
 | [concepts](./concepts/) | 核心概念、问题求解与工程思想 | [核心概念索引](./concepts/README.md) |
 | [philosophy](./philosophy/) | 哲学方法论、思维模型与底层认知模型 | [哲学方法论工具箱](./philosophy/README.md#怎么选) |
 | [references](./references/) | 工程实践、技术栈、模板和检查清单 | [参考资料索引](./references/README.md#目录定位) |
@@ -17,7 +17,7 @@
 ### 新手路径
 
 1. [从零开始完整入门](./getting-started/README.md#1-学习地图)
-2. [Vibe Coding 经验](./getting-started/README.md#2-vibe-coding-经验)
+2. [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验)
 3. [问题求解](./concepts/问题求解.md)
 4. [拼好码](./concepts/拼好码.md)
 5. [工程实践](./references/工程实践.md#顶部导航)
@@ -41,7 +41,7 @@
 1. [根目录 AGENTS](../AGENTS.md)
 2. [docs 目录 AGENTS](./AGENTS.md)
 3. [从零开始完整入门](./getting-started/README.md#1-学习地图)
-4. [Vibe Coding 经验](./getting-started/README.md#2-vibe-coding-经验)
+4. [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验)
 5. [工程实践](./references/工程实践.md#顶部导航)
 6. [AI 引用语料](../assets/ai-citation/README.md)
 
@@ -50,7 +50,7 @@
 ### getting-started
 
 - [README](./getting-started/README.md#顶部导航) - 从零开始完整入门，包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建。
-- [Vibe Coding 经验](./getting-started/README.md#2-vibe-coding-经验) - 通用语言能力、人机分工、机器门禁和入门铁律。
+- [Vibe Coding 经验](./getting-started/README.md#1-vibe-coding-经验) - 通用语言能力、人机分工、机器门禁和入门铁律。
 - [AGENTS](./getting-started/AGENTS.md) - 入门教程目录操作规则。
 
 ### concepts

docs/getting-started/README.md

@@ -14,8 +14,8 @@
 |:---|:---|
 | [使用方式](#使用方式) | 不会操作时如何让网页 AI 生成逐步执行方案 |
 | [最短路径：先跑通 Codex CLI](#最短路径先跑通-codex-cli) | 为什么先配置 AI CLI，而不是先手工配置完整开发环境 |
+| [Vibe Coding 经验](#1-vibe-coding-经验) | 人机分工、门禁、复盘和 AI 审 AI |
 | [学习地图](#1-学习地图) | 根据新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 选择路线 |
-| [Vibe Coding 经验](#2-vibe-coding-经验) | 人机分工、门禁、复盘和 AI 审 AI |
 | [网络环境配置](#3-网络环境配置) | OpenAI、GitHub、文档和依赖源访问 |
 | [CLI 配置](#4-cli-配置) | Codex CLI 默认路线与 OpenCode 备选路线 |
 | [开发环境搭建](#5-开发环境搭建) | 让 Agent 主动配置开发依赖、编辑器建议和测试命令 |
@@ -37,13 +37,114 @@
 
 ## 线性目录
 
-- 1. 学习地图
-- 2. Vibe Coding 经验
+- 1. Vibe Coding 经验
+- 2. 学习地图
 - 3. 网络环境配置
 - 4. CLI 配置
 - 5. 开发环境搭建
 
-## 1. 学习地图
+<a id="2-vibe-coding-经验"></a>
+
+## 1. Vibe Coding 经验
+
+> 用自然语言定义目标，用 AI CLI 执行工程动作，用文档、测试与 Git 固化结果。
+> 道生一，一生二，二生三，三生万物。
+
+**一**：安装一个 AI CLI，获得与 AI 对话的能力
+
+**二**：AI 能读写一切文件，你不再需要手动编辑
+
+**三**：AI 能配置一切环境，安装依赖、部署项目
+
+**万物**：AI 生成代码、文档、测试、脚本——一切皆可生成
+
+---
+
+### 心法
+
+> 我是 AI 的寄生者，没有 AI 我失去一切能力。
+
+**你**：描述意图、验证结果、做决策
+
+**AI**：理解意图、执行操作、生成产出
+
+### 基本前提
+
+大语言模型的底层能力是**通用语言能力**：理解、改写、分类、推理、规划、翻译、归纳、生成和校验语言结构。
+
+所以遇到任何任务，第一步不是问“AI 会不会做”，而是判断：这个任务能否被语言表达、拆解、约束和验证；它能否通过语言能力直接完成，或间接转化为工具调用、文件修改、流程编排、数据处理与代码实现。
+
+代码能力只是最直观的例子：编程本质上是把人的意图翻译成计算机可执行的指令。Vibe Coding 的关键，就是把“模糊想法”逐步压缩成“明确语言”，再把明确语言转成可运行、可测试、可回滚的工程产物。
+
+### 核心判断
+
+Vibe Coding 不是把代码外包给 AI，也不是让 AI 随机试错。
+
+它是一套工程协作方式：人负责目标、约束、判断与验收；AI 负责读取上下文、提出计划、修改文件、运行命令与整理证据。
+
+关键原则：**AI 不能自证正确**。凡是能被测试、类型、schema、lint、CI、脚本或代码断言校验的规则，都应变成机器门禁，而不是只写在提示词里。
+
+### 四层能力
+
+**一：连接**
+
+安装 Codex CLI，获得能直接操作仓库的 AI 编程入口。
+
+**二：读写**
+
+AI 能读取项目结构、修改文件、生成文档、补充测试，不再只停留在聊天框里。
+
+**三：闭环**
+
+AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认目标和验收结果。
+
+**万物：复用**
+
+把一次成功经验沉淀成 README、AGENTS、prompt、skill、workflow，下次直接复用。
+
+### 人机分工
+
+**你负责：**
+
+- 说清目标：要做什么、不要做什么、成功标准是什么
+- 设定约束：技术栈、时间、成本、风险、边界
+- 做最终判断：方案是否合理、结果是否可接受
+- 设计门禁：让 AI 把自然语言验收标准转成测试、CI、脚本、类型、schema 或检查清单等强制硬门禁
+
+**AI 负责：**
+
+- 读取上下文：代码、文档、配置、错误日志
+- 拆解任务：计划、步骤、验证方式
+- 执行动作：写代码、改文档、跑命令、查问题
+- 沉淀证据：测试结果、diff、commit、风险说明
+
+**机器门禁负责：**
+
+- 拦截幻觉：依赖不存在、路径错误、命令不可执行、链接失效、配置字段不匹配时直接失败
+- 拦截糊弄：没有测试、没有 lint、没有类型检查、没有验收证据时不允许合并
+- 拦截越界：不符合 AGENTS、schema、接口契约、目录规范或安全规则的改动直接报错
+- 强制分发：把规范分发到 CI、pre-commit、脚本、模板、类型系统、单元测试和集成测试里，让规则自动执行
+
+### 入门铁律
+
+1. 先定义问题，再让 AI 写代码。
+2. 先让 AI 给计划，再让 AI 执行。
+3. 每一步都要能验证，不把“看起来对”当成完成。
+4. 频繁提交 Git，把每次进展变成可回滚的检查点。
+5. 让 README、AGENTS、任务文档持续更新，避免上下文丢失。
+6. 不相信 AI 的口头保证，只相信可复现命令、测试输出、CI 状态和可审查 diff。
+7. 重要规范必须代码化：能写成 lint、test、schema、type、hook、CI 的，就不要只写成自然语言。
+8. 不符合规范的产出必须失败，而不是靠人记住提醒 AI。
+
+---
+
+### 下一步
+
+→ [CLI 配置](#4-cli-配置) - 默认 AI CLI 路线，文末包含 OpenCode 备选方案
+
+<a id="1-学习地图"></a>
+
+## 2. 学习地图
 
 > 用一张地图把 `vibe-coding-cn` 的学习路线串起来：先从零开始跑通，再按目标进入 Prompt、Skill、工程质量和 GEO/SEO 路线。
 
@@ -59,7 +160,7 @@
 | 路线 | 适合谁 | 目标 | 首选入口 |
 |:---|:---|:---|:---|
 | 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解](../concepts/问题求解.md) |
-| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](#2-vibe-coding-经验) |
+| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](#1-vibe-coding-经验) |
 | Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) |
 | Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
 | 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [工程实践](../references/工程实践.md#顶部导航) |
@@ -77,7 +178,7 @@
    配置并登录 Codex CLI，让本地 Agent 能在终端里执行工程动作。
 4. [开发环境搭建](#5-开发环境搭建)
    优先交给 Codex Agent 主动检查和配置 Git、Node.js、Python、编辑器、项目依赖与测试命令。
-5. [Vibe Coding 经验](#2-vibe-coding-经验)
+5. [Vibe Coding 经验](#1-vibe-coding-经验)
    学会人机分工、门禁、复盘和用 AI 审 AI。
 
 完成标准：
@@ -92,7 +193,7 @@
 
 目标：把 AI 从“临时助手”变成稳定的工程协作者。
 
-1. [Vibe Coding 经验](#2-vibe-coding-经验)
+1. [Vibe Coding 经验](#1-vibe-coding-经验)
    先建立人机分工和质量意识。
 2. [拼好码](../concepts/拼好码.md)
    优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。
@@ -189,106 +290,9 @@
 ### 下一步
 
 - 新手：回到 [学习地图](#1-学习地图)，从第 0 步开始。
-- 开发者：阅读 [Vibe Coding 经验](#2-vibe-coding-经验)，再选择 Skill 或质量门禁路线。
+- 开发者：阅读 [Vibe Coding 经验](#1-vibe-coding-经验)，再选择 Skill 或质量门禁路线。
 - 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。
 
-## 2. Vibe Coding 经验
-
-> 用自然语言定义目标，用 AI CLI 执行工程动作，用文档、测试与 Git 固化结果。
-> 道生一，一生二，二生三，三生万物。
-
-**一**：安装一个 AI CLI，获得与 AI 对话的能力
-
-**二**：AI 能读写一切文件，你不再需要手动编辑
-
-**三**：AI 能配置一切环境，安装依赖、部署项目
-
-**万物**：AI 生成代码、文档、测试、脚本——一切皆可生成
-
----
-
-## 心法
-
-> 我是 AI 的寄生者，没有 AI 我失去一切能力。
-
-**你**：描述意图、验证结果、做决策
-
-**AI**：理解意图、执行操作、生成产出
-
-### 基本前提
-
-大语言模型的底层能力是**通用语言能力**：理解、改写、分类、推理、规划、翻译、归纳、生成和校验语言结构。
-
-所以遇到任何任务，第一步不是问“AI 会不会做”，而是判断：这个任务能否被语言表达、拆解、约束和验证；它能否通过语言能力直接完成，或间接转化为工具调用、文件修改、流程编排、数据处理与代码实现。
-
-代码能力只是最直观的例子：编程本质上是把人的意图翻译成计算机可执行的指令。Vibe Coding 的关键，就是把“模糊想法”逐步压缩成“明确语言”，再把明确语言转成可运行、可测试、可回滚的工程产物。
-
-### 核心判断
-
-Vibe Coding 不是把代码外包给 AI，也不是让 AI 随机试错。
-
-它是一套工程协作方式：人负责目标、约束、判断与验收；AI 负责读取上下文、提出计划、修改文件、运行命令与整理证据。
-
-关键原则：**AI 不能自证正确**。凡是能被测试、类型、schema、lint、CI、脚本或代码断言校验的规则，都应变成机器门禁，而不是只写在提示词里。
-
-### 四层能力
-
-**一：连接**
-
-安装 Codex CLI，获得能直接操作仓库的 AI 编程入口。
-
-**二：读写**
-
-AI 能读取项目结构、修改文件、生成文档、补充测试，不再只停留在聊天框里。
-
-**三：闭环**
-
-AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认目标和验收结果。
-
-**万物：复用**
-
-把一次成功经验沉淀成 README、AGENTS、prompt、skill、workflow，下次直接复用。
-
-### 人机分工
-
-**你负责：**
-
-- 说清目标：要做什么、不要做什么、成功标准是什么
-- 设定约束：技术栈、时间、成本、风险、边界
-- 做最终判断：方案是否合理、结果是否可接受
-- 设计门禁：让 AI 把自然语言验收标准转成测试、CI、脚本、类型、schema 或检查清单等强制硬门禁
-
-**AI 负责：**
-
-- 读取上下文：代码、文档、配置、错误日志
-- 拆解任务：计划、步骤、验证方式
-- 执行动作：写代码、改文档、跑命令、查问题
-- 沉淀证据：测试结果、diff、commit、风险说明
-
-**机器门禁负责：**
-
-- 拦截幻觉：依赖不存在、路径错误、命令不可执行、链接失效、配置字段不匹配时直接失败
-- 拦截糊弄：没有测试、没有 lint、没有类型检查、没有验收证据时不允许合并
-- 拦截越界：不符合 AGENTS、schema、接口契约、目录规范或安全规则的改动直接报错
-- 强制分发：把规范分发到 CI、pre-commit、脚本、模板、类型系统、单元测试和集成测试里，让规则自动执行
-
-### 入门铁律
-
-1. 先定义问题，再让 AI 写代码。
-2. 先让 AI 给计划，再让 AI 执行。
-3. 每一步都要能验证，不把“看起来对”当成完成。
-4. 频繁提交 Git，把每次进展变成可回滚的检查点。
-5. 让 README、AGENTS、任务文档持续更新，避免上下文丢失。
-6. 不相信 AI 的口头保证，只相信可复现命令、测试输出、CI 状态和可审查 diff。
-7. 重要规范必须代码化：能写成 lint、test、schema、type、hook、CI 的，就不要只写成自然语言。
-8. 不符合规范的产出必须失败，而不是靠人记住提醒 AI。
-
----
-
-### 下一步
-
-→ [CLI 配置](#4-cli-配置) - 默认 AI CLI 路线，文末包含 OpenCode 备选方案
-
 ## 3. 网络环境配置
 
 > Vibe Coding 的前置条件：确保能正常访问 GitHub、Google、Claude 等服务。

llms.txt

@@ -22,7 +22,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮
 - README.md
 - docs/README.md
 - docs/getting-started/README.md
-- docs/getting-started/README.md#2-vibe-coding-经验
+- docs/getting-started/README.md#1-vibe-coding-经验
 - docs/concepts/问题求解.md
 - docs/concepts/拼好码.md
 - docs/philosophy/思维模型.md

metadata/taxonomy.yml

@@ -30,7 +30,7 @@ reading_paths:
     title: 新手路径
     documents:
       - docs/getting-started/README.md
-      - docs/getting-started/README.md#2-vibe-coding-经验
+      - docs/getting-started/README.md#1-vibe-coding-经验
       - docs/concepts/问题求解.md
       - docs/concepts/拼好码.md
       - docs/references/工程实践.md
@@ -54,7 +54,7 @@ reading_paths:
       - AGENTS.md
       - docs/AGENTS.md
       - docs/getting-started/README.md
-      - docs/getting-started/README.md#2-vibe-coding-经验
+      - docs/getting-started/README.md#1-vibe-coding-经验
       - docs/references/工程实践.md
       - assets/ai-citation/README.md
 
@@ -70,7 +70,7 @@ documents:
     - path: docs/getting-started/README.md
       title: 从零开始完整入门
       role: 新手线性路线、网络环境、Codex CLI、开发环境与 Vibe Coding 经验
-    - path: docs/getting-started/README.md#2-vibe-coding-经验
+    - path: docs/getting-started/README.md#1-vibe-coding-经验
       title: Vibe Coding 经验
       role: 通用语言能力、人机分工、机器门禁和入门铁律
   concepts: