[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-2025Emma--vibe-coding-cn":3,"tool-2025Emma--vibe-coding-cn":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",153609,2,"2026-04-13T11:34:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":65,"owner_avatar_url":73,"owner_bio":65,"owner_company":65,"owner_location":65,"owner_email":65,"owner_twitter":65,"owner_website":65,"owner_url":74,"languages":75,"stars":88,"forks":89,"last_commit_at":90,"license":91,"difficulty_score":92,"env_os":93,"env_gpu":93,"env_ram":93,"env_deps":94,"category_tags":97,"github_topics":65,"view_count":32,"oss_zip_url":65,"oss_zip_packed_at":65,"status":17,"created_at":98,"updated_at":99,"faqs":100,"releases":101},7267,"2025Emma\u002Fvibe-coding-cn","vibe-coding-cn",null,"vibe-coding-cn 是一个专为中文用户打造的\"Vibe Coding（氛围编程）”实践指南与资源库。它旨在帮助开发者通过与 AI 结对编程，将抽象的想法快速转化为可运行的代码现实。在传统开发中，从构思到落地往往需要耗费大量时间在语法细节、环境配置和重复性编码上，而 vibe-coding-cn 提供了一套系统化的工作流和方法论，解决如何让 AI 更精准地理解意图、如何高效审查 AI 生成的代码以及如何构建人机协作的最佳实践等核心问题。\n\n这套资源特别适合希望提升开发效率的程序员、独立开发者以及想要尝试 AI 辅助编程的技术爱好者。无论你是想快速构建原型，还是希望在日常工作中引入 AI 伙伴，都能从中找到适合的路径。其独特亮点在于不仅整理了通用的 AI 编程技巧，还针对中文语境进行了本地化优化，提供了符合中文思维习惯的提示词模板、常见误区解析及实战案例，让中文用户能更自然地与 AI 沟通。通过遵循这里的指南，用户可以逐渐掌握“以意图驱动开发”的新模式，把精力更多集中在创意与架构设计上，而非繁琐的代码实现细节。","\u003C!--\n-------------------------------------------------------------------------------\n  项目头部区域 (HEADER)\n-------------------------------------------------------------------------------\n-->\n\u003Cp align=\"center\">\n  \u003C!-- 建议尺寸: 1280x640px。可以使用 Canva, Figma 或 https:\u002F\u002Fbanners.beyondco.de\u002F 等工具制作 -->\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_b923c4bd685d.png\" alt=\"Vibe Coding 指南\" width=\"80px\">\n\u003C\u002Fp>\n\n\u003Cdiv align=\"center\">\n\n# Vibe Coding 指南\n\n**一个通过与 AI 结对编程，将想法变为现实的终极工作站**\n\n---\n\n\u003C!--\n  徽章区域 (BADGES)\n-->\n\u003C!-- 项目状态徽章 -->\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Factions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fmain.yml?label=%E6%9E%84%E5%BB%BA%E7%8A%B6%E6%80%81&style=for-the-badge\" alt=\"构建状态\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Freleases\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC&style=for-the-badge\" alt=\"最新版本\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E8%AE%B8%E5%8F%AF%E8%AF%81&style=for-the-badge\" alt=\"许可证\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Ftop\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E4%B8%BB%E8%A6%81%E8%AF%AD%E8%A8%80&style=for-the-badge\" alt=\"主要语言\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Fcode-size\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E4%BB%A3%E7%A0%81%E9%87%8F&style=for-the-badge\" alt=\"代码量\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fgraphs\u002Fcontributors\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E8%B4%A1%E7%8C%AE%E8%80%85&style=for-the-badge\" alt=\"贡献者\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Fglue_coding\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F聊天-Telegram-blue?style=for-the-badge&logo=telegram\" alt=\"交流群\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C!-- 多语言入口 -->\n\u003Cp>\n  \u003Ca href=\".\u002Fi18n\u002Fzh\u002FREADME.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-中文-red?style=for-the-badge\" alt=\"简体中文\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fen\u002FREADME.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-English-lightgrey?style=for-the-badge\" alt=\"English\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fhe\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-עברית-navy?style=for-the-badge\" alt=\"Hebrew\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Far\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-العربية-brown?style=for-the-badge\" alt=\"Arabic\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fbn\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-বাংলা-orange?style=for-the-badge\" alt=\"Bengali\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fde\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Deutsch-black?style=for-the-badge\" alt=\"Deutsch\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fes\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Español-yellow?style=for-the-badge\" alt=\"Español\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Ffa\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-فارسی-purple?style=for-the-badge\" alt=\"Farsi\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Ffr\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Français-blue?style=for-the-badge\" alt=\"Français\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fha\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Hausa-darkgreen?style=for-the-badge\" alt=\"Hausa\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fhi\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-हिन्दी-darkorange?style=for-the-badge\" alt=\"Hindi\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fid\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Bahasa%20Indonesia-teal?style=for-the-badge\" alt=\"Bahasa Indonesia\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fit\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Italiano-green?style=for-the-badge\" alt=\"Italiano\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fja\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-日本語-indigo?style=for-the-badge\" alt=\"日本語\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fko\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-한국어-slateblue?style=for-the-badge\" alt=\"한국어\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fms\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Bahasa%20Melayu-seagreen?style=for-the-badge\" alt=\"Bahasa Melayu\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fnl\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Nederlands-darkred?style=for-the-badge\" alt=\"Nederlands\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fpl\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Polski-crimson?style=for-the-badge\" alt=\"Polski\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fpt\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Português-darkslategray?style=for-the-badge\" alt=\"Português\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fru\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Русский-steelblue?style=for-the-badge\" alt=\"Русский\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fsw\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Kiswahili-forestgreen?style=for-the-badge\" alt=\"Swahili\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fta\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-தமிழ்-darkmagenta?style=for-the-badge\" alt=\"Tamil\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fth\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-ไทย-royalblue?style=for-the-badge\" alt=\"ภาษาไทย\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Ftr\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Türkçe-firebrick?style=for-the-badge\" alt=\"Türkçe\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fuk\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Українська-cornflowerblue?style=for-the-badge\" alt=\"Українська\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fur\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-اردو-darkslateblue?style=for-the-badge\" alt=\"Urdu\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fvi\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Tiếng%20Việt-darkgreen?style=for-the-badge\" alt=\"Tiếng Việt\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C!-- 资源直达 -->\n\u003Cp>\n  \u003Ca href=\".\u002Fi18n\u002Fzh\u002Fprompts\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F提示词-精选-purple?style=for-the-badge\" alt=\"提示词精选\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fzh\u002Fskills\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fskills-技能大全-forestgreen?style=for-the-badge\" alt=\"skills技能大全\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Flibs\u002Fexternal\u002Fprompts-library\u002Fprompt_docs\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F提示词-大全-orange?style=for-the-badge\" alt=\"提示词大全\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F提示词-在线表格(推荐)-blue?style=for-the-badge\" alt=\"提示词在线表格（推荐）\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fx1xhlol\u002Fsystem-prompts-and-models-of-ai-tools\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F系统提示词-仓库-slateblue?style=for-the-badge\" alt=\"系统提示词仓库\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n[📚 相关文档](#-相关文档与资源)\n[🚀 入门指南](#-入门指南)\n[⚙️ 完整设置流程](#️-完整设置流程)\n[📞 联系方式](#-联系方式)\n[✨ 支持项目](#-支持项目)\n[🤝 参与贡献](#-参与贡献)\n\n本仓库的 AI 解读链接：[zread.ai\u002Ftukuaiai\u002Fvibe-coding-cn](https:\u002F\u002Fzread.ai\u002Ftukuaiai\u002Fvibe-coding-cn\u002F1-overview)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🖼️ 概览\n\n**Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。\n\n> **核心理念**: *规划就是一切。* 谨慎让 AI 自主规划，否则你的代码库会变成一团无法管理的乱麻。\n\n**注意**：以下经验分享并非普遍适用，请在具体实践中结合场景，辩证采纳。\n\n## 🔑 元方法论 (Meta-Methodology)\n\n该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤：\n\n> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002FA%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)\n\n#### 1. 定义核心角色：\n\n*   **α-提示词 (生成器)**: 一个“母体”提示词，其唯一职责是**生成**其他提示词或技能。\n*   **Ω-提示词 (优化器)**: 另一个“母体”提示词，其唯一职责是**优化**其他提示词或技能。\n\n#### 2. 描述递归的生命周期：\n\n1.  **创生 (Bootstrap)**:\n    *   使用 AI 生成 `α-提示词` 和 `Ω-提示词` 的初始版本 (v1)。\n\n2.  **自省与进化 (Self-Correction & Evolution)**:\n    *   使用 `Ω-提示词 (v1)` **优化** `α-提示词 (v1)`，从而得到一个更强大的 `α-提示词 (v2)`。\n\n3.  **创造 (Generation)**:\n    *   使用**进化后的** `α-提示词 (v2)` 生成所有需要的目标提示词和技能。\n\n4.  **循环与飞跃 (Recursive Loop)**:\n    *   将新生成的、更强大的产物（甚至包括新版本的 `Ω-提示词`）反馈给系统，再次用于优化 `α-提示词`，从而启动持续进化。\n\n#### 3. 终极目标：\n\n通过此持续的**递归优化循环**，系统在每次迭代中实现**自我超越**，无限逼近预设的**预期状态**。\n\n## 🧭 道\n\n* **凡是 ai 能做的，就不要人工做**\n* **一切问题问 ai**\n* **目的主导：开发过程中的一切动作围绕\"目的\"展开**\n* **上下文是 vibe coding 的第一性要素，垃圾进，垃圾出**\n* **系统性思考，实体，链接，功能\u002F目的，三个维度**\n* **数据与函数即是编程的一切**\n* **输入，处理，输出刻画整个过程**\n* **多问 ai 是什么？，为什么？，怎么做？**\n* **先结构，后代码，一定要规划好框架，不然后面技术债还不完**\n* **奥卡姆剃刀定理，如无必要，勿增代码**\n* **帕累托法则，关注重要的那20%**\n* **逆向思考，先明确你的需求，从需求逆向构建代码**\n* **重复，多试几次，实在不行重新开个窗口，**\n* **专注，极致的专注可以击穿代码，一次只做一件事（神人除外）**\n\n\n## 🧩 法\n\n* **一句话目标 + 非目标**\n* **正交性，功能不要太重复了，（这个分场景）**\n* **能抄不写，不重复造轮子，先问 ai 有没有合适的仓库，下载下来改**\n* **一定要看官方文档，先把官方文档爬下来喂给 ai**\n* **按职责拆模块**\n* **接口先行，实现后补**\n* **一次只改一个模块**\n* **文档即上下文，不是事后补**\n\n## 🛠️ 术\n\n* 明确写清：**能改什么，不能改什么**\n* Debug 只给：**预期 vs 实际 + 最小复现**\n* 测试可交给 AI，**断言人审**\n* 代码一多就**切会话**\n\n## 📋 器\n\n### 集成开发环境 (IDE) & 终端\n\n*   [**Visual Studio Code**](https:\u002F\u002Fcode.visualstudio.com\u002F): 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。\n*   **虚拟环境 (.venv)**: 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。\n*   [**Cursor**](https:\u002F\u002Fcursor.com\u002F): 已经占领用户心智高地，人尽皆知。\n*   [**Warp**](https:\u002F\u002Fwww.warp.dev\u002F): 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。\n*   [**Neovim (nvim)**](https:\u002F\u002Fgithub.com\u002Fneovim\u002Fneovim): 一款高性能的现代化 Vim 编辑器，拥有丰富的插件生态，是键盘流开发者的首选。\n*   [**LazyVim**](https:\u002F\u002Fgithub.com\u002FLazyVim\u002FLazyVim): 基于 Neovim 的配置框架，预置了 LSP、代码补全、调试等全套功能，实现了开箱即用与深度定制的平衡。\n\n### AI 模型 & 服务\n\n*   [**Claude Opus 4.5**](https:\u002F\u002Fclaude.ai\u002Fnew): 性能强大的 AI 模型，通过 Claude Code 等平台提供服务，并支持 CLI 和 IDE 插件。\n*   [**gpt-5.1-codex.1-codex (xhigh)**](https:\u002F\u002Fchatgpt.com\u002Fcodex\u002F): 适用于处理大型项目和复杂逻辑的 AI 模型，可通过 Codex CLI 等平台使用。\n*   [**Droid**](https:\u002F\u002Ffactory.ai\u002Fnews\u002Fterminal-bench): 提供对 Claude Opus 4.5 等多种模型的 CLI 访问。\n*   [**Kiro**](https:\u002F\u002Fkiro.dev\u002F): 目前提供免费的 Claude Opus 4.5 模型访问，并提供客户端及 CLI 工具。\n*   [**Gemini CLI**](https:\u002F\u002Fgeminicli.com\u002F): 提供对 Gemini 模型的免费访问，适合执行脚本、整理文档和探索思路。\n*   [**antigravity**](https:\u002F\u002Fantigravity.google\u002F): 目前由 Google 提供的免费 AI 服务，支持使用 Claude Opus 4.5 和 Gemini 3.0 Pro。\n*   [**AI Studio**](https:\u002F\u002Faistudio.google.com\u002Fprompts\u002Fnew_chat): Google 提供的免费服务，支持使用 Gemini 3.0 Pro 和 Nano Banana。\n*   [**Gemini Enterprise**](https:\u002F\u002Fcloud.google.com\u002Fgemini-enterprise): 面向企业用户的 Google AI 服务，目前可以免费使用。\n*   [**GitHub Copilot**](https:\u002F\u002Fgithub.com\u002Fcopilot): 由 GitHub 和 OpenAI 联合开发的 AI 代码补全工具。\n*   [**Kimi K2**](https:\u002F\u002Fwww.kimi.com\u002F): 一款国产 AI 模型，适用于多种常规任务。\n*   [**GLM**](https:\u002F\u002Fbigmodel.cn\u002F): 由智谱 AI 开发的国产大语言模型。\n*   [**Qwen**](https:\u002F\u002Fqwenlm.github.io\u002Fqwen-code-docs\u002Fzh\u002Fcli\u002F): 由阿里巴巴开发的 AI 模型，其 CLI 工具提供免费使用额度。\n\n### 开发与辅助工具\n\n*   [**Augment**](https:\u002F\u002Fapp.augmentcode.com\u002F): 提供强大的上下文引擎和提示词优化功能。\n*   [**Windsurf**](https:\u002F\u002Fwindsurf.com\u002F): 为新用户提供免费额度的 AI 开发工具。\n*   [**Ollama**](https:\u002F\u002Follama.com\u002F): 本地大模型管理工具，可通过命令行方便地拉取和运行开源模型。\n*   [**Mermaid Chart**](https:\u002F\u002Fwww.mermaidchart.com\u002F): 用于将文本描述转换为架构图、序列图等可视化图表。\n*   [**NotebookLM**](https:\u002F\u002Fnotebooklm.google.com\u002F): 一款用于 AI 解读资料、音频和生成思维导图的工具。\n*   [**Zread**](https:\u002F\u002Fzread.ai\u002F): AI 驱动的 GitHub 仓库阅读工具，有助于快速理解项目代码。\n*   [**tmux**](https:\u002F\u002Fgithub.com\u002Ftmux\u002Ftmux): 强大的终端复用工具，支持会话保持、分屏和后台任务，是服务器与多项目开发的理想选择。\n*   [**DBeaver**](https:\u002F\u002Fdbeaver.io\u002F): 一款通用数据库管理客户端，支持多种数据库，功能全面。\n\n### 资源与模板\n\n*   [**提示词库 (在线表格)**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1): 一个包含大量可直接复制使用的各类提示词的在线表格。\n*   [**第三方系统提示词学习库**](https:\u002F\u002Fgithub.com\u002Fx1xhlol\u002Fsystem-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。\n*   [**Skills 制作器**](https:\u002F\u002Fgithub.com\u002Fyusufkaraaslan\u002FSkill_Seekers): 可根据需求生成定制化 Skills 的工具。\n*   [**元提示词**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。\n*   [**通用项目架构模板**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTemplates%20and%20Resources\u002F通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。\n*   [**元技能：Skills 的 Skills**](.\u002Fi18n\u002Fzh\u002Fskills\u002Fclaude-skills\u002FSKILL.md): 用于生成 Skills 的元技能。\n*   [**tmux快捷键大全**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTutorials%20and%20Guides\u002Ftmux快捷键大全.md): tmux 的快捷键参考文档。\n*   [**LazyVim快捷键大全**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTutorials%20and%20Guides\u002FLazyVim快捷键大全.md): LazyVim 的快捷键参考文档。\n*   [**二哥的Java进阶之路**](https:\u002F\u002Fjavabetter.cn\u002F): 包含多种开发工具的详细配置教程。\n*   [**虚拟卡**](https:\u002F\u002Fwww.bybit.com\u002Fcards\u002F?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。\n\n---\n\n## 编码模型性能分级参考\n\n建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。\n\n*   **第一梯队**: `codex-5.1-max-xhigh`, `claude-opus-4.5-xhigh`, `gpt-5.2-xhigh`\n*   **第二梯队**: `claude-sonnet-4.5`, `kimi-k2-thinking`, `minimax-m2`, `glm-4.6`, `gemini-3.0-pro`, `gemini-2.5-pro`\n*   **第三梯队**: `qwen3`, `SWE`, `grok4`\n\n---\n\n## 📚 相关文档与资源\n\n*   **交流社区**:\n    *   [Telegram 交流群](https:\u002F\u002Ft.me\u002Fglue_coding)\n    *   [Telegram 频道](https:\u002F\u002Ft.me\u002Ftradecat_ai_channel)\n*   **个人分享**:\n    *   [我的学习经验](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002F学习经验.md)\n    *   [编程书籍推荐](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTemplates%20and%20Resources\u002F编程书籍推荐.md)\n*   **核心资源**:\n    *   [**元提示词库**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。\n    *   [**元技能 (Meta-Skill)**](.\u002Fi18n\u002Fzh\u002Fskills\u002Fclaude-skills\u002FSKILL.md): 用于生成 Skills 的 Skill。\n    *   [**技能库 (Skills)**](.\u002Fi18n\u002Fzh\u002Fskills): 可直接集成的模块化技能仓库。\n    *   [**技能生成器**](https:\u002F\u002Fgithub.com\u002Fyusufkaraaslan\u002FSkill_Seekers): 将任何资料转化为 Agent 可用技能的工具。\n    *   [**在线提示词数据库**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1): 包含数百个适用于各场景的用户及系统提示词的在线表格。\n    *   [**第三方系统提示词仓库**](https:\u002F\u002Fgithub.com\u002Fx1xhlol\u002Fsystem-prompts-and-models-of-ai-tools): 汇集了多种 AI 工具的系统提示词。\n*   **项目内部文档**:\n    *   [**prompts-library 工具说明**](.\u002Flibs\u002Fexternal\u002Fprompts-library\u002F): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。\n    *   [**coding_prompts 集合**](.\u002Fi18n\u002Fzh\u002Fprompts\u002Fcoding_prompts\u002F): 适用于 Vibe Coding 流程的专用提示词。\n    *   [**系统提示词构建原则**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002F系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。\n    *   [**开发经验总结**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002F开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。\n    *   [**通用项目架构模板**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTemplates%20and%20Resources\u002F通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。\n    *   [**Augment MCP 配置文档**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTutorials%20and%20Guides\u002Fauggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。\n    *   [**system_prompts 集合**](.\u002Fi18n\u002Fzh\u002Fprompts\u002Fsystem_prompts\u002F): 用于指导 AI 开发的系统提示词，包含多个版本的开发规范与思维框架。\n\n---\n\n### 项目目录结构概览\n\n本项目 `vibe-coding-cn` 的核心结构主要围绕知识管理、AI 提示词的组织与自动化展开。以下是经过整理和简化的目录树及各部分说明：\n\n```\n.\n├── CODE_OF_CONDUCT.md           # 社区行为准则，规范贡献者行为。\n├── CONTRIBUTING.md              # 贡献指南，说明如何为本项目做出贡献。\n├── GEMINI.md                    # AI 助手的上下文文档，包含项目概述、技术栈和文件结构。\n├── LICENSE                      # 开源许可证文件。\n├── Makefile                     # 项目自动化脚本，用于代码检查、构建等。\n├── README.md                    # 项目主文档，包含项目概览、使用指南、资源链接等。\n├── .gitignore                   # Git 忽略文件。\n├── AGENTS.md                    # AI 代理相关的文档或配置。\n├── CLAUDE.md                    # AI 助手的核心行为准则或配置。\n│\n├── i18n\u002Fzh\u002Fdocuments\u002F           # 存放各类说明文档、经验总结和配置详细说明。\n│   ├── Methodology and Principles\u002F # 方法论与原则\n│   ├── Templates and Resources\u002F    # 模板与资源\n│   └── Tutorials and Guides\u002F       # 教程与指南\n│\n├── libs\u002F                        # 通用库代码，用于项目内部模块化。\n│   ├── common\u002F                  # 通用功能模块。\n│   │   ├── models\u002F              # 模型定义。\n│   │   │   └── __init__.py\n│   │   └── utils\u002F               # 工具函数。\n│   │       └── backups\u002F         # 内部备份工具。\n│   ├── database\u002F                # 数据库相关模块。\n│   │   └── .gitkeep             # 占位文件，确保目录被 Git 跟踪。\n│   └── external\u002F                # 外部集成模块。\n│       ├── my-nvim\u002F             # 用户的 Neovim 配置。\n│       ├── prompts-library\u002F     # 提示词库管理工具（Excel-Markdown 转换）。\n│       │   ├── main.py          # 提示词库管理工具主入口。\n│       │   ├── scripts\u002F         # 包含 Excel 与 Markdown 互转脚本和配置。\n│       │   ├── prompt_excel\u002F    # 存放 Excel 格式的原始提示词数据。\n│       │   ├── prompt_docs\u002F     # 存放从 Excel 转换而来的 Markdown 提示词文档。\n│       │   └── ... (其他 prompts-library 内部文件)\n│       └── XHS-image-to-PDF-conversion\u002F # 小红书图片转PDF工具。\n│\n├── i18n\u002Fzh\u002Fprompts\u002F             # 集中存放所有类型的 AI 提示词。\n│   ├── assistant_prompts\u002F       # 辅助类提示词。\n│   ├── coding_prompts\u002F          # 专门用于编程和代码生成相关的提示词集合。\n│   │   └── ... (具体编程提示词文件)\n│   │\n│   ├── system_prompts\u002F          # AI 系统级提示词，用于设定 AI 行为和框架。\n│   │   └── ... (其他系统提示词)\n│   │\n│   └── user_prompts\u002F            # 用户自定义或常用提示词。\n│       ├── ASCII图生成.md         # ASCII 艺术图生成提示词。\n│       ├── 数据管道.md            # 数据管道处理提示词。\n│       └── ... (其他用户提示词)\n│\n├── i18n\u002Fzh\u002Fskills\u002F              # 集中存放所有类型的 skills 技能。\n    ├── claude-skills            # 生成 SKILL 的元 SKILL\n    │   ├── SKILL.md\n    │   └── ... (其他)\n    └── ... (与其他 skill)\n```\n\n---\n\n## 🖼️ 概览与演示\n\n一句话：Vibe Coding = **规划驱动 + 上下文固定 + AI 结对执行**，让「从想法到可维护代码」变成一条可审计的流水线，而不是一团无法迭代的巨石文件。\n\n**你能得到**\n- 成体系的提示词工具链：`i18n\u002Fzh\u002Fprompts\u002Fsystem_prompts\u002F` 约束 AI 行为边界，`i18n\u002Fzh\u002Fprompts\u002Fcoding_prompts\u002F` 提供需求澄清、计划、执行的全链路脚本。\n- 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。\n\n## ⚙️ 架构与工作流程\n\n核心资产映射：\n```\ni18n\u002Fzh\u002Fprompts\u002F\n  coding_prompts\u002F        # 需求澄清、计划、执行链的核心提示词\n  system_prompts\u002F        # 约束 AI 行为边界的系统级提示词\n  assistant_prompts\u002F     # 辅助\u002F配合型提示\n  user_prompts\u002F          # 可复用的用户侧提示词\ni18n\u002Fzh\u002Fdocuments\u002F\n  Templates and Resources\u002F代码组织.md, Templates and Resources\u002F通用项目架构模板.md, Methodology and Principles\u002F开发经验.md, Methodology and Principles\u002F系统提示词构建原则.md 等知识库\nbackups\u002F\n  一键备份.sh, 快速备份.py  # 本地\u002F远端快照脚本\n```\n\n```mermaid\ngraph TB\n  %% GitHub 兼容简化版（仅使用基础语法）\n\n  subgraph ext_layer[外部系统与数据源层]\n    ext_contrib[社区贡献者]\n    ext_sheet[Google 表格 \u002F 外部表格]\n    ext_md[外部 Markdown 提示词]\n    ext_api[预留：其他数据源 \u002F API]\n    ext_contrib --> ext_sheet\n    ext_contrib --> ext_md\n    ext_api --> ext_sheet\n  end\n\n  subgraph ingest_layer[数据接入与采集层]\n    excel_raw[prompt_excel\u002F*.xlsx]\n    md_raw[prompt_docs\u002F外部MD输入]\n    excel_to_docs[prompts-library\u002Fscripts\u002Fexcel_to_docs.py]\n    docs_to_excel[prompts-library\u002Fscripts\u002Fdocs_to_excel.py]\n    ingest_bus[标准化数据帧]\n    ext_sheet --> excel_raw\n    ext_md --> md_raw\n    excel_raw --> excel_to_docs\n    md_raw --> docs_to_excel\n    excel_to_docs --> ingest_bus\n    docs_to_excel --> ingest_bus\n  end\n\n  subgraph core_layer[数据处理与智能决策层 \u002F 核心]\n    ingest_bus --> validate[字段校验与规范化]\n    validate --> transform[格式映射转换]\n    transform --> artifacts_md[prompt_docs\u002F规范MD]\n    transform --> artifacts_xlsx[prompt_excel\u002F导出XLSX]\n    orchestrator[main.py · scripts\u002Fstart_convert.py] --> validate\n    orchestrator --> transform\n  end\n\n  subgraph consume_layer[执行与消费层]\n    artifacts_md --> catalog_coding[i18n\u002Fzh\u002Fprompts\u002Fcoding_prompts]\n    artifacts_md --> catalog_system[i18n\u002Fzh\u002Fprompts\u002Fsystem_prompts]\n    artifacts_md --> catalog_assist[i18n\u002Fzh\u002Fprompts\u002Fassistant_prompts]\n    artifacts_md --> catalog_user[i18n\u002Fzh\u002Fprompts\u002Fuser_prompts]\n    artifacts_md --> docs_repo[i18n\u002Fzh\u002Fdocuments\u002F*]\n    artifacts_md --> new_consumer[预留：其他下游渠道]\n    catalog_coding --> ai_flow[AI 结对编程流程]\n    ai_flow --> deliverables[项目上下文 \u002F 计划 \u002F 代码产出]\n  end\n\n  subgraph ux_layer[用户交互与接口层]\n    cli[CLI: python main.py] --> orchestrator\n    makefile[Makefile 任务封装] --> cli\n    readme[README.md 使用指南] --> cli\n  end\n\n  subgraph infra_layer[基础设施与横切能力层]\n    git[Git 版本控制] --> orchestrator\n    backups[backups\u002F一键备份.sh · backups\u002F快速备份.py] --> artifacts_md\n    deps[requirements.txt · scripts\u002Frequirements.txt] --> orchestrator\n    config[prompts-library\u002Fscripts\u002Fconfig.yaml] --> orchestrator\n    monitor[预留：日志与监控] --> orchestrator\n  end\n```\n\n---\n\n\u003Cdetails>\n\u003Csummary>📈 性能基准 (可选)\u003C\u002Fsummary>\n\n本仓库定位为「流程与提示词」而非性能型代码库，建议跟踪下列可观测指标（当前主要依赖人工记录，可在 `progress.md` 中打分\u002F留痕）：\n\n| 指标 | 含义 | 当前状态\u002F建议 |\n|:---|:---|:---|\n| 提示命中率 | 一次生成即满足验收的比例 | 待记录；每个任务完成后在 progress.md 记 0\u002F1 |\n| 周转时间 | 需求 → 首个可运行版本所需时间 | 录屏时标注时间戳，或用 CLI 定时器统计 |\n| 变更可复盘度 | 是否同步更新上下文\u002F进度\u002F备份 | 通过手工更新；可在 backups 脚本中加入 git tag\u002F快照 |\n| 例程覆盖 | 是否有最小可运行示例\u002F测试 | 建议每个示例项目保留 README+测试用例 |\n\n\u003C\u002Fdetails>\n\n---\n\n## 🗺️ 路线图\n\n```mermaid\ngantt\n    title 项目发展路线图\n    dateFormat YYYY-MM\n    section 近期 (2025)\n    补全演示GIF与示例项目: active, 2025-12, 15d\n    prompts 索引自动生成脚本: 2025-12, 10d\n    section 中期 (2026 Q1)\n    一键演示\u002F验证 CLI 工作流: 2026-01, 15d\n    备份脚本增加快照与校验: 2026-01, 10d\n    section 远期 (2026 Q1-Q2)\n    模板化示例项目集: 2026-02, 20d\n    多模型对比与评估基线: 2026-02, 20d\n```\n\n---\n\n## 🚀 入门指南（这里是原作者的，不是我写的，我更新了一下我认为最好的模型）\n要开始 Vibe Coding，你只需要以下两种工具之一：\n- **Claude Opus 4.5**，在 Claude Code 中使用\n- **gpt-5.1-codex.1-codex (xhigh)**，在 Codex CLI 中使用\n\n本指南同时适用于 CLI 终端版本和 VSCode 扩展版本（Codex 和 Claude Code 都有扩展，且界面更新）。\n\n*(注：本指南早期版本使用的是 **Grok 3**，后来切换到 **Gemini 2.5 Pro**，现在我们使用的是 **Claude 4.5**（或 **gpt-5.1-codex.1-codex (xhigh)**）)*\n\n*(注2：如果你想使用 Cursor，请查看本指南的 [1.1 版本](https:\u002F\u002Fgithub.com\u002FEnzeD\u002Fvibe-coding\u002Ftree\u002F1.1.1)，但我们认为它目前不如 Codex CLI 或 Claude Code 强大)*\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>⚙️ 完整设置流程\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>1. 游戏设计文档（Game Design Document）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 把你的游戏创意交给 **gpt-5.1-codex** 或 **Claude Opus 4.5**，让它生成一份简洁的 **游戏设计文档**，格式为 Markdown，文件名为 `game-design-document.md`。\n- 自己审阅并完善，确保与你的愿景一致。初期可以很简陋，目标是给 AI 提供游戏结构和意图的上下文。不要过度设计，后续会迭代。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>2. 技术栈与 \u003Ccode>CLAUDE.md\u003C\u002Fcode> \u002F \u003Ccode>Agents.md\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 让 **gpt-5.1-codex** 或 **Claude Opus 4.5** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。\n  - 要求它提出 **最简单但最健壮** 的技术栈。\n- 在终端中打开 **Claude Code** 或 **Codex CLI**，使用 `\u002Finit` 命令，它会读取你已创建的两个 .md 文件，生成一套规则来正确引导大模型。\n- **关键：一定要审查生成的规则。** 确保规则强调 **模块化**（多文件）和禁止 **单体巨文件**（monolith）。可能需要手动修改或补充规则。\n  - **极其重要：** 某些规则必须设为 **\"Always\"**（始终应用），确保 AI 在生成任何代码前都强制阅读。例如添加以下规则并标记为 \"Always\"：\n    > ```\n    > # 重要提示：\n    > # 写任何代码前必须完整阅读 memory-bank\u002F@architecture.md（包含完整数据库结构）\n    > # 写任何代码前必须完整阅读 memory-bank\u002F@game-design-document.md\n    > # 每完成一个重大功能或里程碑后，必须更新 memory-bank\u002F@architecture.md\n    > ```\n  - 其他（非 Always）规则要引导 AI 遵循你技术栈的最佳实践（如网络、状态管理等）。\n  - *如果想要代码最干净、项目最优化，这一整套规则设置是强制性的。*\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>3. 实施计划（Implementation Plan）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 将以下内容提供给 **gpt-5.1-codex** 或 **Claude Opus 4.5**：\n  - 游戏设计文档（`game-design-document.md`）\n  - 技术栈推荐（`tech-stack.md`）\n- 让它生成一份详细的 **实施计划**（Markdown 格式），包含一系列给 AI 开发者的分步指令。\n  - 每一步要小而具体。\n  - 每一步都必须包含验证正确性的测试。\n  - 严禁包含代码——只写清晰、具体的指令。\n  - 先聚焦于 **基础游戏**，完整功能后面再加。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>4. 记忆库（Memory Bank）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 新建项目文件夹，并在 VSCode 中打开。\n- 在项目根目录下创建子文件夹 `memory-bank`。\n- 将以下文件放入 `memory-bank`：\n  - `game-design-document.md`\n  - `tech-stack.md`\n  - `implementation-plan.md`\n  - `progress.md`（新建一个空文件，用于记录已完成步骤）\n  - `architecture.md`（新建一个空文件，用于记录每个文件的作用）\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>🎮 Vibe Coding 开发基础游戏\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n现在进入最爽的阶段！\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>确保一切清晰\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 在 VSCode 扩展中打开 **Codex** 或 **Claude Code**，或者在项目终端启动 Claude Code \u002F Codex CLI。\n- 提示词：阅读 `\u002Fmemory-bank` 里所有文档，`implementation-plan.md` 是否完全清晰？你有哪些问题需要我澄清，让它对你来说 100% 明确？\n- 它通常会问 9-10 个问题。全部回答完后，让它根据你的回答修改 `implementation-plan.md`，让计划更完善。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>你的第一个实施提示词\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 打开 **Codex** 或 **Claude Code**（扩展或终端）。\n- 提示词：阅读 `\u002Fmemory-bank` 所有文档，然后执行实施计划的第 1 步。我会负责跑测试。在我验证测试通过前，不要开始第 2 步。验证通过后，打开 `progress.md` 记录你做了什么供后续开发者参考，再把新的架构洞察添加到 `architecture.md` 中解释每个文件的作用。\n- **永远** 先用 \"Ask\" 模式或 \"Plan Mode\"（Claude Code 中按 `shift+tab`），确认满意后再让 AI 执行该步骤。\n- **极致 Vibe：** 安装 [Superwhisper](https:\u002F\u002Fsuperwhisper.com)，用语音随便跟 Claude 或 gpt-5.1-codex 聊天，不用打字。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>工作流\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 完成第 1 步后：\n  - 把改动提交到 Git（不会用就问 AI）。\n  - 新建聊天（`\u002Fnew` 或 `\u002Fclear`）。\n  - 提示词：阅读 memory-bank 所有文件，阅读 progress.md 了解之前的工作进度，然后继续实施计划第 2 步。在我验证测试前不要开始第 3 步。\n- 重复此流程，直到整个 `implementation-plan.md` 全部完成。\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>✨ 添加细节功能\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n恭喜！你已经做出了基础游戏！可能还很粗糙、缺少功能，但现在可以尽情实验和打磨了。\n- 想要雾效、后期处理、特效、音效？更好的飞机\u002F汽车\u002F城堡？绝美天空？\n- 每增加一个主要功能，就新建一个 `feature-implementation.md`，写短步骤+测试。\n- 继续增量式实现和测试。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>🐞 修复 Bug 与卡壳情况\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>常规修复\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 如果某个提示词失败或搞崩了项目：\n  - Claude Code 用 `\u002Frewind` 回退；用 gpt-5.1-codex 的话多提交 git，需要时 reset。\n- 报错处理：\n  - **JavaScript 错误：** 打开浏览器控制台（F12），复制错误，贴给 AI；视觉问题截图发给它。\n  - **懒人方案：** 安装 [BrowserTools](https:\u002F\u002Fbrowsertools.agentdesk.ai\u002Finstallation)，自动复制错误和截图。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>疑难杂症\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 实在卡住：\n  - 回退到上一个 git commit（`git reset`），换新提示词重试。\n- 极度卡壳：\n  - 用 [RepoPrompt](https:\u002F\u002Frepoprompt.com\u002F) 或 [uithub](https:\u002F\u002Fuithub.com\u002F) 把整个代码库合成一个文件，然后丢给 **gpt-5.1-codex 或 Claude** 求救。\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>💡 技巧与窍门\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Code & Codex 使用技巧\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **终端版 Claude Code \u002F Codex CLI：** 在 VSCode 终端里运行，能直接看 diff、喂上下文，不用离开工作区。\n- **Claude Code 的 `\u002Frewind`：** 迭代跑偏时一键回滚到之前状态。\n- **自定义命令：** 创建像 `\u002Fexplain $参数` 这样的快捷命令，触发提示词：“深入分析代码，彻底理解 $参数 是怎么工作的。理解完告诉我，我再给你任务。” 让模型先拉满上下文再改代码。\n- **清理上下文：** 经常用 `\u002Fclear` 或 `\u002Fcompact`（保留历史对话）。\n- **省时大法（风险自负）：** 用 `claude --dangerously-skip-permissions` 或 `codex --yolo`，彻底关闭确认弹窗。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>其他实用技巧\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **小修改：** 用 gpt-5.1-codex (medium)\n- **写顶级营销文案：** 用 Opus 4.1\n- **生成优秀 2D 精灵图：** 用 ChatGPT + Nano Banana\n- **生成音乐：** 用 Suno\n- **生成音效：** 用 ElevenLabs\n- **生成视频：** 用 Sora 2\n- **提升提示词效果：**\n  - 加一句：“慢慢想，不着急，重要的是严格按我说的做，执行完美。如果我表达不够精确请提问。”\n  - 在 Claude Code 中触发深度思考的关键词强度：`think` \u003C `think hard` \u003C `think harder` \u003C `ultrathink`。\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>❓ 常见问题解答 (FAQ)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **Q: 我在做应用不是游戏，这个流程一样吗？**\n  - **A:** 基本完全一样！把 GDD 换成 PRD（产品需求文档）即可。你也可以先用 v0、Lovable、Bolt.new 快速原型，再把代码搬到 GitHub，然后克隆到本地用本指南继续开发。\n\n- **Q: 你那个空战游戏的飞机模型太牛了，但我一个提示词做不出来！**\n  - **A:** 那不是一个提示词，是 ~30 个提示词 + 专门的 `plane-implementation.md` 文件引导的。用精准指令如“在机翼上为副翼切出空间”，而不是“做一个飞机”这种模糊指令。\n\n- **Q: 为什么现在 Claude Code 或 Codex CLI 比 Cursor 更强？**\n  - **A:** 完全看个人喜好。我们强调的是：Claude Code 能更好发挥 Claude Opus 4.5 的实力，Codex CLI 能更好发挥 gpt-5.1-codex 的实力，而 Cursor 对这两者的利用都不如原生终端版。终端版还能在任意 IDE、使用 SSH 远程服务器等场景工作，自定义命令、子代理、钩子等功能也能长期大幅提升开发质量和速度。最后，即使你只是低配 Claude 或 ChatGPT 订阅，也完全够用。\n\n- **Q: 我不会搭建多人游戏的服务器怎么办？**\n  - **A:** 问你的 AI。\n\n\u003C\u002Fdetails>\n\n---\n\n## 📞 联系方式\n\n-   **GitHub**: [tukuaiai](https:\u002F\u002Fgithub.com\u002Ftukuaiai)\n-   **Twitter \u002F X**: [123olp](https:\u002F\u002Fx.com\u002F123olp)\n-   **Telegram**: [@desci0](https:\u002F\u002Ft.me\u002Fdesci0)\n-   **Telegram 交流群**: [glue_coding](https:\u002F\u002Ft.me\u002Fglue_coding)\n-   **Telegram 频道**: [tradecat_ai_channel](https:\u002F\u002Ft.me\u002Ftradecat_ai_channel)\n-   **邮箱**: tukuai.ai@gmail.com (回复可能不及时)\n\n---\n\n## ✨ 支持项目\n\n救救孩子，感谢了，好人一生平安🙏🙏🙏\n\n-   **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey`\n-   **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau`\n-   **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`\n-   **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`\n-   **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm`\n-   **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e`\n-   **币安 UID**: `572155580`\n\n---\n\n### ✨ 贡献者\n\n感谢所有为本项目做出贡献的开发者！\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_c8730f7f7251.png\" \u002F>\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_47f6ff288bcf.png\" \u002F>\n\u003C\u002Fa>\n\n\u003Cp>特别鸣谢以下成员的宝贵贡献 (排名不分先后):\u003Cbr\u002F>\n\u003Ca href=\"https:\u002F\u002Fx.com\u002Fshao__meng\">@shao__meng\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002F0XBard_thomas\">@0XBard_thomas\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002FPluvio9yte\">@Pluvio9yte\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002FxDinoDeer\">@xDinoDeer\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002Fgeekbb\">@geekbb\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fx.com\u002FGitHub_Daily\">@GitHub_Daily\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## 🤝 参与贡献\n\n我们热烈欢迎各种形式的贡献。如果您对本项目有任何想法或建议，请随时开启一个 [Issue](https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fissues) 或提交一个 [Pull Request](https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fpulls)。\n\n在您开始之前，请花时间阅读我们的 [**贡献指南 (CONTRIBUTING.md)**](CONTRIBUTING.md) 和 [**行为准则 (CODE_OF_CONDUCT.md)**](CODE_OF_CONDUCT.md)。\n\n---\n\n## 📜 许可证\n\n本项目采用 [MIT](LICENSE) 许可证。\n\n---\n\n\u003Cdiv align=\"center\">\n\n**如果这个项目对您有帮助，请考虑为其点亮一颗 Star ⭐！**\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#tukuaiai\u002Fvibe-coding-cn&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=tukuaiai\u002Fvibe-coding-cn&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_20c46d421ba8.png\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_20c46d421ba8.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n---\n\n**由 [tukuaiai](https:\u002F\u002Fgithub.com\u002Ftukuaiai), [Nicolas Zullo](https:\u002F\u002Fx.com\u002FNicolasZu), 和 [123olp](https:\u002F\u002Fx.com\u002F123olp) 倾力打造**\n\n[⬆ 返回顶部](#vibe-coding-指南)\n\u003C\u002Fdiv>\n","\u003C!--\n-------------------------------------------------------------------------------\n  项目头部区域 (HEADER)\n-------------------------------------------------------------------------------\n-->\n\u003Cp align=\"center\">\n  \u003C!-- 建议尺寸: 1280x640px。可以使用 Canva, Figma 或 https:\u002F\u002Fbanners.beyondco.de\u002F 等工具制作 -->\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_b923c4bd685d.png\" alt=\"Vibe Coding 指南\" width=\"80px\">\n\u003C\u002Fp>\n\n\u003Cdiv align=\"center\">\n\n# Vibe Coding 指南\n\n**一个通过与 AI 结对编程，将想法变为现实的终极工作站**\n\n---\n\n\u003C!--\n  徽章区域 (BADGES)\n-->\n\u003C!-- 项目状态徽章 -->\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Factions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fmain.yml?label=%E6%9E%84%E5%BB%BA%E7%8A%B6%E6%80%81&style=for-the-badge\" alt=\"构建状态\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Freleases\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC&style=for-the-badge\" alt=\"最新版本\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E8%AE%B8%E5%8F%AF%E8%AF%81&style=for-the-badge\" alt=\"许可证\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Ftop\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E4%B8%BB%E8%A6%81%E8%AF%AD%E8%A8%80&style=for-the-badge\" alt=\"主要语言\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Fcode-size\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E4%BB%A3%E7%A0%81%E9%87%8F&style=for-the-badge\" alt=\"代码量\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fgraphs\u002Fcontributors\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Ftukuaiai\u002Fvibe-coding-cn?label=%E8%B4%A1%E7%8C%AE%E8%80%85&style=for-the-badge\" alt=\"贡献者\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Fglue_coding\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F聊天-Telegram-blue?style=for-the-badge&logo=telegram\" alt=\"交流群\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C!-- 多语言入口 -->\n\u003Cp>\n  \u003Ca href=\".\u002Fi18n\u002Fzh\u002FREADME.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-中文-red?style=for-the-badge\" alt=\"简体中文\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fen\u002FREADME.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-English-lightgrey?style=for-the-badge\" alt=\"English\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fhe\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-עברית-navy?style=for-the-badge\" alt=\"Hebrew\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Far\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-العربية-brown?style=for-the-badge\" alt=\"Arabic\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fbn\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-বাংলা-orange?style=for-the-badge\" alt=\"Bengali\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fde\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Deutsch-black?style=for-the-badge\" alt=\"Deutsch\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fes\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Español-yellow?style=for-the-badge\" alt=\"Español\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Ffa\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-فارسی-purple?style=for-the-badge\" alt=\"Farsi\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Ffr\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Français-blue?style=for-the-badge\" alt=\"Français\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fha\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Hausa-darkgreen?style=for-the-badge\" alt=\"Hausa\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fhi\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-हिन्दी-darkorange?style=for-the-badge\" alt=\"Hindi\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fid\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Bahasa%20Indonesia-teal?style=for-the-badge\" alt=\"Bahasa Indonesia\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fit\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Italiano-green?style=for-the-badge\" alt=\"Italiano\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fja\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-日本語-indigo?style=for-the-badge\" alt=\"日本語\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fko\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-한국어-slateblue?style=for-the-badge\" alt=\"한국어\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fms\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Bahasa%20Melayu-seagreen?style=for-the-badge\" alt=\"Bahasa Melayu\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fnl\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Nederlands-darkred?style=for-the-badge\" alt=\"Nederlands\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fpl\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Polski-crimson?style=for-the-badge\" alt=\"Polski\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fpt\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Português-darkslategray?style=for-the-badge\" alt=\"Português\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fru\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Русский-steelblue?style=for-the-badge\" alt=\"Русский\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fsw\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Kiswahili-forestgreen?style=for-the-badge\" alt=\"Swahili\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fta\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-தமிழ்-darkmagenta?style=for-the-badge\" alt=\"Tamil\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fth\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-ไทย-royalblue?style=for-the-badge\" alt=\"ภาษาไทย\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Ftr\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Türkçe-firebrick?style=for-the-badge\" alt=\"Türkçe\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fuk\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Українська-cornflowerblue?style=for-the-badge\" alt=\"Українська\">\u003C\u002Fa>\n  \u003Ca href \".\u002Fi18n\u002Fur\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-اردو-darkslateblue?style=for-the-badge\" alt=\"Urdu\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fvi\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-Tiếng%20Việt-darkgreen?style=for-the-badge\" alt=\"Tiếng Việt\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C!-- 资源直达 -->\n\u003Cp>\n  \u003Ca href=\".\u002Fi18n\u002Fzh\u002Fprompts\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F提示词-精选-purple?style=for-the-badge\" alt=\"提示词精选\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Fi18n\u002Fzh\u002Fskills\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fskills-技能大全-forestgreen?style=for-the-badge\" alt=\"skills技能大全\">\u003C\u002Fa>\n  \u003Ca href=\".\u002Flibs\u002Fexternal\u002Fprompts-library\u002Fprompt_docs\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F提示词-大全-orange?style=for-the-badge\" alt=\"提示词大全\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F提示词-在线表格(推荐)-blue?style=for-the-badge\" alt=\"提示词在线表格（推荐）\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fx1xhlol\u002Fsystem-prompts-and-models-of-ai-tools\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F系统提示词-仓库-slateblue?style=for-the-badge\" alt=\"系统提示词仓库\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n[📚 相关文档](#-相关文档与资源)\n[🚀 入门指南](#-入门指南)\n[⚙️ 完整设置流程](#️-完整设置流程)\n[📞 联系方式](#-联系方式)\n[✨ 支持项目](#-支持项目)\n[🤝 参与贡献](#-参与贡献)\n\n本仓库的 AI 解读链接：[zread.ai\u002Ftukuaiai\u002Fvibe-coding-cn](https:\u002F\u002Fzread.ai\u002Ftukuaiai\u002Fvibe-coding-cn\u002F1-overview)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🖼️ 概览\n\n**Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。\n\n> **核心理念**: *规划就是一切。* 谨慎让 AI 自主规划，否则你的代码库会变成一团无法管理的乱麻。\n\n**注意**：以下经验分享并非普遍适用，请在具体实践中结合场景，辩证采纳。\n\n## 🔑 元方法论 (Meta-Methodology)\n\n该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤：\n\n> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002FA%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)\n\n#### 1. 定义核心角色：\n\n*   **α-提示词 (生成器)**: 一个“母体”提示词，其唯一职责是**生成**其他提示词或技能。\n*   **Ω-提示词 (优化器)**: 另一个“母体”提示词，其唯一职责是**优化**其他提示词或技能。\n\n#### 2. 描述递归的生命周期：\n\n1.  **创生 (Bootstrap)**:\n    *   使用 AI 生成 `α-提示词` 和 `Ω-提示词` 的初始版本 (v1)。\n\n2.  **自省与进化 (Self-Correction & Evolution)**:\n    *   使用 `Ω-提示词 (v1)` **优化** `α-提示词 (v1)`，从而得到一个更强大的 `α-提示词 (v2)`。\n\n3.  **创造 (Generation)**:\n    *   使用**进化后的** `α-提示词 (v2)` 生成所有需要的目标提示词和技能。\n\n4.  **循环与飞跃 (Recursive Loop)**:\n    *   将新生成的、更强大的产物（甚至包括新版本的 `Ω-提示词`）反馈给系统，再次用于优化 `α-提示词`，从而启动持续进化。\n\n#### 3. 终极目标：\n\n通过此持续的**递归优化循环**，系统在每次迭代中实现**自我超越**，无限逼近预设的**预期状态**。\n\n## 🧭 道\n\n* **凡是 ai 能做的，就不要人工做**\n* **一切问题问 ai**\n* **目的主导：开发过程中的一切动作围绕\"目的\"展开**\n* **上下文是 vibe coding 的第一性要素，垃圾进，垃圾出**\n* **系统性思考，实体，链接，功能\u002F目的，三个维度**\n* **数据与函数即是编程的一切**\n* **输入，处理，输出刻画整个过程**\n* **多问 ai 是什么？，为什么？，怎么做？**\n* **先结构，后代码，一定要规划好框架，不然后面技术债还不完**\n* **奥卡姆剃刀定理，如无必要，勿增代码**\n* **帕累托法则，关注重要的那20%**\n* **逆向思考，先明确你的需求，从需求逆向构建代码**\n* **重复，多试几次，实在不行重新开个窗口，**\n* **专注，极致的专注可以击穿代码，一次只做一件事（神人除外）**\n\n\n## 🧩 法\n\n* **一句话目标 + 非目标**\n* **正交性，功能不要太重复了，（这个分场景）**\n* **能抄不写，不重复造轮子，先问 ai 有没有合适的仓库，下载下来改**\n* **一定要看官方文档，先把官方文档爬下来喂给 ai**\n* **按职责拆模块**\n* **接口先行，实现后补**\n* **一次只改一个模块**\n* **文档即上下文，不是事后补**\n\n## 🛠️ 术\n\n* 明确写清：**能改什么，不能改什么**\n* Debug 只给：**预期 vs 实际 + 最小复现**\n* 测试可交给 AI，**断言人审**\n* 代码一多就**切会话**\n\n## 📋 器\n\n### 集成开发环境 (IDE) & 终端\n\n*   [**Visual Studio Code**](https:\u002F\u002Fcode.visualstudio.com\u002F): 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。\n*   **虚拟环境 (.venv)**: 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。\n*   [**Cursor**](https:\u002F\u002Fcursor.com\u002F): 已经占领用户心智高地，人尽皆知。\n*   [**Warp**](https:\u002F\u002Fwww.warp.dev\u002F): 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。\n*   [**Neovim (nvim)**](https:\u002F\u002Fgithub.com\u002Fneovim\u002Fneovim): 一款高性能的现代化 Vim 编辑器，拥有丰富的插件生态，是键盘流开发者的首选。\n*   [**LazyVim**](https:\u002F\u002Fgithub.com\u002FLazyVim\u002FLazyVim): 基于 Neovim 的配置框架，预置了 LSP、代码补全、调试等全套功能，实现了开箱即用与深度定制的平衡。\n\n### AI 模型 & 服务\n\n*   [**Claude Opus 4.5**](https:\u002F\u002Fclaude.ai\u002Fnew): 性能强大的 AI 模型，通过 Claude Code 等平台提供服务，并支持 CLI 和 IDE 插件。\n*   [**gpt-5.1-codex.1-codex (xhigh)**](https:\u002F\u002Fchatgpt.com\u002Fcodex\u002F): 适用于处理大型项目和复杂逻辑的 AI 模型，可通过 Codex CLI 等平台使用。\n*   [**Droid**](https:\u002F\u002Ffactory.ai\u002Fnews\u002Fterminal-bench): 提供对 Claude Opus 4.5 等多种模型的 CLI 访问。\n*   [**Kiro**](https:\u002F\u002Fkiro.dev\u002F): 目前提供免费的 Claude Opus 4.5 模型访问，并提供客户端及 CLI 工具。\n*   [**Gemini CLI**](https:\u002F\u002Fgeminicli.com\u002F): 提供对 Gemini 模型的免费访问，适合执行脚本、整理文档和探索思路。\n*   [**antigravity**](https:\u002F\u002Fantigravity.google\u002F): 目前由 Google 提供的免费 AI 服务，支持使用 Claude Opus 4.5 和 Gemini 3.0 Pro。\n*   [**AI Studio**](https:\u002F\u002Faistudio.google.com\u002Fprompts\u002Fnew_chat): Google 提供的免费服务，支持使用 Gemini 3.0 Pro 和 Nano Banana。\n*   [**Gemini Enterprise**](https:\u002F\u002Fcloud.google.com\u002Fgemini-enterprise): 面向企业用户的 Google AI 服务，目前可以免费使用。\n*   [**GitHub Copilot**](https:\u002F\u002Fgithub.com\u002Fcopilot): 由 GitHub 和 OpenAI 联合开发的 AI 代码补全工具。\n*   [**Kimi K2**](https:\u002F\u002Fwww.kimi.com\u002F): 一款国产 AI 模型，适用于多种常规任务。\n*   [**GLM**](https:\u002F\u002Fbigmodel.cn\u002F): 由智谱 AI 开发的国产大语言模型。\n*   [**Qwen**](https:\u002F\u002Fqwenlm.github.io\u002Fqwen-code-docs\u002Fzh\u002Fcli\u002F): 由阿里巴巴开发的 AI 模型，其 CLI 工具提供免费使用额度。\n\n### 开发与辅助工具\n\n*   [**Augment**](https:\u002F\u002Fapp.augmentcode.com\u002F): 提供强大的上下文引擎和提示词优化功能。\n*   [**Windsurf**](https:\u002F\u002Fwindsurf.com\u002F): 为新用户提供免费额度的 AI 开发工具。\n*   [**Ollama**](https:\u002F\u002Follama.com\u002F): 本地大模型管理工具，可通过命令行方便地拉取和运行开源模型。\n*   [**Mermaid Chart**](https:\u002F\u002Fwww.mermaidchart.com\u002F): 用于将文本描述转换为架构图、序列图等可视化图表。\n*   [**NotebookLM**](https:\u002F\u002Fnotebooklm.google.com\u002F): 一款用于 AI 解读资料、音频和生成思维导图的工具。\n*   [**Zread**](https:\u002F\u002Fzread.ai\u002F): AI 驱动的 GitHub 仓库阅读工具，有助于快速理解项目代码。\n*   [**tmux**](https:\u002F\u002Fgithub.com\u002Ftmux\u002Ftmux): 强大的终端复用工具，支持会话保持、分屏和后台任务，是服务器与多项目开发的理想选择。\n*   [**DBeaver**](https:\u002F\u002Fdbeaver.io\u002F): 一款通用数据库管理客户端，支持多种数据库，功能全面。\n\n### 资源与模板\n\n*   [**提示词库 (在线表格)**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1): 一个包含大量可直接复制使用的各类提示词的在线表格。\n*   [**第三方系统提示词学习库**](https:\u002F\u002Fgithub.com\u002Fx1xhlol\u002Fsystem-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。\n*   [**Skills 制作器**](https:\u002F\u002Fgithub.com\u002Fyusufkaraaslan\u002FSkill_Seekers): 可根据需求生成定制化 Skills 的工具。\n*   [**元提示词**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。\n*   [**通用项目架构模板**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTemplates%20and%20Resources\u002F通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。\n*   [**元技能：Skills 的 Skills**](.\u002Fi18n\u002Fzh\u002Fskills\u002Fclaude-skills\u002FSKILL.md): 用于生成 Skills 的元技能。\n*   [**tmux快捷键大全**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTutorials%20and%20Guides\u002Ftmux快捷键大全.md): tmux 的快捷键参考文档。\n*   [**LazyVim快捷键大全**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTutorials%20and%20Guides\u002FLazyVim快捷键大全.md): LazyVim 的快捷键参考文档。\n*   [**二哥的Java进阶之路**](https:\u002F\u002Fjavabetter.cn\u002F): 包含多种开发工具的详细配置教程。\n*   [**虚拟卡**](https:\u002F\u002Fwww.bybit.com\u002Fcards\u002F?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。\n\n---\n\n## 编码模型性能分级参考\n\n建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。\n\n*   **第一梯队**: `codex-5.1-max-xhigh`, `claude-opus-4.5-xhigh`, `gpt-5.2-xhigh`\n*   **第二梯队**: `claude-sonnet-4.5`, `kimi-k2-thinking`, `minimax-m2`, `glm-4.6`, `gemini-3.0-pro`, `gemini-2.5-pro`\n*   **第三梯队**: `qwen3`, `SWE`, `grok4`\n\n---\n\n## 📚 相关文档与资源\n\n*   **交流社区**:\n    *   [Telegram 交流群](https:\u002F\u002Ft.me\u002Fglue_coding)\n    *   [Telegram 频道](https:\u002F\u002Ft.me\u002Ftradecat_ai_channel)\n*   **个人分享**:\n    *   [我的学习经验](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002F学习经验.md)\n    *   [编程书籍推荐](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTemplates%20and%20Resources\u002F编程书籍推荐.md)\n*   **核心资源**:\n    *   [**元提示词库**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。\n    *   [**元技能 (Meta-Skill)**](.\u002Fi18n\u002Fzh\u002Fskills\u002Fclaude-skills\u002FSKILL.md): 用于生成 Skills 的 Skill。\n    *   [**技能库 (Skills)**](.\u002Fi18n\u002Fzh\u002Fskills): 可直接集成的模块化技能仓库。\n    *   [**技能生成器**](https:\u002F\u002Fgithub.com\u002Fyusufkaraaslan\u002FSkill_Seekers): 将任何资料转化为 Agent 可用技能的工具。\n    *   [**在线提示词数据库**](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1): 包含数百个适用于各场景的用户及系统提示词的在线表格。\n    *   [**第三方系统提示词仓库**](https:\u002F\u002Fgithub.com\u002Fx1xhlol\u002Fsystem-prompts-and-models-of-ai-tools): 汇集了多种 AI 工具的系统提示词。\n*   **项目内部文档**:\n    *   [**prompts-library 工具说明**](.\u002Flibs\u002Fexternal\u002Fprompts-library\u002F): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。\n    *   [**coding_prompts 集合**](.\u002Fi18n\u002Fzh\u002Fprompts\u002Fcoding_prompts\u002F): 适用于 Vibe Coding 流程的专用提示词。\n    *   [**系统提示词构建原则**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002F系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。\n    *   [**开发经验总结**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FMethodology%20and%20Principles\u002F开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。\n    *   [**通用项目架构模板**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTemplates%20and%20Resources\u002F通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。\n    *   [**Augment MCP 配置文档**](.\u002Fi18n\u002Fzh\u002Fdocuments\u002FTutorials%20and%20Guides\u002Fauggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。\n    *   [**system_prompts 集合**](.\u002Fi18n\u002Fzh\u002Fprompts\u002Fsystem_prompts\u002F): 用于指导 AI 开发的系统提示词，包含多个版本的开发规范与思维框架。\n\n---\n\n### 项目目录结构概览\n\n本项目 `vibe-coding-cn` 的核心结构主要围绕知识管理、AI 提示词的组织与自动化展开。以下是经过整理和简化的目录树及各部分说明：\n\n```\n.\n├── CODE_OF_CONDUCT.md           # 社区行为准则，规范贡献者行为。\n├── CONTRIBUTING.md              # 贡献指南，说明如何为本项目做出贡献。\n├── GEMINI.md                    # AI 助手的上下文文档，包含项目概述、技术栈和文件结构。\n├── LICENSE                      # 开源许可证文件。\n├── Makefile                     # 项目自动化脚本，用于代码检查、构建等。\n├── README.md                    # 项目主文档，包含项目概览、使用指南、资源链接等。\n├── .gitignore                   # Git 忽略文件。\n├── AGENTS.md                    # AI 代理相关的文档或配置。\n├── CLAUDE.md                    # AI 助手的核心行为准则或配置。\n│\n├── i18n\u002Fzh\u002Fdocuments\u002F           # 存放各类说明文档、经验总结和配置详细说明。\n│   ├── Methodology and Principles\u002F # 方法论与原则\n│   ├── Templates and Resources\u002F    # 模板与资源\n│   └── Tutorials and Guides\u002F       # 教程与指南\n│\n├── libs\u002F                        # 通用库代码，用于项目内部模块化。\n│   ├── common\u002F                  # 通用功能模块。\n│   │   ├── models\u002F              # 模型定义。\n│   │   │   └── __init__.py\n│   │   └ató utils\u002F               # 工具函数。\n│   │       └ató backups\u002F         # 内部备份工具。\n│   ├── database\u002F                # 数据库相关模块。\n│   │   └ató .gitkeep             # 占位文件，确保目录被 Git 跟踪。\n│   └ató external\u002F                # 外部集成模块。\n│       ├── my-nvim\u002F             # 用户的 Neovim 配置。\n│       ├── prompts-library\u002F     # 提示词库管理工具（Excel-Markdown 转换）。\n│       │   ├── main.py          # 提示词库管理工具主入口。\n│       │   ├── scripts\u002F         # 包含 Excel 与 Markdown 互转脚本和配置。\n│       │   ├── prompt_excel\u002F    # 存放 Excel 格式的原始提示词数据。\n│       │   ├── prompt_docs\u002F     # 存放从 Excel 转换而来的 Markdown 提示词文档。\n│       │   ─ató ... (其他 prompts-library 内部文件)\n│       ─ató XHS-image-to-PDF-conversion\u002F # 小红书图片转PDF工具。\n│\n├ató i18n\u002Fzh\u002Fprompts\u002F             # 集中存放所有类型的 AI 提示词。\n│   ├── assistant_prompts\u002F       # 辅助类提示词。\n│   ├── coding_prompts\u002F          # 专门用于编程和代码生成相关的提示词集合。\n│   │   ─ató ... (具体编程提示词文件)\n│   │\n│   ├── system_prompts\u002F          # AI 系统级提示词，用于设定 AI 行为和框架。\n│   │   ─ató ... (其他系统提示词)\n│   │\n│   ─ató user_prompts\u002F            # 用户自定义或常用提示词。\n│       ├── ASCII图生成.md         # ASCII 艺术图生成提示词。\n│       ├── 数据管道.md            # 数据管道处理提示词。\n│       ─ató ... (其他用户提示词)\n│\n├ató i18n\u002Fzh\u002Fskills\u002F              # 集中存放所有类型的 skills 技能。\n    ├── claude-skills            # 生成 SKILL 的元 SKILL\n    │   ├── SKILL.md\n    │   ─ató ... (其他)\n    ─ató ... (与其他 skill)\n```\n\n---\n\n## 🖼️ 概览与演示\n\n一句话：Vibe Coding = **规划驱动 + 上下文固定 + AI 结对执行**，让「从想法到可维护代码」变成一条可审计的流水线，而不是一团无法迭代的巨石文件。\n\n**你能得到**\n- 成体系的提示词工具链：`i18n\u002Fzh\u002Fprompts\u002Fsystem_prompts\u002F` 约束 AI 行为边界，`i18n\u002Fzh\u002Fprompts\u002Fcoding_prompts\u002F` 提供需求澄清、计划、执行的全链路脚本。\n- 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。\n\n## ⚙️ 架构与工作流程\n\n核心资产映射：\n```\ni18n\u002Fzh\u002Fprompts\u002F\n  coding_prompts\u002F        # 需求澄清、计划、执行链的核心提示词\n  system_prompts\u002F        # 约束 AI 行为边界的系统级提示词\n  assistant_prompts\u002F     # 辅助\u002F配合型提示\n  user_prompts\u002F          # 可复用的用户侧提示词\ni18n\u002Fzh\u002Fdocuments\u002F\n  Templates and Resources\u002F代码组织.md, Templates and Resources\u002F通用项目架构模板.md, Methodology and Principles\u002F开发经验.md, Methodology and Principles\u002F系统提示词构建原则.md 等知识库\nbackups\u002F\n  一键备份.sh, 快速备份.py  # 本地\u002F远端快照脚本\n```\n\n```mermaid\ngraph TB\n  %% GitHub 兼容简化版（仅使用基础语法）\n\n  subgraph ext_layer[外部系统与数据源层]\n    ext_contrib[社区贡献者]\n    ext_sheet[Google 表格 \u002F 外部表格]\n    ext_md[外部 Markdown 提示词]\n    ext_api[预留：其他数据源 \u002F API]\n    ext_contrib --> ext_sheet\n    ext_contrib --> ext_md\n    ext_api --> ext_sheet\n  end\n\n  subgraph ingest_layer[数据接入与采集层]\n    excel_raw[prompt_excel\u002F*.xlsx]\n    md_raw[prompt_docs\u002F外部MD输入]\n    excel_to_docs[prompts-library\u002Fscripts\u002Fexcel_to_docs.py]\n    docs_to_excel[prompts-library\u002Fscripts\u002Fdocs_to_excel.py]\n    ingest_bus[标准化数据帧]\n    ext_sheet --> excel_raw\n    ext_md --> md_raw\n    excel_raw --> excel_to_docs\n    md_raw --> docs_to_excel\n    excel_to_docs --> ingest_bus\n    docs_to_excel --> ingest_bus\n  end\n\n  subgraph core_layer[数据处理与智能决策层 \u002F 核心]\n    ingest_bus --> validate[字段校验与规范化]\n    validate --> transform[格式映射转换]\n    transform --> artifacts_md[prompt_docs\u002F规范MD]\n    transform --> artifacts_xlsx[prompt_excel\u002F导出XLSX]\n    orchestrator[main.py · scripts\u002Fstart_convert.py] --> validate\n    orchestrator --> transform\n  end\n\n  subgraph consume_layer[执行与消费层]\n    artifacts_md --> catalog_coding[i18n\u002Fzh\u002Fprompts\u002Fcoding_prompts]\n    artifacts_md --> catalog_system[i18n\u002Fzh\u002Fprompts\u002Fsystem_prompts]\n    artifacts_md --> catalog_assist[i18n\u002Fzh\u002Fprompts\u002Fassistant_prompts]\n    artifacts_md --> catalog_user[i18n\u002Fzh\u002Fprompts\u002Fuser_prompts]\n    artifacts_md --> docs_repo[i18n\u002Fzh\u002Fdocuments\u002F*]\n    artifacts_md --> new_consumer[预留：其他下游渠道]\n    catalog_coding --> ai_flow[AI 结对编程流程]\n    ai_flow --> deliverables[项目上下文 \u002F 计划 \u002F 代码产出]\n  end\n\n  subgraph ux_layer[用户交互与接口层]\n    cli[CLI: python main.py] --> orchestrator\n    makefile[Makefile 任务封装] --> cli\n    readme[README.md 使用指南] --> cli\n  end\n\n  subgraph infra_layer[基础设施与横切能力层]\n    git[Git 版本控制] --> orchestrator\n    backups[backups\u002F一键备份.sh · backups\u002F快速备份.py] --> artifacts_md\n    deps[requirements.txt · scripts\u002Frequirements.txt] --> orchestrator\n    config[prompts-library\u002Fscripts\u002Fconfig.yaml] --> orchestrator\n    monitor[预留：日志与监控] --> orchestrator\n  end\n```\n\n---\n\n\u003Cdetails>\n\u003Csummary>📈 性能基准 (可选)\u003C\u002Fsummary>\n\n本仓库定位为「流程与提示词」而非性能型代码库，建议跟踪下列可观测指标（当前主要依赖人工记录，可在 `progress.md` 中打分\u002F留痕）：\n\n| 指标 | 含义 | 当前状态\u002F建议 |\n|:---|:---|:---|\n| 提示命中率 | 一次生成即满足验收的比例 | 待记录；每个任务完成后在 progress.md 记 0\u002F1 |\n| 周转时间 | 需求 → 首个可运行版本所需时间 | 录屏时标注时间戳，或用 CLI 定时器统计 |\n| 变更可复盘度 | 是否同步更新上下文\u002F进度\u002F备份 | 通过手工更新；可在 backups 脚本中加入 git tag\u002F快照 |\n| 例程覆盖 | 是否有最小可运行示例\u002F测试 | 建议每个示例项目保留 README+测试用例 |\n\n\u003C\u002Fdetails>\n\n---\n\n## 🗺️ 路线图\n\n```mermaid\ngantt\n    title 项目发展路线图\n    dateFormat YYYY-MM\n    section 近期 (2025)\n    补全演示GIF与示例项目: active, 2025-12, 15d\n    prompts 索引自动生成脚本: 2025-12, 10d\n    section 中期 (2026 Q1)\n    一键演示\u002F验证 CLI 工作流: 2026-01, 15d\n    备份脚本增加快照与校验: 2026-01, 10d\n    section 远期 (2026 Q1-Q2)\n    模板化示例项目集: 2026-02, 20d\n    多模型对比与评估基线: 2026-02, 20d\n```\n\n---\n\n## 🚀 入门指南（这里是原作者的，不是我写的，我更新了一下我认为最好的模型）\n要开始 Vibe Coding，你只需要以下两种工具之一：\n- **Claude Opus 4.5**，在 Claude Code 中使用\n- **gpt-5.1-codex.1-codex (xhigh)**，在 Codex CLI 中使用\n\n本指南同时适用于 CLI 终端版本和 VSCode 扩展版本（Codex 和 Claude Code 都有扩展，且界面更新）。\n\n*(注：本指南早期版本使用的是 **Grok 3**，后来切换到 **Gemini 2.5 Pro**，现在我们使用的是 **Claude 4.5**（或 **gpt-5.1-codex.1-codex (xhigh)**）)*\n\n*(注2：如果你想使用 Cursor，请查看本指南的 [1.1 版本](https:\u002F\u002Fgithub.com\u002FEnzeD\u002Fvibe-coding\u002Ftree\u002F1.1.1)，但我们认为它目前不如 Codex CLI 或 Claude Code 强大)*\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>⚙️ 完整设置流程\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>1. 游戏设计文档（Game Design Document）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 把你的游戏创意交给 **gpt-5.1-codex** 或 **Claude Opus 4.5**，让它生成一份简洁的 **游戏设计文档**，格式为 Markdown，文件名为 `game-design-document.md`。\n- 自己审阅并完善，确保与你的愿景一致。初期可以很简陋，目标是给 AI 提供游戏结构和意图的上下文。不要过度设计，后续会迭代。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>2. 技术栈与 \u003Ccode>CLAUDE.md\u003C\u002Fcode> \u002F \u003Ccode>Agents.md\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 让 **gpt-5.1-codex** 或 **Claude Opus 4.5** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。\n  - 要求它提出 **最简单但最健壮** 的技术栈。\n- 在终端中打开 **Claude Code** 或 **Codex CLI**，使用 `\u002Finit` 命令，它会读取你已创建的两个 .md 文件，生成一套规则来正确引导大模型。\n- **关键：一定要审查生成的规则。** 确保规则强调 **模块化**（多文件）和禁止 **单体巨文件**（monolith）。可能需要手动修改或补充规则。\n  - **极其重要：** 某些规则必须设为 **\"Always\"**（始终应用），确保 AI 在生成任何代码前都强制阅读。例如添加以下规则并标记为 \"Always\"：\n    > ```\n    > # 重要提示：\n    > # 写任何代码前必须完整阅读 memory-bank\u002F@architecture.md（包含完整数据库结构）\n    > # 写任何代码前必须完整阅读 memory-bank\u002F@game-design-document.md\n    > # 每完成一个重大功能或里程碑后，必须更新 memory-bank\u002F@architecture.md\n    > ```\n  - 其他（非 Always）规则要引导 AI 遵循你技术栈的最佳实践（如网络、状态管理等）。\n  - *如果想要代码最干净、项目最优化，这一整套规则设置是强制性的。*\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>3. 实施计划（Implementation Plan）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 将以下内容提供给 **gpt-5.1-codex** 或 **Claude Opus 4.5**：\n  - 游戏设计文档（`game-design-document.md`）\n  - 技术栈推荐（`tech-stack.md`）\n- 让它生成一份详细的 **实施计划**（Markdown 格式），包含一系列给 AI 开发者的分步指令。\n  - 每一步要小而具体。\n  - 每一步都必须包含验证正确性的测试。\n  - 严禁包含代码——只写清晰、具体的指令。\n  - 先聚焦于 **基础游戏**，完整功能后面再加。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>4. 记忆库（Memory Bank）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 新建项目文件夹，并在 VSCode 中打开。\n- 在项目根目录下创建子文件夹 `memory-bank`。\n- 将以下文件放入 `memory-bank`：\n  - `game-design-document.md`\n  - `tech-stack.md`\n  - `implementation-plan.md`\n  - `progress.md`（新建一个空文件，用于记录已完成步骤）\n  - `architecture.md`（新建一个空文件，用于记录每个文件的作用）\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>🎮 Vibe Coding 开发基础游戏\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n现在进入最爽的阶段！\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>确保一切清晰\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 在 VSCode 扩展中打开 **Codex** 或 **Claude Code**，或者在项目终端启动 Claude Code \u002F Codex CLI。\n- 提示词：阅读 `\u002Fmemory-bank` 里所有文档，`implementation-plan.md` 是否完全清晰？你有哪些问题需要我澄清，让它对你来说 100% 明确？\n- 它通常会问 9-10 个问题。全部回答完后，让它根据你的回答修改 `implementation-plan.md`，让计划更完善。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>你的第一个实施提示词\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 打开 **Codex** 或 **Claude Code**（扩展或终端）。\n- 提示词：阅读 `\u002Fmemory-bank` 所有文档，然后执行实施计划的第 1 步。我会负责跑测试。在我验证测试通过前，不要开始第 2 步。验证通过后，打开 `progress.md` 记录你做了什么供后续开发者参考，再把新的架构洞察添加到 `architecture.md` 中解释每个文件的作用。\n- **永远** 先用 \"Ask\" 模式或 \"Plan Mode\"（Claude Code 中按 `shift+tab`），确认满意后再让 AI 执行该步骤。\n- **极致 Vibe：** 安装 [Superwhisper](https:\u002F\u002Fsuperwhisper.com)，用语音随便跟 Claude 或 gpt-5.1-codex 聊天，不用打字。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>工作流\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 完成第 1 步后：\n  - 把改动提交到 Git（不会用就问 AI）。\n  - 新建聊天（`\u002Fnew` 或 `\u002Fclear`）。\n  - 提示词：阅读 memory-bank 所有文件，阅读 progress.md 了解之前的工作进度，然后继续实施计划第 2 步。在我验证测试前不要开始第 3 步。\n- 重复此流程，直到整个 `implementation-plan.md` 全部完成。\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>✨ 添加细节功能\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n恭喜！你已经做出了基础游戏！可能还很粗糙、缺少功能，但现在可以尽情实验和打磨了。\n- 想要雾效、后期处理、特效、音效？更好的飞机\u002F汽车\u002F城堡？绝美天空？\n- 每增加一个主要功能，就新建一个 `feature-implementation.md`，写短步骤+测试。\n- 继续增量式实现和测试。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>🐞 修复 Bug 与卡壳情况\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>常规修复\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 如果某个提示词失败或搞崩了项目：\n  - Claude Code 用 `\u002Frewind` 回退；用 gpt-5.1-codex 的话多提交 git，需要时 reset。\n- 报错处理：\n  - **JavaScript 错误：** 打开浏览器控制台（F12），复制错误，贴给 AI；视觉问题截图发给它。\n  - **懒人方案：** 安装 [BrowserTools](https:\u002F\u002Fbrowsertools.agentdesk.ai\u002Finstallation)，自动复制错误和截图。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>疑难杂症\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 实在卡住：\n  - 回退到上一个 git commit（`git reset`），换新提示词重试。\n- 极度卡壳：\n  - 用 [RepoPrompt](https:\u002F\u002Frepoprompt.com\u002F) 或 [uithub](https:\u002F\u002Fuithub.com\u002F) 把整个代码库合成一个文件，然后丢给 **gpt-5.1-codex 或 Claude** 求救。\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>💡 技巧与窍门\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Code & Codex 使用技巧\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **终端版 Claude Code \u002F Codex CLI：** 在 VSCode 终端里运行，能直接看 diff、喂上下文，不用离开工作区。\n- **Claude Code 的 `\u002Frewind`：** 迭代跑偏时一键回滚到之前状态。\n- **自定义命令：** 创建像 `\u002Fexplain $参数` 这样的快捷命令，触发提示词：“深入分析代码，彻底理解 $参数 是怎么工作的。理解完告诉我，我再给你任务。” 让模型先拉满上下文再改代码。\n- **清理上下文：** 经常用 `\u002Fclear` 或 `\u002Fcompact`（保留历史对话）。\n- **省时大法（风险自负）：** 用 `claude --dangerously-skip-permissions` 或 `codex --yolo`，彻底关闭确认弹窗。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>其他实用技巧\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **小修改：** 用 gpt-5.1-codex (medium)\n- **写顶级营销文案：** 用 Opus 4.1\n- **生成优秀 2D 精灵图：** 用 ChatGPT + Nano Banana\n- **生成音乐：** 用 Suno\n- **生成音效：** 用 ElevenLabs\n- **生成视频：** 用 Sora 2\n- **提升提示词效果：**\n  - 加一句：“慢慢想，不着急，重要的是严格按我说的做，执行完美。如果我表达不够精确请提问。”\n  - 在 Claude Code 中触发深度思考的关键词强度：`think` \u003C `think hard` \u003C `think harder` \u003C `ultrathink`。\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>❓ 常见问题解答 (FAQ)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- **Q: 我在做应用不是游戏，这个流程一样吗？**\n  - **A:** 基本完全一样！把 GDD 换成 PRD（产品需求文档）即可。你也可以先用 v0、Lovable、Bolt.new 快速原型，再把代码搬到 GitHub，然后克lon到本地用本指南继续开发。\n\n- **Q: 你那个空战游戏的飞机模型太牛了，但我一个提示词做不出来！**\n  - **A:** 那不是一个提示词，是 ~30 个提示词 + 专门的 `plane-implementation.md` 文件引导的。用精准指令如“在机翼上为副翼切出空间”，而不是“做一个飞机”这种模糊指令。\n\n- **Q: 为什么现在 Claude Code 或 Codex CLI 比 Cursor 更强？**\n  - **A:** 完全看个人喜好。我们强调的是：Claude Code 能更好发挥 Claude Opus 4.5 的实力，Codex CLI 能更好发挥 gpt-5.1-codex 的实力，而 Cursor 对这两者的利用都不如原生终端版。终端版还能在任意 IDE、使用 SSH 远程服务器等场景工作，自定义命令、子代理、钩子等功能也能长期大幅提升开发质量和速度。最后，即使你只是低配 Claude 或 ChatGPT 订阅，也完全够用。\n\n- **Q: 我不会搭建多人游戏的服务器怎么办？**\n  - **A:** 问你的 AI。\n\n\u003C\u002Fdetails>\n\n---\n\n## 📞 联系方式\n\n-   **GitHub**: [tukuaiai](https:\u002F\u002Fgithub.com\u002Ftukuaiai)\n-   **Twitter \u002F X**: [123olp](https:\u002F\u002Fx.com\u002F123olp)\n-   **Telegram**: [@desci0](https:\u002F\u002Ft.me\u002Fdesci0)\n-   **Telegram 交流群**: [glue_coding](https:\u002F\u002Ft.me\u002Fglue_coding)\n-   **Telegram 频道**: [tradecat_ai_channel](https:\u002F\u002Ft.me\u002Ftradecat_ai_channel)\n-   **邮箱**: tukuai.ai@gmail.com (回复可能不及时)\n\n---\n\n## ✨ 支持项目\n\n救救孩子，感谢了，好人一生平安🙏🙏🙏\n\n-   **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey`\n-   **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau`\n-   **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`\n-   **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`\n-   **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm`\n-   **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e`\n-   **币安 UID**: `572155580`\n\n---\n\n### ✨ 贡献者\n\n感谢所有为本项目做出贡献的开发者！\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_c8730f7f7251.png\" \u002F>\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_47f6ff288bcf.png\" \u002F>\n\u003C\u002Fa>\n\n\u003Cp>特别鸣谢以下成员的宝贵贡献 (排名不分先后):\u003Cbr\u002F>\n\u003Ca href=\"https:\u002F\u002Fx.com\u002Fshao__meng\">@shao__meng\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002F0XBard_thomas\">@0XBard_thomas\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002FPluvio9yte\">@Pluvio9yte\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002FxDinoDeer\">@xDinoDeer\u003C\u002Fa> |\n\u003Ca href=\"https:\u002F\u002Fx.com\u002Fgeekbb\">@geekbb\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fx.com\u002FGitHub_Daily\">@GitHub_Daily\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## 🤝 参与贡献\n\n我们热烈欢迎各种形式的贡献。如果您对本项目有任何想法或建议，请随时开启一个 [Issue](https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fissues) 或提交一个 [Pull Request](https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn\u002Fpulls)。\n\n在您开始之前，请花时间阅读我们的 [**贡献指南 (CONTRIBUTING.md)**](CONTRIBUTING.md) 和 [**行为准则 (CODE_OF_CONDUCT.md)**](CODE_OF_CONDUCT.md)。\n\n---\n\n## 📜 许可证\n\n本项目采用 [MIT](LICENSE) 许可证。\n\n---\n\n\u003Cdiv align=\"center\">\n\n**如果这个项目对您有帮助，请考虑为其点亮一颗 Star ⭐！**\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#tukuaiai\u002Fvibe-coding-cn&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=tukuaiai\u002Fvibe-coding-cn&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_20c46d421ba8.png\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_readme_20c46d421ba8.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n---\n\n**由 [tukuaiai](https:\u002F\u002Fgithub.com\u002Ftukuaiai), [Nicolas Zullo](https:\u002F\u002Fx.com\u002FNicolasZu), 和 [123olp](https:\u002F\u002Fx.com\u002F123olp) 倾力打造**\n\n[⬆ 返回顶部](#vibe-coding-指南)\n\u003C\u002Fdiv>","# Vibe Coding 快速上手指南\n\n本指南旨在帮助开发者快速搭建基于 **Vibe Coding** 理念的 AI 结对编程环境，将想法高效转化为现实。核心理念是\"**规划驱动**\"与\"**模块化**\"，避免让 AI 自主规划导致代码混乱。\n\n## 🌍 环境准备\n\n在开始之前，请确保你的开发环境满足以下基本要求。推荐优先使用国内镜像源以提升下载速度。\n\n### 系统要求\n*   **操作系统**: Windows 10\u002F11, macOS (Intel\u002FApple Silicon), 或 Linux (Ubuntu 20.04+)\n*   **内存**: 建议 8GB 以上（运行本地模型或大型 IDE 插件时建议 16GB+）\n*   **网络**: 稳定的互联网连接（访问 AI 模型服务必需）\n\n### 前置依赖\n请安装以下基础工具：\n\n1.  **Git**: 版本控制工具。\n    *   国内加速下载：[清华大学开源软件镜像站](https:\u002F\u002Fmirrors.tuna.tsinghua.edu.cn\u002Fhelp\u002Fgit\u002F)\n2.  **Python 3.9+**: 大多数 AI 工具和脚本的基础。\n    *   国内加速下载：[PyTorch 镜像站 Python 索引](https:\u002F\u002Fmirror.tuna.tsinghua.edu.cn\u002Fhelp\u002Fpython\u002F) 或使用 `pyenv` 管理。\n3.  **Node.js (可选)**: 部分前端工具链需要。\n    *   国内加速下载：[淘宝 Node.js 镜像](https:\u002F\u002Fnpmmirror.com\u002Fmirrors\u002Fnode\u002F)\n\n### 推荐核心工具\n根据 Vibe Coding 理念，推荐以下组合以获得最佳体验：\n*   **IDE**: [Visual Studio Code](https:\u002F\u002Fcode.visualstudio.com\u002F) 或 [Cursor](https:\u002F\u002Fcursor.com\u002F) (AI 原生编辑器)。\n*   **终端**: [Warp](https:\u002F\u002Fwww.warp.dev\u002F) (集成 AI) 或系统自带终端 + `tmux`。\n*   **包管理器**: 推荐使用 `pip` 配合国内镜像源。\n\n---\n\n## 🚀 安装步骤\n\n本仓库主要包含方法论、提示词库（Prompts）和技能库（Skills），无需复杂的编译安装。核心在于配置你的开发工具和获取资源。\n\n### 1. 克隆项目仓库\n使用 Git 将本指南及资源库下载到本地。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Fvibe-coding-cn.git\ncd vibe-coding-cn\n```\n\n> **提示**: 如果下载速度慢，可使用国内镜像加速（如适用）或手动下载 ZIP 包解压。\n\n### 2. 配置 Python 虚拟环境 (推荐)\n为隔离项目依赖，建议创建虚拟环境。\n\n```bash\npython -m venv .venv\n\n# Windows 激活\n.venv\\Scripts\\activate\n\n# macOS \u002F Linux 激活\nsource .venv\u002Fbin\u002Factivate\n```\n\n### 3. 安装辅助工具 (可选)\n如果你需要使用本地模型或特定 CLI 工具，可参考以下安装命令：\n\n*   **安装 Ollama (本地大模型管理)**:\n    ```bash\n    # macOS \u002F Linux\n    curl -fsSL https:\u002F\u002Follama.com\u002Finstall.sh | sh\n    \n    # Windows: 请访问官网下载安装包\n    ```\n\n*   **配置 pip 国内镜像源 (永久生效)**:\n    ```bash\n    pip config set global.index-url https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n    ```\n\n### 4. 导入提示词与技能\n本项目的核心价值在于 `prompts` 和 `skills` 目录。\n*   **浏览资源**: 直接查看 `.\u002Fi18n\u002Fzh\u002Fprompts\u002F` 和 `.\u002Fi18n\u002Fzh\u002Fskills\u002F` 目录下的 Markdown 文件。\n*   **在线表格**: 推荐直接访问项目提供的 [提示词在线表格](https:\u002F\u002Fdocs.google.com\u002Fspreadsheets\u002Fd\u002F1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU\u002Fedit?gid=2093180351#gid=2093180351&range=A1) 复制所需内容。\n\n---\n\n## 💻 基本使用\n\nVibe Coding 不是一款单一的软件，而是一套**工作流**。以下是基于该理念的最简启动示例。\n\n### 第一步：设定目标与规划 (道)\n在与 AI 对话前，先明确“一句话目标”和“非目标”。不要直接让 AI 写代码，先让它做规划。\n\n**示例提示词 (复制到 Cursor\u002FClaude\u002FChatGPT):**\n```text\n# 角色\n你是一位资深的全栈架构师，擅长通过规划驱动开发。\n\n# 目标\n我要构建一个基于 Python 的简易待办事项 (Todo) API，支持增删改查。\n\n# 非目标\n- 不需要前端界面\n- 不需要用户认证系统\n- 暂时不考虑 Docker 部署\n\n# 任务\n1. 请分析需求，设计模块结构（实体、链接、功能）。\n2. 输出项目目录结构树。\n3. 定义核心接口文档（Input\u002FProcess\u002FOutput）。\n4. 等待我确认后再开始编写具体代码。\n```\n\n### 第二步：迭代开发与优化 (法 & 术)\n遵循“接口先行，实现后补”和“一次只改一个模块”的原则。\n\n1.  **生成代码**: 确认规划后，指示 AI 生成具体模块代码。\n    ```text\n    请根据刚才规划的目录结构，先实现 `models.py` 和 `database.py`。\n    注意：只修改这两个文件，不要变动其他未提及的文件。\n    ```\n\n2.  **调试修复**: 遇到报错时，提供“预期 vs 实际”及最小复现步骤。\n    ```text\n    [错误信息]: FileNotFoundError: ...\n    [预期]: 程序应自动创建数据库文件。\n    [实际]: 程序因路径不存在崩溃。\n    [最小复现]: 运行 `python main.py` 即触发。\n    请修复此问题，并解释原因。\n    ```\n\n3.  **上下文管理**: 当对话过长或代码量过大时，**开启新会话**，并将当前核心代码片段和新指令作为上下文输入，避免 AI 迷失。\n\n### 第三步：利用元方法论进化 (进阶)\n利用项目中的 `α-提示词` (生成器) 和 `Ω-提示词` (优化器) 概念，不断优化你的工作流。\n\n*   **操作**: 将你自己写的提示词发给 AI，要求其扮演 `Ω-提示词` 进行优化。\n    ```text\n    你是一个提示词优化专家 (Ω-Prompt)。请分析以下我使用的提示词，指出其逻辑漏洞，并生成一个更强大、更清晰的 v2 版本：\n    \n    [在此粘贴你的旧提示词]\n    ```\n\n通过以上步骤，你将建立起一套高效、可控的 AI 结对编程流程，真正实现“丝滑地将想法变为现实”。","一位独立开发者希望在周末快速构建一个具备多语言支持的个人博客系统，但受限于前端框架的复杂配置和国际化（i18n）文件的繁琐编写，项目进度一度停滞。\n\n### 没有 vibe-coding-cn 时\n- **环境搭建耗时**：需要手动查阅文档配置 React 或 Vue 的多语言路由，仅初始化项目就花费了整整一天。\n- **翻译工作繁重**：面对 README 中展示的十几种语言支持需求，手动创建和维护数十个 JSON 翻译文件极易出错且枯燥。\n- **代码逻辑割裂**：在业务逻辑代码与静态资源文件间频繁切换，导致思路中断，难以保持“心流”状态。\n- **调试效率低下**：遇到语言包加载失败或键值不匹配时，需逐行排查代码，缺乏智能提示和自动修复建议。\n\n### 使用 vibe-coding-cn 后\n- **一键启动项目**：通过自然语言描述需求，vibe-coding-cn 自动生成包含完整多语言路由架构的项目骨架，将初始化时间缩短至分钟级。\n- **智能国际化生成**：直接指令工具生成涵盖中文、英文、日文等十余种语言的完整翻译文件，自动处理键值对应，确保零遗漏。\n- **沉浸式结对编程**：vibe-coding-cn 作为实时搭档，在编写核心功能时同步更新相关资源文件，让开发者全程专注于业务逻辑而非琐碎配置。\n- **即时错误修正**：当出现配置冲突时，工具主动识别并提供修复方案，自动同步更新受影响的代码块，大幅降低调试成本。\n\nvibe-coding-cn 将开发者从繁琐的配置与重复劳动中解放出来，真正实现了通过自然语言交互将创意瞬间转化为多语言就绪的现实产品。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F2025Emma_vibe-coding-cn_cf854ea0.png","2025Emma","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002F2025Emma_7c1d4c8e.jpg","https:\u002F\u002Fgithub.com\u002F2025Emma",[76,80,84],{"name":77,"color":78,"percentage":79},"Python","#3572A5",54.6,{"name":81,"color":82,"percentage":83},"Shell","#89e051",44.1,{"name":85,"color":86,"percentage":87},"Makefile","#427819",1.3,19225,2077,"2026-04-13T16:09:14","MIT",1,"未说明",{"notes":95,"python":93,"dependencies":96},"本项目为'Vibe Coding 指南’，主要包含方法论、提示词库、技能大全及工具推荐列表，并非一个需要本地安装运行的单一软件或模型。文中提到的工具（如 Cursor, VS Code, Ollama, Claude CLI 等）需单独安装。若使用文中推荐的本地模型工具（如 Ollama），其硬件需求取决于用户选择的具体模型大小。",[93],[13],"2026-03-27T02:49:30.150509","2026-04-14T05:03:11.094568",[],[]]