Vibe Coding 指南
概述：
欢迎来到 Vibe Coding 指南（vibe-coding-cn）——一个围绕「人与 AI 结对编程」构建的中文知识工作站。这个仓库不是一段代码，而是一套不断进化的方法论体系、可复用的技能库，以及从想法到可维护代码的完整交付路径。无论你是刚接触 AI 辅助编程的完全新手，还是希望提升 AI 协作效率的资深开发者，这里都有一套经过实战验证的工具链和思维框架供你使用。
本仓库最早基于 EnzeD/vibe-coding 翻译并深度扩展而来，由社区 tukuaiai 维护，采用 MIT 开源许可证。项目明确声明："这是一个不断生长和自我否定的项目，当下的一切经验和能力都可能因 AI 能力的变化而失去意义"——这种辩证态度本身就是 Vibe Coding 精神的体现。
1.这个仓库解决什么问题
Vibe Coding 的核心命题很简单：让 AI 成为你的主程序员，你负责描述意图、审查结果、把握方向。但实际操作中，开发者会立刻撞上三堵墙——AI 幻觉（生成不存在的 API）、复杂性爆炸（项目越大越失控）、以及过高的使用门槛（需要深厚编程功底）。本仓库围绕这些问题构建了一整套分层解决方案。
| 核心痛点 | 仓库中的对应解法 | 入口位置 |
|---|---|---|
| 🎭 AI 幻觉——生成虚假 API 和错误逻辑 | 胶水编程：只复用已验证的成熟代码，AI 负责连接而非生成 | assets/documents/principles/fundamentals/胶水编程.md |
| 🧩 复杂性爆炸——项目失控 | Memory Bank 模式 + Canvas 白板驱动：用结构化文档和图形化架构作为单一真相源 | assets/documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md |
| 🎓 门槛过高——不会编程也能开发 | 实验性方法论 + 提示词库 + Skills 技能库：开箱即用的指令和专家级能力封装 | assets/prompts/README.md, assets/skills/README.md |
来源：README.md, assets/documents/principles/fundamentals/胶水编程.md
2.仓库架构总览
整个仓库围绕一个清晰的三层资产模型构建：知识层（Documents）→ 指令层（Prompts）→ 能力层（Skills），辅以工作流引擎和外部工具集成。下面的架构图展示了各模块之间的关系和数据流向。
来源：AGENTS.md, assets/documents/README.md, assets/prompts/README.md, assets/skills/README.md, assets/workflow/auto-dev-loop/README.md
3.目录结构一览
下面是仓库的完整目录结构，每个模块都承担明确的职责。理解这张地图，你就掌握了在这个知识库中导航的关键。
vibe-coding-cn/
├── README.md ├── AGENTS.md # 🤖 AI Agent 行为准则
├── CONTRIBUTING.md # 🤝 贡献指南
├── Makefile # ⚙️ 自动化脚本（lint / build / test）
│
├── assets/ # 📦 核心资产目录
│ ├── README.md # 外部资源在线表格（唯一真相源）
│ │
│ ├── documents/ # 📚 知识层
│ │ ├── principles/ # 原则与思想
│ │ │ ├── fundamentals/ # 胶水编程 / 硬约束 / 经验教训 / 架构模板
│ │ │ └── philosophy/ # 现象学还原 / 辩证法 / 概念骨架
│ │ ├── guides/ # 入门与操作指南
│ │ │ ├── getting-started/ # 环境搭建 / IDE配置 / 哲学原理
│ │ │ └── playbook/ # Canvas白板 / AI蜂群 / tmux / 远程开发
│ │ └── case-studies/ # 实战案例
│ │ ├── polymarket-dev/ # 预测市场套利系统
│ │ ├── telegram-dev/ # Telegram Bot 开发
│ │ └── fate-engine-dev/ # 命理引擎开发
│ │
│ ├── prompts/ # 💬 指令层
│ │ └── README.md # 云端提示词表格入口
│ │
│ ├── skills/ # ⚡ 能力层（20个专业技能）
│ │ ├── skills-skills/ # ⭐ 元技能（生成 Skills 的 Skills）
│ │ ├── canvas-dev/ # ⭐ Canvas 白板驱动开发
│ │ ├── headless-cli/ # 无头模式 AI CLI
│ │ ├── postgresql/ # 数据库专家
│ │ ├── ccxt/ / coingecko/ / ... # 加密货币/量化交易
│ │ └── telegram-dev/ / tmux-*/ .. # 开发工具与生产力
│ │
│ ├── workflow/ # 🔄 工作流模板
│ │ ├── auto-dev-loop/ # 五步全自动开发闭环
│ │ └── canvas-dev/ # Canvas 白板工作流
│ │
│ ├── repo/ # 🔌 外部工具集成（含 Git submodule）
│ │ ├── prompts-library/ # Excel ↔ Markdown 转换工具
│ │ ├── chat-vault/ # AI 聊天记录保存
│ │ ├── claude-official-skills/ # Claude 官方 Skills（submodule）
│ │ └── backups/ # 备份脚本
│ │
│ ├── config/ # ⚙️ 开发配置（Codex CLI 等）
│ └── tools/ # 🔧 工具目录（预留）
│
├── .github/ # 🏗️ GitHub 配置
│ ├── workflows/ # CI/CD（lint + link checker）
│ ├── ISSUE_TEMPLATE/ # Issue 模板
│ └── PULL_REQUEST_TEMPLATE.md # PR 模板
│
└── CODE_OF_CONDUCT.md # 📜 行为准则
来源：AGENTS.md, README.md, assets/repo/README.md, assets/README.md
4.核心理念速览
在深入各个模块之前，有五个核心理念构成了整个仓库的思维底座。它们不是孤立的口号，而是相互支撑的方法论体系。
1. 人下 AI 上——把 AI 当主程序员
Vibe Coding 的第一性原理：让 AI 做重活，人做决策。你的职责是描述意图（"我想要什么"）和审查结果（"做出来对不对"），而不是逐行编写代码。这意味着沟通能力比编码能力更重要。
2. 胶水编程——能抄不写，能连不造
这是 Vibe Coding 的终极进化形态。传统编程是「人写代码」，Vibe Coding 是「AI 写代码」，胶水编程是「AI 连接代码」。AI 的唯一职责是理解你的意图，将已有的成熟模块连接起来——零生成、零幻觉、零复杂性。来源：assets/documents/principles/fundamentals/胶水编程.md
3. 上下文是第一性要素——垃圾进，垃圾出
AI 的输出质量完全取决于你提供的上下文质量。项目因此强调"文档即上下文，不是事后补"——Memory Bank（记忆库）模式要求你在开发前就准备好需求文档、技术栈、实施计划和架构说明，让 AI 在充分理解项目全貌的前提下工作。
4. 递归自优化——系统自我进化
通过"α-生成器"和"Ω-优化器"两个元提示词的递归闭环，构建能持续自我优化的 AI 系统。每一次迭代都在逼近更好的预期状态。来源：assets/documents/principles/fundamentals/A Formalization of Recursive Self-Optimizing Generative Systems.md
5. 图形是第一公民——Canvas 白板驱动开发
让白板成为项目的「单一真相源」，通过图形化方式降低协作与上下文成本。AI 直接读取白板 JSON 即可理解架构，人类通过连线直观感知依赖关系。来源：assets/documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md
5.三层知识资产体系
整个仓库的内容围绕一个三层结构组织，从抽象到具体、从理论到实战，形成完整的学习路径。
| 层级 | 目录 | 内容 | 产出形态 |
|---|---|---|---|
| 📚 知识层 | assets/documents/ |
方法论、哲学原理、入门指南、实战案例 | Markdown 文档 |
| 💬 指令层 | assets/prompts/ |
元提示词、系统提示词、编程提示词、用户提示词 | Google Sheets 云端表格 |
| ⚡ 能力层 | assets/skills/ |
可复用的专家级 AI 技能封装（20个） | SKILL.md 技能文件 |
知识层提供了"为什么这样做"的理论基础和"怎么做"的操作指南；指令层提供了约束 AI 行为边界的具体提示词；能力层则将提示词进一步封装为可直接调用的专业技能模块。三者形成了从理解→约束→执行的完整闭环。
💡 快速使用 Skills：每个 Skill 都是一个独立的 SKILL.md 文件，直接将文件内容喂给你的 AI（如 Claude 或 ChatGPT），AI 就会获得该领域的专家级能力。例如，执行 cat assets/skills/postgresql/SKILL.md 查看数据库专家技能，复制粘贴给 AI 即可使用。创建自定义 Skill 则使用元技能 assets/skills/skills-skills/SKILL.md。
来源：assets/documents/README.md, assets/prompts/README.md, assets/skills/README.md, AGENTS.md
6.关键工具与自动化
仓库通过 Makefile 和多个专用脚本提供了基础的自动化能力，确保文档质量和开发效率。
| 命令 | 用途 | 说明 |
|---|---|---|
make help |
查看所有可用命令 | 列出 Makefile 中定义的全部目标 |
make lint |
校验全仓库 Markdown | 使用 markdownlint-cli 检查格式规范 |
make build |
构建项目（预留） | 占位命令，待扩展 |
make test |
运行测试（预留） | 占位命令，待扩展 |
bash assets/repo/backups/一键备份.sh |
创建完整项目备份 | Shell 版一键备份 |
python3 assets/repo/backups/快速备份.py |
Python 版备份 | 需 Python 3.8+ |
python3 assets/repo/prompts-library/main.py |
提示词格式转换 | Excel ↔ Markdown ↔ JSONL 互转 |
CI/CD 方面，仓库配置了 GitHub Actions 自动化流水线，在每次提交时自动运行 Markdown lint 和链接检查，确保文档质量的持续性。
来源：Makefile, AGENTS.md, CONTRIBUTING.md
7.社区与参与
本项目是一个开放的知识社区产物，欢迎任何形式的参与。无论你是发现了文档中的错误、有新的方法论想分享，还是想贡献一个全新的 Skill，都可以通过以下方式参与：
- 报告问题或提出建议：通过 GitHub Issues 提交
- 直接贡献内容：Fork → 创建分支 → 修改 → 提交 Pull Request（详见 CONTRIBUTING.md）
- 加入社区交流：Telegram 交流群 / Telegram 频道
8.推荐阅读路径
根据你的当前位置和目标，以下是逻辑化的阅读顺序。每一步都建立在前一步的基础之上，逐步构建完整的 Vibe Coding 认知体系。
刚刚了解 Vibe Coding？ 从 Quick Start 开始，1 分钟内就能体验第一次 AI 结对编程。
准备搭建完整环境？ 前往 Environment Setup Guide，按步骤配置网络、开发工具和 AI 模型。
想深入了解工具生态？ Tool Ecosystem Primer 会为你梳理所有推荐的 IDE、终端、AI 模型和辅助工具。
对方法论感兴趣？ 在完成基础配置后，前往 Glue Coding Methodology 了解 Vibe Coding 的核心编程范式，或通过 Recursive Self-Optimization Meta-Method 理解系统的自我进化机制。
准备动手开发项目？ Auto Development Loop Workflow 提供了完整的五步自动开发闭环，而 Canvas Whiteboard-Driven Development 则展示了用图形化白板驱动 AI 协作的创新方式。
下一章：快速开始。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
12
0- 0
已为社区贡献9条内容
所有评论(0)