---
## 🖼️ 概览
**Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。
> **核心理念**: *规划就是一切。* 谨慎让 AI 自主规划，否则你的代码库会变成一团无法管理的乱麻。
PS：下面的经验并非通用，具体实践中要分场景，辩证的看
## 🧭 道
* **凡是 ai 能做的，就不要人工做**
* **一切问题问 ai**
* **目的主导：开发过程中的一切动作围绕"目的"展开**
* **上下文是 vibe coding 的第一性要素，垃圾进，垃圾出**
* **系统性思考，实体，链接，功能/目的，三个维度**
* **数据与函数即是编程的一切**
* **输入，处理，输出刻画整个过程**
* **多问 ai 是什么？，为什么？，怎么做？**
* **先结构，后代码，一定要规划好框架，不然后面技术债还不完**
* **奥卡姆剃刀定理，如无必要，勿增代码**
* **帕累托法则，关注重要的那20%**
* **逆向思考，先明确你的需求，从需求逆向构建代码**
* **重复，多试几次，实在不行重新开个窗口，**
* **专注，极致的专注可以击穿代码，一次只做一件事（神人除外）**
## 🧩 法
* **一句话目标 + 非目标**
* **正交性，功能不要太重复了，（这个分场景）**
* **能抄不写，不重复造轮子，先问 ai 有没有合适的仓库，下载下来改**
* **一定要看官方文档，先把官方文档爬下来喂给 ai**
* **按职责拆模块**
* **接口先行，实现后补**
* **一次只改一个模块**
* **文档即上下文，不是事后补**
## 🛠️ 术
* 明确写清：**能改什么，不能改什么**
* Debug 只给：**预期 vs 实际 + 最小复现**
* 测试可交给 AI，**断言人审**
* 代码一多就**切会话**
## 📋 器
- [**微软大战代码**](https://code.visualstudio.com/)，集成开发环境，初学者地基，你可以在这里手动修改和方便的阅读代码，cursor 更简单直观适合新手，插件现在应该只推荐一个就是 Local History
- **虚拟环境.venv**，有了这个再也不用装环境了，直接命令 ai 必须安装和全程使用虚拟环境（.venv）（记得写入你的AGENTS或者CLAUDE的md文件的记忆里面）就行了，一键配置好再也不用浪费时间配环境了，主要是适用于 python
- [**Claude Opus 4.5**](https://claude.ai/new)，在 Claude Code 中使用，很贵，但是尼区 iOS 订阅要便宜几百人民币，快 + 效果好，顶中顶，有 CLI 和 IDE 插件
- [**gpt-5.1-codex.1-codex (xhigh)**](https://chatgpt.com/codex/)，在 Codex CLI 中使用，顶中顶，除了慢其他没得挑，大项目复杂逻辑唯一解，买 ChatGPT 会员就能用，有 CLI 和 IDE 插件
- [**Droid**](https://factory.ai/news/terminal-bench)，这里面的 Claude Opus 4.5 体感比 Claude Code 原生还强，顶，有 CLI
- [**Kiro**](https://kiro.dev/)，这里面的 Claude Opus 4.5 目前免费，就是 CLI 看不到正在运行的情况，没有找到恢复对话，有客户端和 CLI
- [**Gemini CLI**](https://geminicli.com/)，目前免费用，干脏活用，Claude Code 或 Codex 写好的脚本拿它来执行可以，整理文档和找思路也合适，有客户端和 CLI
- [**antigravity**](https://antigravity.google/)，谷歌的，可以免费用 Claude Opus 4.5 和 Gemini 3.0 Pro，大善人
- [**AI Studio**](https://aistudio.google.com/prompts/new_chat)，谷歌家的，免费用 Gemini 3.0 Pro 和 Nano Banana
- [**Gemini Enterprise**](https://cloud.google.com/gemini-enterprise)，谷歌企业版，目前能免费用 Nano Banana Pro
- [**Augment**](https://app.augmentcode.com/)，上下文引擎和提示词优化按钮神中神，新手直接用它，点按钮自动帮你写好提示词，懒人必备
- [**Cursor**](https://cursor.com/)，已经占领用户心智高地，人尽皆知
- [**Windsurf**](https://windsurf.com/)，新用户有免费额度
- [**Ollama**](https://ollama.com/)，本地模型 CLI 管理器，拉模型、跑模型一条命令，可用本地部署一些开源的模型
- [**Warp**](https://www.warp.dev/)，AI 终端，体验不错，写命令和解释错误挺省心
- [**GitHub Copilot**](https://github.com/copilot)，没深度用过
- [**Kimi K2**](https://www.kimi.com/)，国产，还行，干脏活和简单任务用，之前 2 元一个 key，一周 1024 次调用，性价比高
- [**GLM**](https://bigmodel.cn/)，国产，听说很强，体感接近 Claude Sonnet 4
- [**Qwen**](https://qwenlm.github.io/qwen-code-docs/zh/cli/)，阿里出的，CLI 有免费额度
- [**提示词库（直接复制粘贴即可用）**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1)
- [**其他编程工具的系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools)
- [**Skills 制作器（下好后让 AI 按你的需求生成 Skills）**](https://github.com/yusufkaraaslan/Skill_Seekers)
- [**元提示词（生成提示词的提示词）**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220)
- [**通用项目架构模板**](./documents/通用项目架构模板.md)，一键丢给 AI 就能搭好目录结构
- [**Augment 提示词优化器**](https://app.augmentcode.com/)，提示词优化是真的好用，强烈推荐
- [**Mermaid Chart**](https://www.mermaidchart.com/)，架构 / 思维导图可视化，做架构图，序列图的时候复制到这里看
- [**NotebookLM**](https://notebooklm.google.com/)，资料 AI 解读、听音频、看思维导图、配合 Nano Banana 图片
- [**Zread**](https://zread.ai/)，AI 读 GitHub 仓库神器，减少造轮子
- [**元技能：Skills 的 Skills**](./skills/claude-skills/SKILL.md)，就是生成 Skills 的 Skills
- [**tmux快捷键大全**](./documents/tmux快捷键大全.md)，远程链接ssh用，再也不怕ssh端了终端会话丢失了
- [**二哥的Java进阶之路**](https://javabetter.cn/)，里面有小工具的详细配置教程
- [**tmux**](https://github.com/tmux/tmux)，终端复用神器，一个窗口顶多个终端会话，分屏、会话保持、远程不断线，服务器党 / 多项目并行必备
- [**nvim**](https://github.com/neovim/neovim)，现代化 Vim，插件生态成熟、性能极强，适合写代码、改配置、SSH 远程干活，键盘流天花板
- [**LazyVim**](https://github.com/LazyVim/LazyVim)，基于 Neovim 的成体系配置框架，预置 LSP / 补全 / 调试 / Git 等全套能力，开箱即用又能逐步深度定制，不想从零配 nvim 的最优解
- [**DBeaver**](https://dbeaver.io/)，全能数据库客户端，支持 MySQL / PostgreSQL / SQLite / ClickHouse 等，连本地、服务器、SSH 隧道都很顺，查数据、改表结构、看执行计划都很舒服，工程党必备
- [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite)，注册有这个卡你可以注册 aws 赠送的 100 美金的服务器额度，可以用很久，选澳大利亚地区的通过很快
---
## 📚 相关文档/资源
- [**vibecoding交流群**](https://t.me/glue_coding)
- [**我的频道**](https://t.me/tradecat_ai_channel)
- [**小登论道：我的学习经验**](./documents/小登论道.md)
- [**编程书籍推荐**](./documents/编程书籍推荐.md)
- [**元提示词，生成提示词的提示词**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220)
- [**元技能 Skills 就是生成 Skills 的 Skills**](./skills/claude-skills/SKILL.md)
- [**skills技能仓库复制即用**](./skills)
- [**Skills生成器，把任何资料转agent的Skills（技能）**](https://github.com/yusufkaraaslan/Skill_Seekers)
- [**google表格提示词数据库，我系统性收集和制作的几百个适用于各个场景的用户提示词和系统提示词在线表格**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1)
- [**系统提示词收集仓库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools)
- [**prompts-library 提示词库xlsx与md文件夹互转工具与使用说明，有几百个适用于各个领域的提示词与元提示词**](./libs/external/prompts-library/)
- [**coding_prompts我收集和制作的几十个vibecoding适用的提示词**](./prompts/coding_prompts/)
- [**代码组织.md**](./documents/代码组织.md)
- [**关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md**](./documents/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md)
- [**工具集.md**](./documents/工具集.md)
- [**编程之道.md**](./documents/编程之道.md)
- [**胶水编程.md**](./documents/胶水编程.md)
- [**gluecoding.md**](./documents/gluecoding.md)
- [**CONTRIBUTING.md**](./CONTRIBUTING.md)
- [**CODE_OF_CONDUCT.md**](./CODE_OF_CONDUCT.md)
- [**系统提示词构建原则.md**](./documents/系统提示词构建原则.md) - 深入探讨构建高效、可靠AI系统提示词的核心原则、沟通互动、任务执行、编码规范与安全防护等全方位指南。
- [**系统架构可视化生成Mermaid**](./prompts/coding_prompts/系统架构可视化生成Mermaid.md) - 根据项目直接生成 .mmd 导入思维导图网站直观看架构图，序列图等等
- [**开发经验.md**](./documents/开发经验.md) - 包含变量命名、文件结构、编码规范、系统架构原则、微服务、Redis和消息队列等开发经验与项目规范的详细整理。
- [**vibe-coding-经验收集.md**](./documents/vibe-coding-经验收集.md) - AI开发最佳实践与系统提示词优化技巧的经验收集。
- [**通用项目架构模板.md**](./documents/通用项目架构模板.md) - 提供了多种项目类型的标准目录结构、核心设计原则、最佳实践建议及技术选型参考。
- [**auggie-mcp 详细配置文档**](./documents/auggie-mcp配置文档.md) - augment上下文引擎mcp，非常好用。
- [**system_prompts/**](./prompts/system_prompts/) - AI开发系统提示词集合，包含多版本开发规范与思维框架（1-8号配置）。
- `1/CLAUDE.md` - 开发者行为准则与工程规范
- `2/CLAUDE.md` - ultrathink模式与架构可视化规范
- `3/CLAUDE.md` - 思维创作哲学与执行确认机制
- `4/CLAUDE.md` - Linus级工程师服务认知架构
- `5/CLAUDE.md` - 顶级程序员思维框架与代码品味
- `6/CLAUDE.md` - 综合版本，整合所有最佳实践
- `7/CLAUDE.md` - 推理与规划智能体，专职复杂任务分解与高可靠决策支持
- `8/CLAUDE.md` - 最新综合版本，顶级程序员服务Linus级工程师，包含完整元规则与认知架构
- `9/CLAUDE.md` - 失败的简化版本，效果不行
- `10/CLAUDE.md` - 最新综合版本，加入了augment上下文引擎的使用规范与要求
---
### 项目目录结构概览
本项目 `vibe-coding-cn` 的核心结构主要围绕知识管理、AI 提示词的组织与自动化展开。以下是经过整理和简化的目录树及各部分说明：
```
.
├── CODE_OF_CONDUCT.md # 社区行为准则，规范贡献者行为。
├── CONTRIBUTING.md # 贡献指南，说明如何为本项目做出贡献。
├── GEMINI.md # AI 助手的上下文文档，包含项目概述、技术栈和文件结构。
├── LICENSE # 开源许可证文件。
├── Makefile # 项目自动化脚本，用于代码检查、构建等。
├── README.md # 项目主文档，包含项目概览、使用指南、资源链接等。
├── .gitignore # Git 忽略文件。
├── AGENTS.md # AI 代理相关的文档或配置。
├── CLAUDE.md # AI 助手的核心行为准则或配置。
│
├── backups/ # 项目备份脚本。
│ ├── gz/ # 备份文件存放目录。
│ ├── 一键备份.sh # 一键执行备份的 Shell 脚本。
│ └── 快速备份.py # 实际执行逻辑的 Python 脚本。
│
├── documents/ # 存放各类说明文档、经验总结和配置详细说明。
│ ├── auggie-mcp配置文档.md # Augment 上下文引擎配置文档。
│ ├── 代码组织.md # 代码组织与结构相关文档。
│ ├── ... (其他文档)
│
├── libs/ # 通用库代码，用于项目内部模块化。
│ ├── common/ # 通用功能模块。
│ │ ├── models/ # 模型定义。
│ │ │ └── __init__.py
│ │ └── utils/ # 工具函数。
│ │ └── backups/ # 内部备份工具。
│ ├── database/ # 数据库相关模块。
│ │ └── .gitkeep # 占位文件，确保目录被 Git 跟踪。
│ └── external/ # 外部集成模块。
│ ├── my-nvim/ # 用户的 Neovim 配置。
│ ├── prompts-library/ # 提示词库管理工具（Excel-Markdown 转换）。
│ │ ├── main.py # 提示词库管理工具主入口。
│ │ ├── scripts/ # 包含 Excel 与 Markdown 互转脚本和配置。
│ │ ├── prompt_excel/ # 存放 Excel 格式的原始提示词数据。
│ │ ├── prompt_docs/ # 存放从 Excel 转换而来的 Markdown 提示词文档。
│ │ └── ... (其他 prompts-library 内部文件)
│ └── XHS-image-to-PDF-conversion/ # 小红书图片转PDF工具。
│
├── prompts/ # 集中存放所有类型的 AI 提示词。
│ ├── assistant_prompts/ # 辅助类提示词。
│ ├── coding_prompts/ # 专门用于编程和代码生成相关的提示词集合。
│ │ └── ... (具体编程提示词文件)
│ │
│ ├── system_prompts/ # AI 系统级提示词，用于设定 AI 行为和框架。
│ │ └── ... (其他系统提示词)
│ │
│ └── user_prompts/ # 用户自定义或常用提示词。
│ ├── ASCII图生成.md # ASCII 艺术图生成提示词。
│ ├── 数据管道.md # 数据管道处理提示词。
│ └── ... (其他用户提示词)
│
├── skills/ # 集中存放所有类型的 skills 技能。
├── claude-skills # 生成 SKILL 的元 SKILL
│ ├── SKILL.md
│ └── ... (其他)
└── ... (与其他 skill)
```
---
## 🖼️ 概览与演示
一句话：Vibe Coding = **规划驱动 + 上下文固定 + AI 结对执行**，让「从想法到可维护代码」变成一条可审计的流水线，而不是一团无法迭代的巨石文件。
**你能得到**
- 成体系的提示词工具链：`prompts/system_prompts/` 约束 AI 行为边界，`prompts/coding_prompts/` 提供需求澄清、计划、执行的全链路脚本。
- 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。
---
## ⚙️ 架构与工作流程
核心资产映射：
```
prompts/
coding_prompts/ # 需求澄清、计划、执行链的核心提示词
system_prompts/ # 约束 AI 行为边界的系统级提示词
assistant_prompts/ # 辅助/配合型提示
user_prompts/ # 可复用的用户侧提示词
prompts-library/ # Excel↔Markdown 提示词转换与索引工具
documents/
代码组织.md, 通用项目架构模板.md, 开发经验.md, 系统提示词构建原则.md 等知识库
backups/
一键备份.sh, 快速备份.py # 本地/远端快照脚本
```
```mermaid
graph TB
%% GitHub 兼容简化版（仅使用基础语法）
subgraph ext_layer[外部系统与数据源层]
ext_contrib[社区贡献者]
ext_sheet[Google 表格 / 外部表格]
ext_md[外部 Markdown 提示词]
ext_api[预留：其他数据源 / API]
ext_contrib --> ext_sheet
ext_contrib --> ext_md
ext_api --> ext_sheet
end
subgraph ingest_layer[数据接入与采集层]
excel_raw[prompt_excel/*.xlsx]
md_raw[prompt_docs/外部MD输入]
excel_to_docs[prompts-library/scripts/excel_to_docs.py]
docs_to_excel[prompts-library/scripts/docs_to_excel.py]
ingest_bus[标准化数据帧]
ext_sheet --> excel_raw
ext_md --> md_raw
excel_raw --> excel_to_docs
md_raw --> docs_to_excel
excel_to_docs --> ingest_bus
docs_to_excel --> ingest_bus
end
subgraph core_layer[数据处理与智能决策层 / 核心]
ingest_bus --> validate[字段校验与规范化]
validate --> transform[格式映射转换]
transform --> artifacts_md[prompt_docs/规范MD]
transform --> artifacts_xlsx[prompt_excel/导出XLSX]
orchestrator[main.py · scripts/start_convert.py] --> validate
orchestrator --> transform
end
subgraph consume_layer[执行与消费层]
artifacts_md --> catalog_coding[prompts/coding_prompts]
artifacts_md --> catalog_system[prompts/system_prompts]
artifacts_md --> catalog_assist[prompts/assistant_prompts]
artifacts_md --> catalog_user[prompts/user_prompts]
artifacts_md --> docs_repo[documents/*]
artifacts_md --> new_consumer[预留：其他下游渠道]
catalog_coding --> ai_flow[AI 结对编程流程]
ai_flow --> deliverables[项目上下文 / 计划 / 代码产出]
end
subgraph ux_layer[用户交互与接口层]
cli[CLI: python main.py] --> orchestrator
makefile[Makefile 任务封装] --> cli
readme[README.md 使用指南] --> cli
end
subgraph infra_layer[基础设施与横切能力层]
git[Git 版本控制] --> orchestrator
backups[backups/一键备份.sh · backups/快速备份.py] --> artifacts_md
deps[requirements.txt · scripts/requirements.txt] --> orchestrator
config[prompts-library/scripts/config.yaml] --> orchestrator
monitor[预留：日志与监控] --> orchestrator
end
```
---
**如果这个项目对您有帮助，请不要吝啬您的 Star ⭐！**
## Star History
---
**Made with ❤️ and a lot of ☕ by [tukuaiai](https://github.com/tukuaiai),[Nicolas Zullo](https://x.com/NicolasZu)and [123olp](https://x.com/123olp)**
[⬆ 回到顶部](#vibe-coding-至尊超级终极无敌指南-V114514)
