Vibe Coding 使用指南

用户提问Q: 怎么去进行规划驱动 上下文固定 AI结对执行怎么使用方法论文档和最佳实践怎么去使用大量AI提示词怎么去使用技能库怎么去使用项目模板和工具详细解答一、如何进行规划驱动 上下文固定 AI结对执行1. 规划驱动Planning-Driven核心理念先规划再编码避免 AI 失控实施步骤Step 1: 创建 Memory Bankmkdirmy-projectcdmy-projectmkdirmemory-bankStep 2: 生成核心文档product-requirements.md- 产品需求文档tech-stack.md- 技术栈选型implementation-plan.md- 实施计划最重要progress.md- 进度记录architecture.md- 架构说明Step 3: 人工审查仔细审查每个文档确保实施计划的每一步都清晰可执行修改不合理的地方关键原则✅ 实施计划要拆分成小步骤每步 1小时✅ 每步都要有验证标准✅ 严禁在计划中写代码❌ 不要让 AI 自主规划会失控2. 上下文固定Context Anchoring核心理念通过固定的上下文文件确保 AI 始终知道项目约束实施步骤Step 1: 创建 CLAUDE.md# 项目上下文文件 ## 项目概述 [项目简介] ## 核心约束 - 必须遵守的规则 - 技术限制 - 代码规范 ## 禁止的行为 - 不要添加未要求的功能 - 不要过度设计 - 不要修改核心架构 ## 开发流程 每次开始工作时使用的提示词模板 ## API 设计 [API 规范] ## 数据模型 [数据库设计] ## 当前状态 [项目进度]Step 2: 每次开始工作时的标准提示词阅读 /memory-bank 所有文档然后执行实施计划的第 X 步。 我会负责跑测试。在我验证测试通过前不要开始第 X1 步。 验证通过后更新 progress.md 和 architecture.md。关键原则✅ 上下文文件要简洁明确✅ 明确能做什么和不能做什么✅ 每次新会话都要重新加载上下文3. AI 结对执行AI Pair Programming核心理念人机协作人负责验证AI 负责实现工作流程1. 读取上下文 → 2. 执行一步 → 3. 人工验证 → 4. Git 提交 → 5. 新会话 → 重复详细步骤Step 1: 启动会话# 在 Claude Code 或其他 AI 工具中 阅读 memory-bank 所有文档执行实施计划第 1 步Step 2: AI 执行AI 读取文档AI 实现代码AI 说明完成了什么Step 3: 人工验证# 运行测试npmtest# 手动测试npmrun dev# 访问 http://localhost:3000 验证功能Step 4: 提交代码gitadd.gitcommit-m完成实施计划第 1 步项目基础设置Step 5: 新建会话关闭当前会话开启新会话重新加载上下文继续下一步关键原则✅ 一次只做一步✅ 每步都要验证✅ 频繁切换会话避免上下文污染❌ 不要让 AI 连续执行多步二、如何使用方法论文档和最佳实践1. 开发经验文档位置i18n/zh/documents/Methodology and Principles/开发经验.md核心内容变量命名规范文件结构规范编码规范单一职责、DRY、KISS系统架构原则程序设计核心思想使用方法1. 项目开始前阅读开发经验文档 2. 将核心原则写入 CLAUDE.md 3. 在实施计划中引用这些原则示例# CLAUDE.md ## 代码规范 - 遵循 PEP 8Python - 函数名使用小写下划线 - 类名使用大驼峰 - 单一职责原则 - DRY 原则不要重复 - KISS 原则保持简单2. 项目架构模板位置i18n/zh/documents/Templates and Resources/通用项目架构模板.md包含的模板Python Web/API 项目数据科学/量化项目Monorepo多项目仓库Full-Stack Web 应用使用方法# 1. 选择合适的模板# 2. 复制目录结构mkdir-psrc/{core,api,data}tests docs scripts# 3. 创建必要文件touchrequirements.txt .gitignore README.md三、如何使用大量 AI 提示词1. 提示词库位置目录结构i18n/zh/prompts/ ├── coding_prompts/ # 编程相关提示词40 个 ├── system_prompts/ # 系统级提示词 ├── assistant_prompts/ # 辅助提示词 └── user_prompts/ # 用户提示词2. 核心提示词推荐需求分析阶段项目上下文文档生成.md- 生成项目文档智能需求理解与研发导航引擎.md- 需求分析设计阶段系统架构.md- 架构设计系统架构可视化生成Mermaid.md- 生成架构图开发阶段高质量代码开发专家.md- 代码生成规范代码重构.md- 代码重构指导文档阶段AI生成代码文档-通用提示词模板.md- 生成文档精华技术文档生成提示词.md- 技术文档3. 使用方法方法 1直接复制1. 打开提示词文件 2. 复制内容 3. 粘贴到 AI 对话框 4. 根据项目调整参数方法 2在线表格1. 访问 Google Sheets 提示词库 2. 搜索需要的提示词 3. 直接复制使用方法 3集成到项目# CLAUDE.md ## 开发规范 [粘贴高质量代码开发专家.md的核心内容] ## 架构原则 [粘贴系统架构.md的核心原则]四、如何使用技能库Skills1. 技能库位置目录i18n/zh/skills/可用技能claude-skills/- 元技能生成其他技能ccxt/- 加密货币交易postgresql/- 数据库操作telegram-dev/- Telegram 机器人开发等等…2. 技能的结构每个技能包含skill-name/ ├── SKILL.md # 技能定义 ├── references/ # 参考文档 └── examples/ # 示例代码3. 使用方法Step 1: 查看技能说明cati18n/zh/skills/postgresql/SKILL.mdStep 2: 集成到项目# CLAUDE.md ## 技能集成 ### PostgreSQL 技能 [粘贴 SKILL.md 的核心内容] AI 现在具备以下能力 - 数据库设计 - SQL 查询优化 - 索引设计 - 等等...Step 3: 使用技能# 在 AI 对话中 基于 PostgreSQL 技能帮我设计用户表的数据库结构4. 生成新技能使用元技能1. 读取 i18n/zh/skills/claude-skills/SKILL.md 2. 使用元技能生成新的技能定义 3. 保存为新的 SKILL.md五、如何使用项目模板和工具1. 通用项目架构模板使用步骤Step 1: 选择模板根据项目类型选择 - Python Web/API 项目 - 数据科学项目 - Monorepo - Full-Stack 应用Step 2: 创建目录结构# Python Web 项目示例mkdir-psrc/{core,api,data,external}mkdir-ptests/{unit,integration}mkdir-pdocs scripts logsStep 3: 创建配置文件# 创建必要文件touchrequirements.txttouch.gitignoretouch.env.exampletouchREADME.mdtouchCLAUDE.mdStep 4: 填充模板内容# src/__init__.py# src/main.py# src/config.py# 等等...2. 提示词转换工具位置libs/external/prompts-library/功能Excel ↔ Markdown 互转使用方法cdlibs/external/prompts-library python main.py3. 备份工具位置backups/使用方法# 一键备份./backups/一键备份.sh# 快速备份python backups/快速备份.py六、完整工作流程示例场景创建一个博客应用Phase 1: 规划1小时1. 使用提示词生成 PRD 2. 使用提示词生成技术栈文档 3. 使用提示词生成实施计划 4. 人工审查和修改所有文档Phase 2: 设置30分钟1. 创建项目目录结构 2. 创建 CLAUDE.md 3. 创建基础配置文件 4. Git 初始化Phase 3: 开发迭代每个迭代 1. 新建 AI 会话 2. 加载上下文阅读 memory-bank执行第 X 步 3. AI 实现代码 4. 人工验证测试 5. Git 提交 6. 更新 progress.md 7. 重复Phase 4: 完成1. 所有步骤完成 2. 最终测试 3. 生成文档 4. 部署七、常见问题Q1: 如何避免 AI 过度设计A:在 CLAUDE.md 中明确禁止过度设计实施计划要具体不给 AI 发挥空间每步验证时检查是否添加了不必要的功能Q2: 如何处理 AI 生成的错误代码A:立即停止使用 Git 回退修改提示词重新生成或者人工修复Q3: 如何管理多个项目A:每个项目独立的 memory-bank使用统一的 CLAUDE.md 模板共享提示词库和技能库八、最佳实践总结核心原则规划优先- 先规划再编码上下文固定- 通过文档固定约束小步迭代- 一次只做一步频繁验证- 每步都要测试新建会话- 避免上下文污染工作习惯✅ 每天开始前读一遍 memory-bank✅ 每步完成后更新 progress.md✅ 遇到问题立即停止不要让 AI 继续✅ 定期备份代码✅ 使用 Git 管理版本避免的陷阱❌ 不要让 AI 连续执行多步❌ 不要跳过人工验证❌ 不要在没有规划的情况下开始编码❌ 不要忽视 AI 的警告和建议❌ 不要过度依赖 AI要保持思考