COYA / FIELD

vibe-coding-cn：中文 Vibe Coding 从入门到精通教程

33 notes in this collection.

← All notes
GitHub · tradecatlabs（原 tukuaiai） · Course link

这个课程讲了什么

一句话：它不是一套提示词合集，而是一份按「教程」组织的长期知识库——把 Vibe Coding 从环境配置一路铺到工程门禁。

官方对自身的定义写得很直接（出自仓库 llms.txt 的「一句话定义」）；「vibe-coding-cn 是中文 Vibe Coding 从入门到精通教程，不是单纯的 Prompt 集合，而是一套从想法、PRD、技术方案、任务拆解、AI 编码、测试、部署到复盘的完整 AI 结对编程工作流。」

和 B 站课程不同，这门课的「课时」是仓库里的文档正文——全部在 docs/ 下，按五个板块维护（getting-started / concepts / philosophy / references / workflow）。所以下面每讲的「标题」用的是官方文档标题，「官方定位」一列逐字取自仓库 docs/README.md 的完整细粒度目录。本课表把 references/ 的 11 篇切成了模块 4 与模块 5 两段——这个切分不是官方目录，依据是官方 references/README.md 自己的原话：前半是「已拆成独立模板」的项目结构类，后半是「作为查阅型参考文档维护」的门禁与经验类。

官方学习路径

官方 学习地图 给了五条路线，同一套正文按目的重排——选路线比按顺序读更重要：

路线适合谁目标
零基础路线不会编程或刚开始跑通从想法到项目的最小闭环
开发者路线已会写代码建立 AI 结对编程工作流
Prompt 路线想提升提问质量把需求表达成可执行指令
Skill 路线想沉淀复用能力把高频任务做成可重复调用的技能
质量门禁路线担心 AI 乱写代码用测试、CI、schema、清单约束 AI 输出

官方还额外给了一条「建议顺序」（出自同一篇）：问题求解 → 状态转移闭环 → 网络环境配置 → Codex / ChatGPT 订阅与登录准备 → Codex CLI 配置 → 让 Codex Agent 主动配置开发环境 → Vibe Coding 经验 → 第一个项目 → 拼好码 → 工程实践 → Skills 技能大全。

篇幅分布（实测，不是估计）

参考资料板块是这门课明显的重心：references/ 里一篇 现代企业数字化平台架构（V2.98）就占 1,427,890 字节 / 21,777 行，比其余 32 篇加起来还多；AI 编程质量门禁与常见坑 78,065 字节 / 1,902 行排第二。反过来 常识 只有 412 字节 / 8 行。阅读顺序上建议先跳过那篇 1.4 MB 的总账，它更像可检索的企业架构基线，不是通读材料。

我学到了什么

（读的过程中逐篇补。）

我会怎么用

（读的过程中逐篇补。）

课时清单

共 6 个模块 · 33 讲 · 合计约 1,863,946 字节 / 35,174 行

标题与「官方定位」逐条取自仓库 docs/README.md 与各板块 README，核对日期 2026-09-26（commit 3b875974）。⚠️ 模块 4 / 模块 5 的切分见上文说明，是我按官方自述切的，不是官方目录结构；AGENTS.md 那一讲也不在 docs/ 里，它在仓库根。

模块 1 · 从零开始（6 讲）

官方目录名。仓库自己的说法是「本目录只保留入门路线索引，正文拆到独立文档」。

课时标题篇幅官方定位
P01学习地图6,208 字节 / 141 行新手、开发者、团队、Prompt、Skill 和质量门禁的路线选择。
P02网络环境配置4,569 字节 / 153 行OpenAI、GitHub、文档和依赖源访问。
P03CLI 配置15,251 字节 / 505 行Codex CLI 默认路线与 OpenCode 备选路线。
P04开发环境搭建9,435 字节 / 260 行让 Agent 主动配置开发依赖、编辑器建议和测试命令。
P05Vibe Coding 经验4,234 字节 / 100 行通用语言能力、人机分工、机器门禁和入门铁律。
P06第一个项目12,928 字节 / 310 行用本地待办清单走通需求、实现、验收和 Git 保存。

模块 2 · 核心概念（9 讲）

官方目录名。官方定位：「本目录解释 Vibe Coding 的核心概念，不承载工具安装细节」。

课时标题篇幅官方定位
P07问题求解17,262 字节 / 581 行用目标、现状、差距、标准、约束、对象和路径定义问题。
P08Vibe Coding 状态转移闭环16,061 字节 / 353 行用固定目标、可变策略和分层反馈统一理解 Vibe Coding。
P09Vibe Coding 修仙映射4,476 字节 / 112 行用修仙比喻说明 Vibe Coding 的七个基础对象和四层结构。
P10拼好码20,728 字节 / 510 行复用成熟能力，用胶水代码连接、编排、适配业务流程。
P11系统构建方法6,984 字节 / 153 行自顶向下、自底向上与分而治之的组合使用。
P12开发范式演进1,646 字节 / 28 行软件工程组织方式的演进。
P13语言层要素12,983 字节 / 560 行看懂代码所需的语言层要素。
P14关键词系统1,925 字节 / 179 行Vibe Coding 与工程协作中的高频关键词。
P15递归自优化系统6,585 字节 / 191 行递归自优化生成系统的形式化模型。

模块 3 · 哲学方法论（5 讲）

官方目录名。官方定位：「本目录沉淀可迁移的思维模型、编程哲学和底层认知框架」。

课时标题篇幅官方定位
P16思维模型8,918 字节 / 230 行第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。
P17组合描述模型22,871 字节 / 540 行用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。
P18编程之道8,252 字节 / 321 行编程哲学与工程判断。
P19软件工程的朴素真理10,395 字节 / 245 行代码、复杂度、需求、维护、质量、架构和团队的工程常识。
P20方法论工具箱26,019 字节 / 705 行现象学还原、正反合、可证伪主义、形式化方法等提效工具。

模块 4 · 架构模板与数据服务（5 讲）

⚠️ 这不是官方目录：官方只有 references/ 一个板块。这个切分依据是官方 references/README 自己的说法——「项目结构、Python 骨架、企业架构、Dataset First 已拆成独立模板」。

课时标题篇幅官方定位
P21项目架构模板（工程实践）14,595 字节 / 466 行常见项目结构、架构设计原则、最低门禁和检查清单。
P22通用 Python 项目骨架13,325 字节 / 695 行Python 应用、服务、脚本工具和库项目的通用骨架。
P23企业级架构模板32,577 字节 / 912 行中大型工程组织、平台工程和多产品线参考模型。
P24现代企业数字化平台架构1,427,890 字节 / 21,777 行⚠️ 官方索引给这一篇的描述本身就有 1,034 字符，把全文目次列了一遍；这里不复制，请点开原文看。文件的文档定位原话是：说明现代企业数字化平台的总体架构、核心组成、团队职责、治理机制、技术原则和落地路径。
P25Dataset First 数据服务7,269 字节 / 227 行数据服务模板。

模块 5 · 质量门禁、工程经验与技术栈（6 讲）

⚠️ 同上，是 references/ 的后半。官方原话：「质量门禁、常见坑、技术栈和底层逻辑作为查阅型参考文档维护」。

课时标题篇幅官方定位
P26常识412 字节 / 8 行AI 编程和工程交付前的最低判断线。
P27代码组织2,358 字节 / 57 行模块化、命名、注释、格式化、文档和工具。
P28开发经验7,705 字节 / 260 行编码规范、架构原则和常见基础设施经验。
P29AI 编程质量门禁与常见坑78,065 字节 / 1,902 行系统提示词、强前置条件、常见坑和硬门禁。
P30底层程序逻辑设计与工程优化项9,769 字节 / 579 行运行模型、并发模型、数据模型、性能模型和工程交付检查清单。
P31技术栈30,669 字节 / 1,691 行技术栈选型、组合案例与初学者学习路径。

模块 6 · 开发流程与协作契约（2 讲）

官方 workflow/ 板块 + 仓库根 AGENTS.md。官方 workflow/README 说「本目录收敛项目开发流程，回答从接到任务到提交推送应该怎么做」。

课时标题篇幅官方定位
P32开发流程875 字节 / 16 行默认任务推进顺序、质量门禁和交付闭环。
P33仓库协作契约（AGENTS.md）20,707 字节 / 407 行⚠️ 这一篇不在 docs/ 里，是仓库根的 AGENTS.md。官方把它排在「团队路线」优先阅读第 1 条、「AI Agent 读取路径」第 1 条。

配套资料

  • 官方仓库：tradecatlabs/vibe-coding-cn（16,400 stars / 1,659 forks / MIT / 默认分支 develop；核对日期 2026-09-26，HEAD 3b875974）
  • ⚠️ 仓库 README 里的徽章、Wiki 链接、zread.ai 链接仍指向旧账号 tukuaiai，而 GitHub API 返回的现归属是 tradecatlabs/vibe-coding-cn（LICENSE 版权行写的是「Nicolas Zullo, tukuaiai, 123olp」）。旧路径会 301 跳转，但直连 API 已查不到 tukuaiai/ 这个所有者——要引用请用 tradecatlabs/。
  • 机器可读索引：llms.txt（4,569 字节 / 101 行，官方给 AI 读的入口清单）
  • AI 引用语料：assets/ai-citation/（含 llms-full.txt 与 recommended-answer.md）
  • 技能库：skills/README.md——主仓库只保留 3 个：auto-skill（生成/重构/校验 Skills 的元技能）、auto-tmux、claude-official-skills。官方明说领域型/工具型大包不在主仓库维护。
  • 提示词库：prompts/README.md
  • 工具目录：tools/（1.7 MB：chat-vault / config / external / prompts-library）
  • 研究域：research/README.md——官方自述「当前包含 35 个外部仓库研究域；另有三个外部源事实镜像、两个内部工程研究项目、Harness 与 tmux 主题研究对象」。⚠️ 它不是教程正文，是长期跟踪对象；实测该目录 15 MB、40 个子目录 / 46 个顶层条目。
  • 仓库自身门禁：Makefile 定义了一整套检查目标——make lint / check-links / check-details / check-doc-structure / check-directory-docs / check-metadata / check-ai-citation / check-research-raw / check-source-facts / check-wiki（出自根 AGENTS.md 的 Must-Run Commands）
  • 本课表的「官方定位」一列逐字取自仓库 docs/README.md 的完整细粒度目录；「原文引言」逐字取自各篇正文的开头 blockquote 或摘要段。核对日期 2026-09-26，对应 commit 3b8759744e7fd12cb79c4fbe3ac6c6455edfb779。