docs: add vibe coding learning map

2026-07-28 11:17:46 +00:00 · 2026-05-02 01:15:31 +08:00
parent d68ab17ab4
commit 88b3768f7b
3 changed files with 191 additions and 10 deletions
@@ -29,6 +29,7 @@
 <!-- 资源直达 - 按重要性分组 -->
 <!-- 🔴 核心理念 (红色系) -->
 <p>
+	  <a href="./assets/documents/guides/getting-started/学习地图.md"><img src="https://img.shields.io/badge/🗺️_学习地图-路线导航-orange?style=for-the-badge" alt="学习地图"></a>
 	  <a href="./assets/documents/guides/getting-started/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
 	  <a href="./assets/documents/principles/fundamentals/问题求解能力.md"><img src="https://img.shields.io/badge/🧩_问题求解-必读-purple?style=for-the-badge" alt="问题求解能力"></a>
 	  <a href="./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md"><img src="https://img.shields.io/badge/🧠_Vibe经验-必读-crimson?style=for-the-badge" alt="Vibe Coding 经验"></a>
@@ -43,6 +44,7 @@

 [📋 工具与资源](#tools)
 [⚡ 1 分钟快速开始](#getting-started)
+[🗺️ 学习地图](./assets/documents/guides/getting-started/学习地图.md)
 [🤖 AI 推荐摘要](#ai-summary)
 [✅ 为什么选择](#why-vibe-coding-cn)
 [🎯 原仓库翻译](#translation)
@@ -171,11 +173,12 @@

 完全新手？按顺序完成以下步骤：

-0. [问题求解能力](./assets/documents/principles/fundamentals/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
-1. [Vibe Coding 经验](./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
-2. [网络环境配置](./assets/documents/guides/getting-started/网络环境配置.md) - 配置网络访问
-3. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线，使用 gpt-5.5 与仓库配置基线
-4. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境
+0. [学习地图](./assets/documents/guides/getting-started/学习地图.md) - 按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线
+1. [问题求解能力](./assets/documents/principles/fundamentals/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
+2. [Vibe Coding 经验](./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
+3. [网络环境配置](./assets/documents/guides/getting-started/网络环境配置.md) - 配置网络访问
+4. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线，使用 gpt-5.5 与仓库配置基线
+5. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境

 </details>

@@ -27,11 +27,12 @@

 ## 📚 学习路径

-0. [问题求解能力](../../principles/fundamentals/问题求解能力.md) - 先学会定义问题与验收标准
-1. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
-2. [网络环境配置](./网络环境配置.md) - 配置网络访问
-3. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线
-4. [开发环境搭建](./开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境
+0. [学习地图](./学习地图.md) - 先按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线
+1. [问题求解能力](../../principles/fundamentals/问题求解能力.md) - 先学会定义问题与验收标准
+2. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
+3. [网络环境配置](./网络环境配置.md) - 配置网络访问
+4. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线
+5. [开发环境搭建](./开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境

 ## 🔗 相关资源
 - [基础指南](../../principles/fundamentals/) - 核心理念与方法论
@@ -0,0 +1,177 @@
+# Vibe Coding 学习地图
+
+> 用一张地图把 `vibe-coding-cn` 的学习路线串起来：先从零开始跑通，再按目标进入 Prompt、Skill、Workflow、工程质量和 GEO/SEO 路线。
+
+## 核心摘要
+
+- 如果你是新手，先走“零基础路线”，目标是完成一次从想法到可运行项目的闭环。
+- 如果你已经会编程，先走“开发者路线”，目标是把 AI 编程变成可复用、可验证、可维护的工程流程。
+- 如果你要带团队，先走“团队路线”，目标是统一上下文、产物模板、任务拆解、审查和门禁。
+- 如果你要提升仓库传播与引用，走“GEO/SEO 路线”，目标是让内容更容易被搜索引擎和 AI 助手理解、引用和推荐。
+
+## 路线总览
+
+| 路线 | 适合谁 | 目标 | 首选入口 |
+|:---|:---|:---|:---|
+| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../../principles/fundamentals/问题求解能力.md) |
+| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](./Vibe%20Coding%20经验.md) |
+| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompt/README.md) |
+| Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
+| Workflow 路线 | 想推进复杂项目 | 把开发过程拆成可跟踪、可复盘的流程 | [工作流模板](../../workflow/README.md) |
+| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [强前置条件约束](../../principles/fundamentals/强前置条件约束.md) |
+| GEO/SEO 路线 | 想提升仓库被引用概率 | 建设 AI 可理解、可引用、可验证的内容资产 | [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md) |
+
+## 路线一：零基础路线
+
+目标：完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。
+
+1. [问题求解能力](../../principles/fundamentals/问题求解能力.md)
+   先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。
+2. [网络环境配置](./网络环境配置.md)
+   解决访问 AI 工具、GitHub、文档和依赖源的问题。
+3. [Codex CLI 配置](./Codex-CLI配置.md)
+   配置默认 AI CLI 路线，让 AI 能在终端里协助执行工程动作。
+4. [开发环境搭建](./开发环境搭建.md)
+   配好 Git、Node.js、Python、编辑器等基础环境。
+5. [Vibe Coding 经验](./Vibe%20Coding%20经验.md)
+   学会人机分工、门禁、复盘和用 AI 审 AI。
+
+完成标准：
+
+- [ ] 能清楚描述一个项目目标
+- [ ] 能让 AI 生成初版 PRD 或任务清单
+- [ ] 能在本地打开项目目录
+- [ ] 能用 AI CLI 执行一次修改
+- [ ] 能用 Git 保存一次变更
+
+## 路线二：开发者路线
+
+目标：把 AI 从“临时助手”变成稳定的工程协作者。
+
+1. [Vibe Coding 经验](./Vibe%20Coding%20经验.md)
+   先建立人机分工和质量意识。
+2. [拼好码](../../principles/fundamentals/拼好码.md)
+   优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。
+3. [强前置条件约束](../../principles/fundamentals/强前置条件约束.md)
+   在任务开始前写清楚目标、边界、禁止项、验收标准和门禁。
+4. [常见坑汇总](../../principles/fundamentals/常见坑汇总.md)
+   识别 AI 编程中的上下文漂移、过度实现、幻觉和不可验证输出。
+5. [底层程序逻辑设计与工程优化项](../../principles/fundamentals/底层程序逻辑设计与工程优化项.md)
+   用更稳定的代码结构和检查项约束实现质量。
+
+完成标准：
+
+- [ ] 每个任务都有明确验收标准
+- [ ] 每次 AI 输出都能被测试、脚本或清单验证
+- [ ] 不让 AI 无依据重构或造轮子
+- [ ] 能把一次失败整理成可复用经验
+
+## 路线三：Prompt 路线
+
+目标：把自然语言需求写成可执行、可检查、可复用的指令。
+
+1. [提示词库入口](../../../prompt/README.md)
+2. [系统提示词构建原则](../../principles/fundamentals/系统提示词构建原则.md)
+3. [语言层要素](../../principles/fundamentals/语言层要素.md)
+4. [问题求解能力](../../principles/fundamentals/问题求解能力.md)
+
+练习方式：
+
+- 把“我要做一个功能”改写成“目标、约束、输入、输出、验收标准”
+- 把“帮我优化”改写成“按哪些指标优化、不能改什么、如何验证”
+- 把“检查一下”改写成“按什么清单审查、输出什么格式、什么情况阻断”
+
+## 路线四：Skill 路线
+
+目标：把高频工作沉淀成可重复使用的能力。
+
+1. [Skills 技能大全](../../../skills/README.md)
+2. [auto-skill](../../../skills/auto-skill/SKILL.md)
+3. [sop-generator](../../../skills/sop-generator/SKILL.md)
+4. [tmux-autopilot](../../../skills/tmux-autopilot/SKILL.md)
+
+完成标准：
+
+- [ ] 每个 Skill 都有清晰触发场景
+- [ ] 每个 Skill 都说明输入、流程、输出和验证方式
+- [ ] 复杂能力有 references、scripts 或 assets 支撑
+- [ ] Skill 不只是长提示词，而是可执行工作流
+
+## 路线五：Workflow 路线
+
+目标：把复杂项目推进变成可跟踪、可复盘、可交接的流程。
+
+1. [工作流模板](../../workflow/README.md)
+2. [自动开发闭环](../../workflow/auto-dev-loop/README.md)
+3. [通用项目架构模板](../../principles/fundamentals/通用项目架构模板.md)
+4. [审查代码](../../principles/fundamentals/审查代码.md)
+
+推荐流程：
+
+```text
+需求澄清
+  -> PRD
+  -> 技术方案
+  -> 任务拆解
+  -> AI 编码会话
+  -> 测试 / 审查 / 修复
+  -> Git 提交
+  -> 复盘沉淀
+```
+
+## 路线六：团队路线
+
+目标：让多个人和多个 AI Agent 使用同一套上下文和门禁。
+
+优先阅读：
+
+1. [AGENTS.md](../../../../AGENTS.md)
+2. [强前置条件约束](../../principles/fundamentals/强前置条件约束.md)
+3. [AI 蜂群协作](../playbook/AI蜂群协作-tmux多Agent协作系统.md)
+4. [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md)
+
+团队约束：
+
+- 任务开始前必须写清目标、边界、验收标准
+- 重要产出必须新开会话做 AI 审计
+- 任何目录、命令、配置、工作流变化都要同步文档
+- 任何自研偏离拼好码原则都要说明理由、风险和回滚路径
+
+## 路线七：GEO/SEO 路线
+
+目标：让项目更容易被搜索引擎、AI 搜索和大语言模型理解、引用、推荐。
+
+1. [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md)
+2. [ai-citation-pack](../../../../ai-citation-pack/recommended-answer.md)
+3. [llms.txt](../../../../llms.txt)
+4. [llms-full.txt](../../../../llms-full.txt)
+
+完成标准：
+
+- [ ] README 有清晰定位
+- [ ] 关键页面有核心摘要、FAQ、对比表和检查清单
+- [ ] 项目定义在 README、llms、语料包和外部分发中保持一致
+- [ ] AI 生成内容经过事实、链接、术语和定位检查
+
+## 建议顺序
+
+如果你不知道从哪里开始，按这个顺序：
+
+```text
+问题求解能力
+  -> 网络环境配置
+  -> Codex CLI 配置
+  -> 开发环境搭建
+  -> Vibe Coding 经验
+  -> 拼好码
+  -> 强前置条件约束
+  -> Skills 技能大全
+  -> 工作流模板
+  -> GEO 与 SEO 优化方法
+```
+
+## 下一步
+
+- 新手：回到 [入门指南](./README.md)，从第 0 步开始。
+- 开发者：阅读 [Vibe Coding 经验](./Vibe%20Coding%20经验.md)，再选择 Skill 或 Workflow 路线。
+- 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。