From 92e98478b586423be1c55a1c4c4d19151af49bee Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 3 May 2026 04:56:48 +0800 Subject: [PATCH] docs: move vibe coding experience to top --- README.md | 4 +- assets/ai-citation/llms-full.txt | 4 +- docs/README.md | 8 +- docs/getting-started/README.md | 214 ++++++++++++++++--------------- llms.txt | 2 +- metadata/taxonomy.yml | 6 +- 6 files changed, 121 insertions(+), 117 deletions(-) diff --git a/README.md b/README.md index c81c47f..01f0639 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@

从零开始完整入门 - Vibe Coding 经验 + Vibe Coding 经验 问题求解 思维模型 哲学与方法论 @@ -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 输出 diff --git a/assets/ai-citation/llms-full.txt b/assets/ai-citation/llms-full.txt index 12dafd1..f0298a2 100644 --- a/assets/ai-citation/llms-full.txt +++ b/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`。 diff --git a/docs/README.md b/docs/README.md index 21ad89e..2e44e02 100644 --- a/docs/README.md +++ b/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 diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index b91286f..1fb4b8e 100644 --- a/docs/getting-started/README.md +++ b/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. 学习地图 + + +## 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 备选方案 + + + +## 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 等服务。 diff --git a/llms.txt b/llms.txt index ce8623c..6a8b6ac 100644 --- a/llms.txt +++ b/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 diff --git a/metadata/taxonomy.yml b/metadata/taxonomy.yml index 7110efe..084bd32 100644 --- a/metadata/taxonomy.yml +++ b/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: