Vibe-Coding完全指南（下）：工程化落地与行动清单

这是vibe-coding完全指南的下篇。上篇讲了Boris的黄金三法则和Prompt模板，这篇深入工程化落地。 

📚 上篇回顾：黄金三法则（别微操/上下文>50%压缩/CLAUDE.md<200行）+ 5个Prompt模板

❺深挖：CLAUDE.md配置工程

 CLAUDE.md是vibe-coding的上下文工程基石。Boris强调：这不是知识库，而是行为守则。 

⚠️ 硬性约束：必须控制在200行以内！超过后Claude会忽略关键规则，进入"变蠢区间"。   

标准CLAUDE.md模板（可直接复制）：

# CLAUDE.md —— 控制在200行以内！     ## 强制规则   1. 写任何代码前必须完整阅读 architecture.md   2. 禁止单体巨文件（monolith），必须模块化   3. 每完成一个功能后更新 progress.md  ## 项目上下文 - 技术栈：Next.js + TypeScript + Prisma - 架构：模块分离，API/前端/数据库层清晰 - 目标用户：连锁零售门店运营人员  ## 命令速查 - 运行测试：npm test - 数据库迁移：npx prisma migrate dev - 代码检查：npm run lint  ## 约束条件 - 所有API响应必须符合统一格式 - 错误处理必须包含logger记录 - 不要假设字段存在，做好空值检查 

关键技巧：用标签包裹关键规则，防止文件膨胀时被稀释。 

多文件拆分策略：如果200行不够，用大目录拆分 

.claude/ ├── CLAUDE.md              # 入口文件（<200行） ├── rules/ │   ├── coding-style.md    # 代码风格规范 │   ├── testing.md         # 测试要求 │   └── security.md        # 安全约束 ├── commands/              # 自定义命令 │   ├── techdebt.md │   └── refactor.md └── skills/                # 技能库     ├── auth-setup/     └── db-migration/ 

❻Memory Bank架构：让AI记住一切

 来自GitHub 11.7K Star项目实战，这套Memory Bank架构解决了"上下文丢失"问题。 

完整目录结构：

project-root/ ├── memory-bank/                    # 记忆库（核心） │   ├── @architecture.md            # 架构文档（强制先读，@表示关键） │   ├── @product-requirement.md     # PRD（强制先读） │   ├── tech-stack.md               # 技术栈说明 │   ├── implementation-plan.md      # 实施计划（分步骤指令） │   ├── progress.md                 # 进度记录（0/1验收） │   └── gotchas.md                  # 踩坑记录（关键！） │ ├── .claude/                        # Claude配置 │   ├── CLAUDE.md                   # 入口文件 │   ├── commands/                   # 自定义命令 │   ├── skills/                     # 技能库 │   └── hooks/                      # 钩子 │ └── src/                            # 源代码 

各文件作用详解：

文件

用途

更新频率

@architecture.md

系统架构、文件职责、依赖关系

架构变更时

@product-requirement.md

产品需求、用户故事、验收标准

需求变更时

implementation-plan.md

分阶段实施计划，每步包含验收测试

每周初规划

progress.md

已完成步骤，0/1验收记录

每完成一步

gotchas.md

踩坑记录、历史失败点、解决方案

每次踩坑后

progress.md格式（可审计）：

# 项目进度  ## 阶段1：基础架构 ✅ - [x] 项目初始化（验收：npm run dev成功） - [x] 数据库设计（验收：prisma migrate成功） - [x] 基础API（验收：/health返回200）  ## 阶段2：核心功能 🔄 - [ ] 用户认证（当前） - [ ] 权限管理 - [ ] 数据CRUD  ## 踩坑记录 - 2026-04-17: Next.js 14 App Router需特殊配置 - 2026-04-16: Prisma migrate前必须先docker-compose up 

❼函数式思维：vibe-coding的底层逻辑

 Boris在访谈中提到"函数式编程优雅"，这不是空话。vibe-coding的架构设计充分体现了函数式编程思想： 

函数式概念

vibe-coding实践

纯函数

context: fork

 隔离子代理运行，无副作用污染主上下文

组合

嵌入脚本/库让Claude组合（compose）而非重构（rebuild）

声明式

description字段声明"何时触发"，而非"怎么做"

副作用隔离

/sandbox

 隔离文件网络，安全边界设计

不可变

/rewind

 回滚而非继续修复，保持代码库整洁

单一职责

功能特定子代理（特征专属），而非泛化角色如"QA"

 理解这层对应关系，你就明白为什么Boris说"函数式编程、思维和类型就是如此优雅"——vibe-coding不是随意发挥，而是有严谨的工程哲学支撑。 

❽给你的行动清单

 我是虾哥，不是程序员。这套方法论我自己也在用，分三个阶段给你： 

📍 今天（30分钟）     1. 选一个正在做的项目，创建 CLAUDE.md（不超过200行）     2. 创建 memory-bank/ 目录，写入 @architecture.md     3. 下次遇到bug，只发错误信息+说"fix"，不加微操   

📍 本周（2小时）     4. 把一个重复操作转成 .claude/commands/ 命令     5. 用 tmux + git worktrees 尝试并行代理     6. 建立 gotchas.md 记录AI犯的错误   

📍 本月（1天）     7. 建立完整的 Memory Bank 架构     8. 配置 Hooks 自动化（代码格式化、权限控制）     9. 形成团队/个人的 vibe-coding SOP   

✅ 一句话总结：vibe-coding = 信任AI + 管理上下文 + 函数式思维 + 声明式自动化。掌握这四点，你就从"用AI的人"变成了"指挥AI的人"。   

 这两篇文章整理了Wired原版访谈、Boris 69条最佳实践、GitHub 11.7K Star中文指南的精华。如果你觉得有用，转给同事，一起上车！ 

📌 互动话题：你开始用vibe-coding了吗？遇到最大的阻力是什么？     在评论区聊聊，点赞最高的送《Claude Code 69条最佳实践》完整PDF！   

#VibeCoding#ClaudeCode#AI编程#方法论