diff --git a/README.md b/README.md index 7b67c4c..1db7b32 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,7 @@

+ 学习地图 从零开始 问题求解能力 Vibe Coding 经验 @@ -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、编辑器等基础环境 diff --git a/assets/documents/guides/getting-started/README.md b/assets/documents/guides/getting-started/README.md index 9e01602..d9fb503 100644 --- a/assets/documents/guides/getting-started/README.md +++ b/assets/documents/guides/getting-started/README.md @@ -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/) - 核心理念与方法论 diff --git a/assets/documents/guides/getting-started/学习地图.md b/assets/documents/guides/getting-started/学习地图.md new file mode 100644 index 0000000..847dd20 --- /dev/null +++ b/assets/documents/guides/getting-started/学习地图.md @@ -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)、强前置条件和质量门禁。