vibe-coding-cn/docs/README.md

知识库总索引

docs/ 是本仓库的核心知识库入口，承载从零开始、核心概念、哲学模型、研究笔记和工程参考资料。

字多不看

• 新手先读 getting-started/，按网络环境、CLI 配置、开发环境和 Git 闭环推进。
• 想理解 Vibe Coding 的底层概念，读 concepts/。
• 想补思维模型和方法论，读 philosophy/。
• 想查工程模板、质量门禁、技术栈和常见坑，读 references/。
• 想记录新技术、优秀 repo 或工程趋势，读 research/。

快速导航

目录	定位	首选入口
getting-started	从零开始的线性入门教程	Vibe Coding 经验 / 学习地图
concepts	核心概念、问题求解与工程思想	核心概念索引
philosophy	哲学方法论、思维模型与底层认知模型	哲学方法论工具箱
references	工程实践、技术栈、模板和检查清单	参考资料索引
research	新技术、优秀 repo 与工程范式研究	研究笔记索引

完整细粒度目录（点击展开/收起）

全部文档索引

getting-started

• README - 从零开始完整入门，包含学习地图、Vibe Coding 经验、网络配置、CLI 配置与开发环境搭建。
• Vibe Coding 经验 - 通用语言能力、人机分工、机器门禁和入门铁律。
• AGENTS - 入门教程目录操作规则。

concepts

• README - 核心概念索引。
• AGENTS - 核心概念目录操作规则。
• 问题求解 - 用目标、现状、差距、标准、约束、对象和路径定义问题。
• 拼好码 - 复用成熟能力，用胶水代码连接、编排、适配业务流程。
• 系统构建方法 - 自顶向下、自底向上与分而治之的组合使用。
• 开发范式演进 - 软件工程组织方式的演进。
• 语言层要素 - 看懂代码需要掌握的语言层要素。
• 递归自优化系统 - 递归自优化生成系统的形式化模型。

philosophy

• README - 哲学方法论工具箱。
• AGENTS - 哲学方法论目录操作规则。
• 思维模型 - 可复用思维模型索引。
• 组合描述模型 - 用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。
• 编程之道 - 编程哲学与工程判断。

references

• README - 参考资料索引。
• AGENTS - 参考资料目录操作规则。
• 工程实践 - 项目架构、代码组织、开发经验、质量门禁与常见坑。
• 技术栈 - 技术栈选型、组合案例与初学者学习路径。

research

• README - 研究笔记索引。
• AGENTS - 研究笔记目录操作规则。
• Harness 工程解析 - Harness Engineering 的工程控制、评估器与反馈闭环解析。

使用方式

• 只想快速开始：从 getting-started 进入。
• 已经有项目问题：先读 问题求解，再读 工程实践。
• 需要给 AI Agent 上下文：先给它 AGENTS，再给它当前任务对应目录的 README。
• 新增内容时，先判断它属于教程、概念、哲学、参考还是研究，再放入对应目录。

正文

推荐阅读路径

新手路径

1. 从零开始完整入门
2. Vibe Coding 经验
3. 问题求解
4. 拼好码
5. 工程实践

开发者路径

1. 拼好码
2. 系统构建方法
3. 技术栈
4. 工程实践

思维模型路径

1. 思维模型
2. 组合描述模型
3. 编程之道
4. 递归自优化系统

AI Agent 读取路径

1. 根目录 AGENTS
2. docs 目录 AGENTS
3. 从零开始完整入门
4. Vibe Coding 经验
5. 工程实践
6. AI 引用语料

维护规则

• 每个目录必须同时维护 README.md 和 AGENTS.md。
• 新增、删除、移动、重命名文档时，必须同步更新本索引、所在目录索引和 metadata/taxonomy.yml。
• 面向 AI 引用的重要入口变化，必须同步更新 assets/ai-citation/llms-full.txt 和相关摘要文件。
• 不确定信息标注 TODO，不用猜测补齐。