Vibe Coding 知识库

讲师流程计划 ​

这份计划面向讲师，按 180 分钟设计。现场可以压缩为 150 分钟：减少讨论时间，保留两个工具实战和最后复盘。

课前准备 ​

讲师需要提前准备：

  • 一个空示例仓库，建议名为 ai-delivery-board。
  • Node.js、Git、VS Code 或 Cursor。
  • Claude Code 已按官方推荐方式安装并登录，可以在项目根目录运行 claude。
  • Codex App、Codex CLI 或 IDE 扩展已安装并登录，可以读写当前仓库。
  • 本文档站本地运行，用于跳转讲解。
  • 一个屏幕展示 IDE，另一个屏幕展示浏览器预览更好。

学员需要提前准备：

  • Git 基础操作。
  • 能打开 IDE、终端和浏览器。
  • 不要求已经熟悉 Claude Code 或 Codex。

安装与登录检查 ​

Claude Code 课堂推荐使用官方原生安装方式。Windows 现场优先用 PowerShell，macOS、Linux 或 WSL 用 shell：

powershell
irm https://claude.ai/install.ps1 | iex
claude
bash
curl -fsSL https://claude.ai/install.sh | bash
claude

如果使用 macOS/Linux Homebrew，也可以安装稳定 cask：

bash
brew install --cask claude-code

Codex 课堂推荐至少准备一种入口：Codex CLI、Codex App 或 IDE 扩展。CLI 方式适合从空仓库演示：

powershell
npm i -g @openai/codex
codex

如果使用 macOS Homebrew：

bash
brew install --cask codex
codex

第一次启动两个工具时都需要登录。课前必须在示例仓库根目录各跑一次，确认它们能读取 README.md、CLAUDE.md 或 AGENTS.md，并且不要把 API Key、访问令牌或浏览器登录截图写入仓库。

0-15 min：开场与共识 ​

讲师动作：

  1. 打开 培训总览。
  2. 说明课程不是“提示词技巧课”，而是“AI 进入团队交付流程后的工程化课”。
  3. 强调三件事：上下文、验收、审查。

讲师可用话术：

AI 编程让写代码的速度变快，但真正决定质量的是：它读到了什么上下文、你给了什么验收标准、团队如何审查它的输出。

互动问题：

  • 开发：你现在最常让 AI 做什么？
  • PM：你最担心 AI 交付带来什么风险？

15-45 min：从 0 配置 Markdown 文件 ​

跳转：标准化 MD 文件体系

IDE 操作：

  1. 优先解压所选工具和语言的 Markdown 资料包，得到 README.md、根规则文件和 docs/project/*.md。
  2. Codex 演示使用 AGENTS.md，Claude Code 演示使用 CLAUDE.md。
  3. 如果现场不用资料包，再按 标准化 MD 文件体系 的模板手动创建 README.md 和项目文档。

讲师重点：

  • README.md 给人和工具说明项目是什么。
  • AGENTS.md 给 Codex 和通用 agent 说明项目如何工作。
  • CLAUDE.md 给 Claude Code 项目记忆和约束。
  • 需求、验收、风险、测试、发布拆成独立文件，避免一个文件无限膨胀。

小练习：

让学员把一个模糊需求改写成三段：

  • 用户目标
  • 验收标准
  • 不做范围

45-80 min：Claude Code 从 0 到 1 ​

跳转：Claude Code 从 0 到 1

IDE 操作：

  1. 在项目根目录运行 claude。
  2. 运行 /init 或让 Claude 读取现有 CLAUDE.md。
  3. 用 /memory 检查项目记忆。
  4. 让 Claude 根据 requirements.md 生成实现计划。
  5. 要求 Claude 分步实现，先建最小可运行页面。
  6. 运行本地命令验证。
  7. 让 Claude 总结改动和风险。

讲师重点：

  • Claude Code 适合交互式推进、快速读项目、用 slash commands 控制会话。
  • CLAUDE.md 和 memory 能降低重复解释成本。
  • /permissions、hooks、MCP 和 subagents 是团队化使用的关键扩展点。

80-115 min：Codex 从 0 到 1 ​

跳转：Codex 从 0 到 1

IDE 操作：

  1. 打开 Codex 所在 IDE 或 Codex App。
  2. 确认仓库根目录有 AGENTS.md。
  3. 让 Codex 先分析文件结构和需求，不立刻改代码。
  4. 让 Codex 生成实现计划和验证命令。
  5. 允许 Codex 分步实现。
  6. 运行构建或测试。
  7. 要求 Codex 给出变更摘要、风险和下一步。

讲师重点：

  • Codex 更强调可验证的任务、沙箱权限、计划、构建和提交。
  • AGENTS.md 是 Codex 的项目工作协议。
  • 使用 Codex 时，PM 写清验收标准比写“请帮我做一个系统”更重要。

115-145 min：团队协作流 ​

跳转：团队角色分工

讲师动作：

  1. 画出从需求到发布的链路。
  2. 对比 Claude Code 和 Codex 产生的实现差异。
  3. 演示一次 AI code review 提示。
  4. 展示怎样把风险和测试补回 MD 文件。

建议流程：

text
需求草案 -> 验收标准 -> 设计上下文 -> AI 实现计划 -> 分步实现 -> 本地验证 -> 代码审查 -> 发布检查 -> 复盘更新 MD

145-170 min：PM 落地方法 ​

讲师重点：

  • PM 不需要会写代码，但需要会写 AI 可执行需求。
  • 好需求不是“做一个看板”，而是明确用户、动作、状态、异常、验收。
  • PM 要维护风险清单、范围边界、验收标准和版本节奏。

练习：

让 PM 把一个功能写成：

markdown
## 用户故事

作为项目经理，我希望按状态筛选任务，以便快速看到当前阻塞。

## 验收标准

- 可以按待处理、进行中、评审中、已完成筛选。
- 切换筛选不刷新页面。
- 没有结果时显示空状态。

## 不做范围

- 不做账号系统。
- 不做多人实时协作。

170-180 min：复盘 ​

讲师收束：

  1. Claude Code 与 Codex 都不是“替代流程”，而是进入流程。
  2. 标准化 MD 文件是团队和 AI 的共同上下文。
  3. 未来的竞争力在于：谁能更快把模糊目标变成可验证交付。

最后给出 培训检查表。