| name | vibe-to-agentic-framework |
| description | 演示文稿背后的概念框架 —— "从 Vibe Coding 到 Agentic Engineering"的含义、旅程为何如此结构化，以及每张幻灯片如何契合叙事弧线 |
"从 Vibe Coding 到 Agentic Engineering"框架
本技能教授演示文稿背后的概念模型。每张幻灯片和每个章节都在讲述一个故事：开发者如何从无结构的"vibe coding"（低级）逐步进阶到高级的 agentic engineering（高级）。
核心概念
Vibe Coding（低级） 是指开发者在没有任何结构的情况下使用 CodeBuddy Code —— 没有项目上下文、没有约定、没有可复用的知识。每次提示都像抛硬币一样。Claude 可能会创建随机的端点、忽略现有模式、跳过测试，并生成不一致的代码。代码库在每次交互中都趋向混乱。
Agentic Engineering（高级） 是指 CodeBuddy Code 作为一个完全配置的工程系统运行。它了解项目架构（CODEBUDDY.md）、遵循作用域约定（Rules）、按需加载领域专业知识（Skills）、委派给专业工作者（Agents）、编排多步骤工作流（Commands）、自动化生命周期事件（Hooks），并连接外部工具（MCP Servers）。每次提示都能产生一致的、经过测试的、生产就绪的代码。
这两个极端之间的旅程是渐进且累积的。每个最佳实践都建立在前一个之上，演示文稿按照开发者应采用的顺序来教授它们。
4 级旅程系统
演示文稿使用 4 级评分系统，而非百分比进度条：
| 级别 | 顺序 | 颜色 | 旅程条高度 | 描述 |
|---|
| Low | 1 | 红/橙色 (hsl(0, 70%, 45%)) | 25% | Vibe coding 地带 —— 无结构 |
| Medium | 2 | 黄色 (hsl(40, 70%, 45%)) | 50% | 结构化工作流，部分自动化 |
| High | 3 | 浅绿色 (hsl(80, 70%, 45%)) | 75% | 领域知识、Skills、自定义 Agents |
| Pro | 4 | 深绿色 (hsl(120, 70%, 45%)) | 100% | 完全的 agentic engineering，多代理团队 |
旅程条在第 1 张幻灯片（标题幻灯片）上隐藏，从第 2 张幻灯片开始显示。级别通过关键过渡幻灯片上的 data-level 属性设置，并被后续幻灯片继承，直到下一次级别变更。当级别变更时，.level-badge 通过 JS 注入到幻灯片的 h1 上（不要在 HTML 中硬编码这些）。
贯穿示例：TodoApp Monorepo
每项技术都在一个真实的全栈项目上进行演示。演示文稿展示了从普通项目（vibe coding）到具有完整 CodeBuddy Code 配置（agentic engineering）的项目的转变：
改造前（Vibe Coding）：
todoapp/
├── backend/ # FastAPI (Python)
│ ├── main.py
│ ├── routes/
│ ├── models/
│ └── tests/
└── frontend/ # Next.js (TypeScript)
├── components/
├── pages/
└── lib/
改造后（Agentic Engineering）：
todoapp/
├── .codebuddy/ # CodeBuddy Code 配置
│ ├── agents/ # 自定义 Subagents
│ ├── skills/ # 领域知识
│ ├── commands/ # Slash Commands
│ ├── hooks/ # 生命周期脚本
│ ├── rules/ # 模块化指令
│ ├── settings.json # 团队设置
│ └── settings.local.json # 个人设置
├── backend/
│ └── CODEBUDDY.md # 后端指令
├── frontend/
│ └── CODEBUDDY.md # 前端指令
├── .mcp.json # 托管的 MCP 服务器
└── CODEBUDDY.md # 项目指令
为什么选择 TodoApp？ 它足够小，可以在幻灯片上展示，但又足够复杂，能演示真实问题：一个具有路由模式和测试约定的后端，一个具有组件层次结构和设计令牌的前端，以及一个 monorepo 结构，其中跨领域关注点（如添加新功能）需要两侧协调。
TodoApp 使 vibe coding 问题变得具体：没有结构时，要求 Claude "添加笔记功能"会产生一个随机的 /api/notes 端点，不遵循 routes/todos.py 的模式，一个没有侧边栏导航的独立页面，以及零测试。有了完整的 agentic 设置，相同的请求会产生遵循现有模式的路由、集成到侧边栏的页面，以及匹配 test_todos.py 风格的测试。
旅程弧线：为什么是这个顺序
演示文稿遵循一个刻意设计的教学序列。每个章节解锁一个新的能力层：
第 0 部分：介绍（幻灯片 1-4，无权重）
目的： 铺垫。介绍 TodoApp，定义 vibe coding，并展示目标。
- 标题幻灯片建立旅程隐喻
- 示例项目展示转变：TodoApp 的前后对比 —— 普通项目结构 vs 具有完整 CodeBuddy Code 配置（.codebuddy/、CODEBUDDY.md、.mcp.json 等）的项目
- "什么是 Vibe Coding？"建立 0% 基线 —— 痛点
- 旅程地图提供一个可点击的目录，展示前方的完整路径
第 1 部分：前置准备（幻灯片 5-9，无权重）
目的： 安装并运行 CodeBuddy Code。这纯粹是后勤工作 —— 还没有工程实践。
- 安装、认证、第一次会话、界面概述
- 无权重，因为知道如何安装工具并不能提高代码质量
- "第一次会话"本身就是 vibe coding —— 这是有意为之的，让开发者亲身体验 0% 的状态
第 2 部分：更好的提示（幻灯片 10-17，级别：Low）
目的： 第一个真正的改进。即使没有任何项目配置，更好的输入也能产生更好的输出。
- 好提示 vs 坏提示： 具体、有范围的提示 vs 模糊的请求。最简单的改进。
- 提供上下文： 使用
@files 给 Claude 它需要的代码。立即减少幻觉。
- 上下文窗口与 /compact： 理解有限的上下文窗口可以防止长会话中响应质量下降。
- Plan Mode：
/plan 强制在编码前思考。防止在错误方案上浪费精力。
为什么是 Low 级别： 提示是基础但有限的。它改善单次交互但不会创建持久的项目知识。每次会话都从零开始。
第 3 部分：项目记忆（幻灯片 18-24，级别：Medium）
目的： 从会话级知识到项目级知识的飞跃。Claude 现在可以跨会话记忆。
- CODEBUDDY.md 与 /init： 项目的"面向 Claude 的 README"。建立架构、技术栈和约定。这是最具影响力的单个文件。
- 应包含什么： 编写有效 CODEBUDDY.md 内容的实用指南（保持在 150 行以内，聚焦 Claude 需要知道的内容）。
- Rules：
.codebuddy/rules/ 中的路径作用域约定。Rules 是乘数 —— 它们自动应用于每个匹配的文件，无需开发者额外努力就能强制一致性。一个 backend-testing.md 规则就能确保每个测试永远遵循相同的模式。
为什么是 Medium 级别： 项目记忆将 Claude 从无状态工具转变为上下文感知的协作者。但仅有知识并不能创建工作流。
第 4 部分：结构化工作流（幻灯片 25-28，级别：Medium）
目的： 防止浪费精力并提高执行质量的系统方法。
- 任务列表： 将复杂工作分解为可追踪的步骤。防止范围蔓延并确保完整性。
- 模型选择： 选择合适的模型（Opus 用于架构，Sonnet 用于实现，Haiku 用于快速任务）优化成本和质量。
为什么仍然是 Medium 级别： 工作流很重要但概念相对简单。它们建立在第 3 部分的项目记忆之上，并更系统地使用它。跃升到 High 需要领域知识。
第 5 部分：领域知识（幻灯片 29-33，级别：High）
目的： 可复用的、按需的专业知识。Skills 是静态记忆（CODEBUDDY.md/Rules）和动态 Agents 之间的桥梁。
- 什么是 Skills： Skills 作为打包的领域知识，Claude 在相关时加载。渐进式披露的概念。
- 创建 Skills： 实操：为 TodoApp 构建一个
frontend-conventions 技能，教授 Tailwind 令牌、组件模式和侧边栏集成。
- Skills Frontmatter 与调用： 技术细节：YAML frontmatter、手动 vs 自动发现调用、
context: fork 选项。
为什么是 High 级别： Skills 是第一个"乘数"概念 —— 一个技能定义改善其领域内的每次未来交互。但 Skills 是被动知识；它们需要 Agents 才能变得主动。
第 6 部分：Agentic Engineering（幻灯片 34-46，级别：High）
目的： 本演示文稿涵盖的目标。自主的、专业的 Agents 协调构建端到端功能。
- 什么是 Agents： 具有受限工具和预加载 Skills 的专业 Subagents 的概念。
- 前端工程师 Agent： 一个具体的 Agent，使用 TodoApp 的前端约定、将路由添加到侧边栏、遵循设计令牌。前后对比展示转变。
- 后端工程师 Agent： 后端的并行 Agent —— 遵循 FastAPI 路由模式、SQLAlchemy 模型、编写匹配现有风格的测试。
- Commands 与编排： 压轴模式：Command → Agent → Skills。一个
/add-feature 命令协调前端 + 后端 Agents，每个都有自己的 Skills，交付完整的功能。这是架构的巅峰。
- Hooks 与 MCP： 生命周期自动化（预提交检查、声音通知）和外部工具集成。最后的自动化层。
- Command → Agent → Skills： 完整的架构图。展示所有组件如何连接：Commands 调用 Agents，Agents 加载 Skills，Skills 提供知识。这是"High level"的理解幻灯片。
为什么是 High 级别： 本节涵盖本演示文稿中教授的最高价值实践。之前的一切都是为此做准备。编排和 agentic 工作流代表了本课程涵盖的天花板 —— 完整的 Pro（多代理团队、高级编排模式）超出了本演示文稿的范围。
High Level 幻灯片（幻灯片 44）
庆祝时刻。展示完整的 TodoApp 配置：
- CODEBUDDY.md 用于项目上下文
- Rules 用于路径作用域约定
- Skills 用于领域知识
- Agents 用于一致执行
- Commands 用于编排工作流
- Hooks 用于生命周期自动化
- MCP 服务器用于外部工具
附录（幻灯片 47+，无权重）
目的： 参考材料。每个命令、设置和配置选项。无权重，因为这些是参考查询，不是旅程里程碑。包括：工具使用、所有 Slash Commands、提交/PR 工作流、自定义选项、调试技巧和黄金法则。
编辑幻灯片时如何使用此框架
创建或修改幻灯片时，考虑：
-
这个概念在旅程中的位置？ 关于"提示中更好的错误消息"的幻灯片属于第 2 部分（提示，Low 级别）。关于"Agent 记忆作用域"的幻灯片属于第 6 部分（agentic，High 级别）。
-
前后对比是什么？ 每张重要幻灯片都应该隐式或显式地展示对比：在 Low 级别（vibe coding）时会发生什么 vs 使用此技术后会发生什么。使用 TodoApp 使其具体化。
-
级别分配是否合理？ 级别转换发生在 Part 章节边界。章节内的单张幻灯片继承该章节的级别。
-
是否建立在之前的基础上？ Skills 假设开发者已经了解 CODEBUDDY.md 和 Rules。Agents 假设他们了解 Skills。Commands 假设他们了解 Agents。不要在概念所属章节之前引用它。
-
使用 TodoApp。 抽象的解释会让观众失去兴趣。展示实际的 routes/todos.py 代码、实际的 Sidebar.tsx 组件、实际的 CODEBUDDY.md 内容。贯穿示例是使框架具体化的关键。
级别转换参考表
| 幻灯片 | 幻灯片名称 | data-level | 级别标签 |
|---|
| 10 | Better Prompting（章节分隔符） | data-level="low" | Low |
| 18 | Project Memory（章节分隔符） | data-level="medium" | Medium |
| 29 | Domain Knowledge（章节分隔符） | data-level="high" | High |
| 34 | Agentic Engineering（章节分隔符） | data-level="high" | High |
所有其他幻灯片继承在其之前设置的最后一个 data-level 属性的级别。幻灯片 1-9（介绍 + 前置准备）没有级别，旅程条保持隐藏，直到第 2 张幻灯片显示"Low"（幻灯片 2-9 位于第 10 张幻灯片的第一次级别转换之前，因此旅程条在第 10 张幻灯片之前显示为空/零）。
注意： 主演示文稿（presentation/index.html）最高到 High 级别 —— 不使用 data-level="pro"。Pro 标记在旅程条上作为理论天花板保持可见，但填充永远不会到达它。视频演示文稿（1-video-workflow.html）最高到 Medium 级别。
