vibe-coding-cn README

The project's README from github.com/2025Emma/vibe-coding-cn. As one markdown file: README.md.

Vibe Coding 指南

Vibe Coding 指南

一个通过与 AI 结对编程，将想法变为现实的终极工作站

📚 相关文档 🚀 入门指南 ⚙️ 完整设置流程 📞 联系方式 ✨ 支持项目 🤝 参与贡献

本仓库的 AI 解读链接：zread.ai/tukuaiai/vibe-coding-cn

🖼️ 概览

Vibe Coding 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以规划驱动和模块化为核心，避免让 AI 失控导致项目混乱。

核心理念: 规划就是一切。 谨慎让 AI 自主规划，否则你的代码库会变成一团无法管理的乱麻。

注意：以下经验分享并非普遍适用，请在具体实践中结合场景，辩证采纳。

🔑 元方法论 (Meta-Methodology)

该思想的核心是构建一个能够自我优化的 AI 系统。其递归本质可分解为以下步骤：

延伸阅读：A Formalization of Recursive Self-Optimizing Generative Systems

1. 定义核心角色：

α-提示词 (生成器): 一个“母体”提示词，其唯一职责是生成其他提示词或技能。
Ω-提示词 (优化器): 另一个“母体”提示词，其唯一职责是优化其他提示词或技能。

2. 描述递归的生命周期：

创生 (Bootstrap):
- 使用 AI 生成 α-提示词 和 Ω-提示词 的初始版本 (v1)。
自省与进化 (Self-Correction & Evolution):
- 使用 Ω-提示词 (v1) 优化 α-提示词 (v1)，从而得到一个更强大的 α-提示词 (v2)。
创造 (Generation):
- 使用进化后的 α-提示词 (v2) 生成所有需要的目标提示词和技能。
循环与飞跃 (Recursive Loop):
- 将新生成的、更强大的产物（甚至包括新版本的 Ω-提示词）反馈给系统，再次用于优化 α-提示词，从而启动持续进化。

3. 终极目标：

通过此持续的递归优化循环，系统在每次迭代中实现自我超越，无限逼近预设的预期状态。

🧭 道

凡是 ai 能做的，就不要人工做
一切问题问 ai
目的主导：开发过程中的一切动作围绕"目的"展开
上下文是 vibe coding 的第一性要素，垃圾进，垃圾出
系统性思考，实体，链接，功能/目的，三个维度
数据与函数即是编程的一切
输入，处理，输出刻画整个过程
多问 ai 是什么？，为什么？，怎么做？
先结构，后代码，一定要规划好框架，不然后面技术债还不完
奥卡姆剃刀定理，如无必要，勿增代码
帕累托法则，关注重要的那20%
逆向思考，先明确你的需求，从需求逆向构建代码
重复，多试几次，实在不行重新开个窗口，
专注，极致的专注可以击穿代码，一次只做一件事（神人除外）

🧩 法

一句话目标 + 非目标
正交性，功能不要太重复了，（这个分场景）
能抄不写，不重复造轮子，先问 ai 有没有合适的仓库，下载下来改
一定要看官方文档，先把官方文档爬下来喂给 ai
按职责拆模块
接口先行，实现后补
一次只改一个模块
文档即上下文，不是事后补

🛠️ 术

明确写清：能改什么，不能改什么
Debug 只给：预期 vs 实际 + 最小复现
测试可交给 AI，断言人审
代码一多就切会话

📋 器

集成开发环境 (IDE) & 终端

Visual Studio Code: 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 Local History 插件对项目版本管理尤为便捷。
虚拟环境 (.venv): 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。
Cursor: 已经占领用户心智高地，人尽皆知。
Warp: 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。
Neovim (nvim): 一款高性能的现代化 Vim 编辑器，拥有丰富的插件生态，是键盘流开发者的首选。
LazyVim: 基于 Neovim 的配置框架，预置了 LSP、代码补全、调试等全套功能，实现了开箱即用与深度定制的平衡。

AI 模型 & 服务

Claude Opus 4.5: 性能强大的 AI 模型，通过 Claude Code 等平台提供服务，并支持 CLI 和 IDE 插件。
gpt-5.1-codex.1-codex (xhigh): 适用于处理大型项目和复杂逻辑的 AI 模型，可通过 Codex CLI 等平台使用。
Droid: 提供对 Claude Opus 4.5 等多种模型的 CLI 访问。
Kiro: 目前提供免费的 Claude Opus 4.5 模型访问，并提供客户端及 CLI 工具。
Gemini CLI: 提供对 Gemini 模型的免费访问，适合执行脚本、整理文档和探索思路。
antigravity: 目前由 Google 提供的免费 AI 服务，支持使用 Claude Opus 4.5 和 Gemini 3.0 Pro。
AI Studio: Google 提供的免费服务，支持使用 Gemini 3.0 Pro 和 Nano Banana。
Gemini Enterprise: 面向企业用户的 Google AI 服务，目前可以免费使用。
GitHub Copilot: 由 GitHub 和 OpenAI 联合开发的 AI 代码补全工具。
Kimi K2: 一款国产 AI 模型，适用于多种常规任务。
GLM: 由智谱 AI 开发的国产大语言模型。
Qwen: 由阿里巴巴开发的 AI 模型，其 CLI 工具提供免费使用额度。

开发与辅助工具

Augment: 提供强大的上下文引擎和提示词优化功能。
Windsurf: 为新用户提供免费额度的 AI 开发工具。
Ollama: 本地大模型管理工具，可通过命令行方便地拉取和运行开源模型。
Mermaid Chart: 用于将文本描述转换为架构图、序列图等可视化图表。
NotebookLM: 一款用于 AI 解读资料、音频和生成思维导图的工具。
Zread: AI 驱动的 GitHub 仓库阅读工具，有助于快速理解项目代码。
tmux: 强大的终端复用工具，支持会话保持、分屏和后台任务，是服务器与多项目开发的理想选择。
DBeaver: 一款通用数据库管理客户端，支持多种数据库，功能全面。

资源与模板

提示词库 (在线表格): 一个包含大量可直接复制使用的各类提示词的在线表格。
第三方系统提示词学习库: 用于学习和参考其他 AI 工具的系统提示词。
Skills 制作器: 可根据需求生成定制化 Skills 的工具。
元提示词: 用于生成提示词的高级提示词。
通用项目架构模板: 可用于快速搭建标准化的项目目录结构。
元技能：Skills 的 Skills: 用于生成 Skills 的元技能。
tmux快捷键大全: tmux 的快捷键参考文档。
LazyVim快捷键大全: LazyVim 的快捷键参考文档。
二哥的Java进阶之路: 包含多种开发工具的详细配置教程。
虚拟卡: 可用于注册云服务等需要国际支付的场景。

编码模型性能分级参考

建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。

第一梯队: codex-5.1-max-xhigh, claude-opus-4.5-xhigh, gpt-5.2-xhigh
第二梯队: claude-sonnet-4.5, kimi-k2-thinking, minimax-m2, glm-4.6, gemini-3.0-pro, gemini-2.5-pro
第三梯队: qwen3, SWE, grok4

📚 相关文档与资源

交流社区:
- Telegram 交流群
- Telegram 频道
个人分享:
- 我的学习经验
- 编程书籍推荐
核心资源:
- 元提示词库: 用于生成提示词的高级提示词集合。
- 元技能 (Meta-Skill): 用于生成 Skills 的 Skill。
- 技能库 (Skills): 可直接集成的模块化技能仓库。
- 技能生成器: 将任何资料转化为 Agent 可用技能的工具。
- 在线提示词数据库: 包含数百个适用于各场景的用户及系统提示词的在线表格。
- 第三方系统提示词仓库: 汇集了多种 AI 工具的系统提示词。
项目内部文档:
- prompts-library 工具说明: 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。
- coding_prompts 集合: 适用于 Vibe Coding 流程的专用提示词。
- 系统提示词构建原则: 关于如何构建高效、可靠的 AI 系统提示词的综合指南。
- 开发经验总结: 包含变量命名、文件结构、编码规范、架构原则等实践经验。
- 通用项目架构模板: 提供多种项目类型的标准目录结构与最佳实践。
- Augment MCP 配置文档: Augment 上下文引擎的详细配置说明。
- system_prompts 集合: 用于指导 AI 开发的系统提示词，包含多个版本的开发规范与思维框架。

项目目录结构概览

本项目 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 助手的核心行为准则或配置。
│
├── i18n/zh/documents/           # 存放各类说明文档、经验总结和配置详细说明。
│   ├── Methodology and Principles/ # 方法论与原则
│   ├── Templates and Resources/    # 模板与资源
│   └── Tut

Searching Database…

23.1K ·GitHub

这是做什么的?

一份中文的 vibe coding 指南——一种以规划为核心、和 AI 结对编程来开发软件的工作方式,涵盖了从项目想法、技术选型到开发、调试、扩展的完整流程。

这是要安装的软件,还是一份文字指南?

是文字指南和知识库,不是软件:Markdown 方法论文档,外加提示词库、模板和工具推荐。唯一的代码是一个 Makefile 和一个提示词库辅助工具,后者可以在 Excel 和 Markdown 之间转换提示词。

新手应该从哪里入手?

先看 README 顶部链接的入门指南,再看完整的搭建流程文档;想快速了解的话,zread.ai/tukuaiai/vibe-coding-cn 上有一份 AI 生成的导读。

这些建议对每个人都同样适用吗?

作者明确提醒,分享的经验并非放之四海而皆准,请读者结合自己的实际情况来判断,不要照搬照抄。

使用它需要会中文吗?

需要——指南和各文档都以中文写成,放在 i18n/zh 目录下。不过它评测的所有东西,从 Cursor 到 Qwen,都是国际化软件,这些工具本身在哪儿都能用。

在日常写代码方面,它给出了哪些具体的实操规则?

在技巧部分:明确告诉 AI 哪些能改、哪些不能改;调试时把预期输出和实际输出一起给它,再附上最小复现步骤;让 AI 写测试,但断言要自己审查;代码堆多了就开个新会话。

指南自带哪些现成的资源?

提示词库,包括一个收录了数百条提示词的在线表格、一个用来生成提示词的 meta-prompt、一个能生成技能的 meta-skill、一个技能生成器,还有一个通用项目架构模板——外加那个在 Excel 和 Markdown 之间转换提示词的提示词库工具。

照这套流程走要花钱吗?

指南本身免费,而且它主要靠免费额度:Kiro 和 Google 的 antigravity 被列为可免费使用 Claude Opus 4.5,Gemini CLI 提供免费的 Gemini 访问,AI Studio 则提供免费的 Gemini 3.0 Pro。

这个项目有社区吗?

有——README 里链接了一个 Telegram 群和一个 Telegram 频道,可以参与讨论。

What are similar projects?

vibe-coding-cn, superpowers-zh, superpowers, compound-engineering-plugin, anti-slop, agency-agents-zh, Coding-Agent-Skills, vibe-wise

Which topics is it in?

methodology, prompt-library, prompts, tmux, templates, neovim, agentic-coding, vibe-coding, github-copilot, gemini-cli, ai-coding, workflow

Creator: 2025Emma
Size: 28.2 MB
Stars: 23.1K
Updated: CommitDec 16
Age: 10mo
Commits · 90 Days