在 AI 编程日益普及的今天很多开发者发现一个矛盾现象AI 能快速生成代码但项目却容易陷入混乱。问题不在于 AI 的能力而在于我们如何使用它。Vibe Coding 作为一种 AI 结对编程工作流核心价值不是让 AI 从零发明更多代码而是通过系统化方法强制复用成熟方案用最少自研代码完成业务闭环。实际项目中常见的情况是开发者提出需求后AI 会倾向于重新实现功能而不是先搜索现有生态中的成熟解决方案。这导致项目积累大量重复造轮子的代码增加了维护成本和潜在风险。真正高效的 AI 编程应该是“拼好码”模式成熟能力解决通用问题胶水代码连接业务流程自研只服务真正不可替代的差异。1. 理解 Vibe Coding 的拼好码哲学1.1 什么是拼好码拼好码是 Vibe Coding 的工程交付形态核心思想是优先复用官方能力、平台服务、成熟库、稳定工具和事实标准。AI 的角色不是从零实现功能而是根据需求反向搜索现有生态评估候选方案的成熟度然后设计适配边界最后只编写必要的连接代码。与传统胶水编程相比拼好码更强调系统性评估和边界设计。它要求开发者在让 AI 开始编码前先完成以下判断这个需求是否已有成熟解决方案如果有多个候选哪个最适合当前项目需要编写多少胶水代码来连接这些成熟组件自研部分是否真的无法用现有方案替代1.2 为什么拼好码比从零生成更可靠从零生成的代码面临几个固有风险未经大规模测试、边界情况处理不完整、性能特征未知、文档和支持有限。而成熟方案通常已经过生产环境验证有明确的维护团队、版本规划和社区支持。举例来说如果需要实现用户认证功能拼好码的思路是先搜索主流认证方案Auth0、Firebase Auth、Passport.js、Spring Security评估每个方案的许可证、文档质量、生产案例、生态兼容性选择最适合项目技术栈和规模的方案只编写连接业务逻辑的适配层代码相比之下让 AI 从零实现认证系统即使代码看起来正确也难免遗漏安全漏洞、性能优化和边缘情况处理。2. 建立拼好码的工作流基础2.1 环境准备与工具链配置拼好码工作流需要一套标准化的工具来支持需求分析、方案搜索和代码生成。以下是推荐的基础环境操作系统与开发环境# 推荐使用 WSL2/Ubuntu 或 macOS 作为开发环境 # 验证系统环境 uname -a python3 --version # 需要 Python 3.8 node --version # 需要 Node.js 18 git --versionAI CLI 工具安装# Codex CLI 安装默认路线 curl -fsSL https://raw.githubusercontent.com/tradecatlabs/vibe-coding-cn/main/tools/config/.codex/install.sh | bash # 验证安装 codex --version codex auth login # 按照提示完成认证 # Claude Code 备选方案 npm install -g anthropic-ai/claude-code claude-code --version项目初始化结构my-project/ ├── memory-bank/ # 项目上下文存储 │ ├── requirements.md # 需求文档 │ ├── tech-stack.md # 技术栈选择 │ └── architecture.md # 架构设计 ├── implementation-plan.md # 实施计划 ├── progress.md # 进度记录 └── src/ # 源代码2.2 需求澄清与能力领域拆解在让 AI 开始编码前必须先用自然语言明确需求并拆解出对应的能力领域。这是拼好码流程的关键第一步。需求文档模板# 项目需求用户管理系统 ## 目标 - 用户注册、登录、权限管理 - 支持邮箱验证和密码重置 - 管理员后台用户管理界面 ## 输入输出 - 输入用户注册信息、登录凭证、管理操作 - 输出认证令牌、用户列表、操作结果 ## 约束条件 - 使用 Node.js Express 技术栈 - 数据库使用 PostgreSQL - 需要支持横向扩展 - 预算限制优先考虑开源方案 ## 验收标准 - 注册流程完整包含邮箱验证 - 登录成功返回 JWT token - 管理员可以查看和操作用户状态 - 有完整的 API 测试覆盖能力领域拆解提示词你是一个经验丰富的系统架构师。请基于上面的需求文档拆解出需要的能力领域并为每个领域搜索成熟的解决方案。 要求 1. 识别出这个项目需要的核心能力领域如用户认证、数据库ORM、API框架等 2. 为每个领域提供2-3个主流成熟方案 3. 每个方案要评估维护状态、许可证、文档质量、生产案例、生态兼容性 4. 给出最终的技术栈组合建议 输出格式 ## 能力领域拆解 ### 1. [领域名称] - **需求对应**[对应需求文档的哪部分] - **候选方案** - [方案A]评估结果... - [方案B]评估结果... - **推荐方案**[方案名称] 选择理由2.3 技术栈评估与选择收到 AI 的领域拆解后需要人工审查技术栈选择的合理性。以下是常见评估维度评估维度检查要点合格标准维护状态GitHub stars、最近提交、issue响应活跃维护最近3个月有更新许可证许可证类型、商业使用限制兼容项目需求的开源许可证文档质量快速开始指南、API文档、示例文档完整示例可运行生产案例知名公司使用、社区认可度有生产环境成功案例生态兼容与现有技术栈集成难度有现成的适配器或中间件技术栈决策记录示例# 技术栈决策记录 ## 用户认证领域 ### 候选方案 1. **Passport.js**Node.js 生态事实标准策略丰富文档完善 2. **Auth0**商业化方案功能完整但有成本限制 3. **Supertokens**开源替代自托管能力强大 ### 最终选择Passport.js JWT **理由** - 项目预算限制优先选择开源方案 - Passport.js 与 Express 集成无缝 - JWT 适合无状态API架构 - 社区支持强大遇到问题容易找到解决方案 ## 数据库ORM领域 ### 候选方案 1. **Prisma**类型安全迁移工具完善 2. **Sequelize**成熟稳定功能全面 3. **TypeORM**TypeScript友好装饰器语法 ### 最终选择Prisma **理由** - 类型安全减少运行时错误 - 迁移工具适合团队协作 - 与现有TypeScript技术栈契合度高3. 拼好码的核心实施流程3.1 实施计划生成有了明确的技术栈后让 AI 生成具体的实施计划。关键是要约束 AI 只写指令不写代码。实施计划生成提示词基于以下输入生成详细的实施计划 - 需求文档memory-bank/requirements.md - 技术栈决策memory-bank/tech-stack.md 要求 1. 将项目拆解为具体可执行步骤 2. 每个步骤要小而具体有明确的完成标准 3. 每个步骤必须包含验证正确性的测试方法 4. 严禁包含具体代码只写清晰的指令 5. 优先实现基础功能高级功能后续迭代 输出格式 ## 实施计划 ### 阶段1基础架构搭建 1. [步骤描述] - 操作内容[具体指令] - 验收标准[如何验证] - 测试方法[测试命令或检查点] ### 阶段2核心功能实现 ...生成的实施计划示例## 实施计划 ### 阶段1项目基础架构 1. **初始化项目结构** - 操作内容创建标准的Node.js项目结构配置package.json安装TypeScript和基础依赖 - 验收标准项目可以通过npm start启动TypeScript编译配置正确 - 测试方法运行npm run build确认无编译错误 2. **数据库连接配置** - 操作内容配置Prisma连接PostgreSQL生成初始schema和迁移文件 - 验收标准能够成功连接数据库执行基础查询 - 测试方法运行Prisma studio验证连接执行简单SELECT查询 ### 阶段2用户认证系统 3. **用户模型设计** - 操作内容设计User表结构包含必要字段和索引 - 验收标准Prisma schema定义完整支持基础CRUD操作 - 测试方法运行迁移验证模型方法正常工作 4. **Passport.js集成** - 操作内容配置Passport.js本地策略和JWT策略实现注册登录接口 - 验收标准能够完成用户注册、登录、token颁发流程 - 测试方法使用Postman测试认证接口验证token有效性3.2 分步执行与验证实施计划生成后进入具体的执行阶段。这里要严格遵循执行-验证-记录的循环。单步执行提示词模板阅读memory-bank中的所有文档然后执行实施计划的[步骤编号][步骤描述]。 要求 1. 先分析这个步骤需要完成哪些具体任务 2. 搜索相关的成熟库和最佳实践 3. 只编写必要的胶水代码优先使用现有解决方案 4. 完成后再我验证测试通过前不要开始下一步 5. 验证通过后更新progress.md记录工作内容 6. 将新的架构洞察添加到architecture.md中 当前上下文 - 项目路径/home/user/my-project - 技术栈Node.js Express Prisma Passport.js - 当前进度已完成步骤1-2正在执行步骤3执行过程中的关键检查点每个步骤完成后需要人工验证以下内容代码质量检查# 检查编译和语法 npm run build npm run lint # 运行基础测试 npm test功能验证检查# 启动开发服务器验证功能 npm start # 使用API测试工具验证接口 curl -X POST http://localhost:3000/api/auth/register \ -H Content-Type: application/json \ -d {email:testexample.com,password:password123}架构一致性检查新代码是否遵循已有的项目结构依赖引入是否必要且版本兼容配置项是否外部化便于不同环境部署3.3 进度记录与架构文档更新每个步骤验证通过后必须更新项目文档这是拼好码流程可持续的关键。progress.md 更新示例# 项目进度记录 ## 2024-01-15: 步骤3 - 用户模型设计完成 ### 完成内容 - 定义了User模型的基本字段id、email、passwordHash、createdAt等 - 添加了必要的数据库索引优化查询性能 - 配置了Prisma客户端生成和类型定义 ### 采用的技术决策 - 使用Prisma的unique约束确保email唯一性 - 密码使用bcrypt哈希存储安全性符合标准 - 时间戳使用ISO标准格式便于前端处理 ### 验证结果 - 数据库迁移执行成功 - 基础CRUD操作测试通过 - TypeScript类型检查无错误 ### 下一步准备 - 需要开始步骤4的Passport.js集成 - 需要配置环境变量管理敏感信息architecture.md 更新示例# 系统架构文档 ## 数据库层 ### User表结构 - src/prisma/schema.prisma主数据模型定义 - src/repositories/userRepository.ts数据访问层封装 - 使用Prisma Migrate管理schema变更 ## 认证层 - Passport.js策略配置在src/auth/strategies/ - JWT token生成和验证在src/auth/jwt.ts - 路由保护中间件在src/middleware/auth.ts ## 关键设计决策 - 认证逻辑与业务逻辑分离便于测试和维护 - 使用Repository模式抽象数据访问降低耦合度 - 错误处理统一在中间件中处理保持代码整洁4. 拼好码的常见问题与解决方案4.1 AI 倾向于重造轮子的问题这是拼好码流程中最常见的挑战。AI 可能会忽略现有方案试图从零实现功能。问题现象AI 建议自定义实现认证逻辑而不是使用Passport.js生成的数据访问代码直接使用数据库驱动而不是ORM重复实现常见的工具函数而不是引入现有库解决方案明确约束提示词重要约束这个项目已经决定使用[技术栈名称]作为[领域]的解决方案。请基于该方案进行集成和适配不要重新实现该领域的功能。 如果遇到集成问题优先搜索该方案的官方文档和社区解决方案而不是自己实现替代方案。上下文强化确保memory-bank中的技术栈决策文档被标记为Always规则让AI在每次交互前都必须重新确认技术选型。分步审查在AI生成代码前要求其先提供实现方案概述人工确认没有重复造轮子后再允许执行。4.2 成熟方案评估困难对于经验不足的开发者判断哪个方案更成熟可能存在困难。评估清单评估项目具体检查方法通过标准社区活跃度GitHub stars数量、最近提交频率、贡献者数量stars 1k月均有更新文档完整性快速开始指南、API文档、示例项目、故障排除文档结构清晰示例可运行生产就绪度知名公司使用案例、版本号、发布周期有v1.0版本知名公司使用维护可持续性核心团队规模、赞助情况、问题响应时间有活跃维护团队issue及时响应生态完整性插件系统、扩展库、社区工具有丰富的第三方扩展当不确定时的保守策略选择最流行、文档最完善的方案查看方案在类似项目中的使用案例优先选择有商业支持或大型公司背书的方案避免使用过于新颖但未经充分测试的技术4.3 胶水代码复杂度控制拼好码模式中胶水代码的质量直接决定项目的可维护性。胶水代码设计原则// 不好的胶水代码职责混乱直接耦合 export class UserService { constructor() { this.passport require(passport); this.jwt require(jsonwebtoken); this.bcrypt require(bcrypt); // 直接混入各种库的调用 } } // 好的胶水代码清晰分层单一职责 export class AuthService { constructor( private userRepository: UserRepository, private tokenService: TokenService, private cryptoService: CryptoService ) {} // 每个方法只做一件事依赖注入而不是直接引用 async register(userData: CreateUserDto): PromiseAuthResult { const user await this.userRepository.create(userData); const token this.tokenService.generateToken(user); return { user, token }; } }胶水代码审查清单[ ] 每个类/模块是否只承担一个清晰职责[ ] 外部依赖是否通过接口抽象[ ] 配置信息是否外部化[ ] 错误处理是否统一且完整[ ] 是否有完整的类型定义[ ] 测试是否覆盖主要业务逻辑5. 拼好码的高级模式与扩展5.1 多方案组合与适配器模式复杂项目中经常需要组合多个成熟方案这时适配器模式就变得很重要。多数据库支持示例// 定义统一的数据库接口 interface DatabaseAdapter { connect(config: DbConfig): Promisevoid; queryT(sql: string, params?: any[]): PromiseT[]; close(): Promisevoid; } // PostgreSQL适配器 class PostgresAdapter implements DatabaseAdapter { private client: pg.Client; async connect(config: DbConfig) { this.client new pg.Client(config); await this.client.connect(); } async queryT(sql: string, params?: any[]): PromiseT[] { const result await this.client.query(sql, params); return result.rows as T[]; } } // MySQL适配器 class MysqlAdapter implements DatabaseAdapter { private connection: mysql.Connection; async connect(config: DbConfig) { this.connection await mysql.createConnection(config); await this.connection.connect(); } async queryT(sql: string, params?: any[]): PromiseT[] { const [rows] await this.connection.execute(sql, params); return rows as T[]; } } // 业务代码只依赖抽象接口 class UserRepository { constructor(private db: DatabaseAdapter) {} async findById(id: string): PromiseUser { const users await this.db.queryUser( SELECT * FROM users WHERE id ?, [id] ); return users[0]; } }5.2 自动化方案发现与评估随着项目规模扩大可以建立自动化的方案发现和评估流程。方案发现提示词模板你是一个技术选型专家。基于以下项目需求帮我发现和评估可用的成熟方案。 项目背景 - 项目类型[Web应用/移动应用/后端服务等] - 技术栈[当前使用的技术栈] - 具体需求[需要解决的具体问题] - 约束条件[性能、成本、许可证等限制] 请按以下格式输出 ## 方案发现报告 ### 需求分析 [简要分析这个需求的核心挑战和关键要求] ### 候选方案 #### 方案1: [方案名称] - **成熟度评估**: [高/中/低] - **核心优势**: [主要优点] - **潜在风险**: [需要注意的问题] - **集成成本**: [估算的工作量] - **推荐指数**: [1-5星] #### 方案2: [方案名称] ... ### 综合建议 [基于项目背景给出最终建议]5.3 拼好码的质量门禁体系为确保拼好码流程产出高质量代码需要建立严格的质量门禁。代码质量门禁配置# .github/workflows/quality-gate.yml name: Quality Gate on: [push, pull_request] jobs: code-quality: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: Setup Node.js uses: actions/setup-nodev4 with: node-version: 18 - name: Install dependencies run: npm ci - name: TypeScript compilation check run: npm run build - name: Lint check run: npm run lint - name: Test coverage run: npm run test:coverage - name: Security audit run: npm audit --audit-level moderate - name: Dependency license check uses: fossa-contrib/fossa-actionv2 with: api-key: ${{ secrets.FOSSA_API_KEY }}拼好码专用检查清单# 拼好码质量检查清单 ## 方案选择合理性 - [ ] 选择的方案是否经过充分评估 - [ ] 是否有更简单或更成熟的替代方案 - [ ] 方案的技术债务是否可接受 ## 集成质量 - [ ] 胶水代码是否遵循单一职责原则 - [ ] 配置是否外部化且环境隔离 - [ ] 错误处理是否完整且一致 ## 可维护性 - [ ] 文档是否更新反映最新架构 - [ ] 测试是否覆盖主要集成点 - [ ] 回滚方案是否明确且测试过拼好码的核心价值在于认识到大多数软件工程问题已经有经过验证的解决方案。AI 编程的真正优势不是生成更多代码而是快速识别和集成这些成熟方案。通过建立系统化的拼好码工作流开发者可以大幅提升开发效率降低项目风险同时保证代码质量。在实际项目中拼好码思维需要成为团队的文化。每次遇到新需求时第一反应应该是这个问题很可能已经有现成方案而不是让AI帮我们实现一个。这种思维转变结合系统化的评估和执行流程是高效AI编程的关键。