|
|
1 ヶ月 前 | |
|---|---|---|
| .github | 1 ヶ月 前 | |
| i18n | 1 ヶ月 前 | |
| libs | 1 ヶ月 前 | |
| .gitignore | 1 ヶ月 前 | |
| AGENTS.md | 1 ヶ月 前 | |
| CODE_OF_CONDUCT.md | 1 ヶ月 前 | |
| CONTRIBUTING.md | 1 ヶ月 前 | |
| LICENSE | 1 ヶ月 前 | |
| Makefile | 1 ヶ月 前 | |
| README.md | 1 ヶ月 前 |
完全新手?按顺序完成以下步骤:
Vibe Coding 是一个与 AI 结对编程的终极工作流程,旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程,强调以规划驱动和模块化为核心,避免让 AI 失控导致项目混乱。
核心理念: 规划就是一切。 谨慎让 AI 自主规划,否则你的代码库会变成一团无法管理的乱麻。
注意:以下经验分享并非普遍适用,请在具体实践中结合场景,辩证采纳。
该思想的核心是构建一个能够自我优化的 AI 系统。其递归本质可分解为以下步骤:
延伸阅读:A Formalization of Recursive Self-Optimizing Generative Systems
创生 (Bootstrap):
α-提示词 和 Ω-提示词 的初始版本 (v1)。自省与进化 (Self-Correction & Evolution):
Ω-提示词 (v1) 优化 α-提示词 (v1),从而得到一个更强大的 α-提示词 (v2)。创造 (Generation):
α-提示词 (v2) 生成所有需要的目标提示词和技能。循环与飞跃 (Recursive Loop):
Ω-提示词)反馈给系统,再次用于优化 α-提示词,从而启动持续进化。通过此持续的递归优化循环,系统在每次迭代中实现自我超越,无限逼近预设的预期状态。
Local History 插件对项目版本管理尤为便捷。建议只选择第一梯队模型处理复杂任务,以确保最佳效果与效率。
codex-5.1-max-xhigh, claude-opus-4.5-xhigh, gpt-5.2-xhighclaude-sonnet-4.5, kimi-k2-thinking, minimax-m2, glm-4.6, gemini-3.0-pro, gemini-2.5-proqwen3, SWE, grok4本项目 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/ # 存放各类说明文档、经验总结和配置详细说明。
│ ├── 方法论与原则/ # 方法论与原则
│ ├── 模板与资源/ # 模板与资源
│ └── 教程与指南/ # 教程与指南
│
├── 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工具。
│
├── i18n/zh/prompts/ # 集中存放所有类型的 AI 提示词。
│ ├── assistant_prompts/ # 辅助类提示词。
│ ├── coding_prompts/ # 专门用于编程和代码生成相关的提示词集合。
│ │ └── ... (具体编程提示词文件)
│ │
│ ├── system_prompts/ # AI 系统级提示词,用于设定 AI 行为和框架。
│ │ └── ... (其他系统提示词)
│ │
│ └── user_prompts/ # 用户自定义或常用提示词。
│ ├── ASCII图生成.md # ASCII 艺术图生成提示词。
│ ├── 数据管道.md # 数据管道处理提示词。
│ └── ... (其他用户提示词)
│
├── i18n/zh/skills/ # 集中存放所有类型的 skills 技能。
├── claude-skills # 生成 SKILL 的元 SKILL
│ ├── SKILL.md
│ └── ... (其他)
└── ... (与其他 skill)
一句话:Vibe Coding = 规划驱动 + 上下文固定 + AI 结对执行,让「从想法到可维护代码」变成一条可审计的流水线,而不是一团无法迭代的巨石文件。
你能得到
i18n/zh/prompts/system_prompts/ 约束 AI 行为边界,i18n/zh/prompts/coding_prompts/ 提供需求澄清、计划、执行的全链路脚本。核心资产映射:
i18n/zh/prompts/
coding_prompts/ # 需求澄清、计划、执行链的核心提示词
system_prompts/ # 约束 AI 行为边界的系统级提示词
assistant_prompts/ # 辅助/配合型提示
user_prompts/ # 可复用的用户侧提示词
i18n/zh/documents/
模板与资源/代码组织.md, 模板与资源/通用项目架构模板.md, 方法论与原则/开发经验.md, 方法论与原则/系统提示词构建原则.md 等知识库
backups/
一键备份.sh, 快速备份.py # 本地/远端快照脚本
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[i18n/zh/prompts/coding_prompts]
artifacts_md --> catalog_system[i18n/zh/prompts/system_prompts]
artifacts_md --> catalog_assist[i18n/zh/prompts/assistant_prompts]
artifacts_md --> catalog_user[i18n/zh/prompts/user_prompts]
artifacts_md --> docs_repo[i18n/zh/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
gantt
title 项目发展路线图
dateFormat YYYY-MM
section 近期 (2025)
补全演示GIF与示例项目: active, 2025-12, 15d
prompts 索引自动生成脚本: 2025-12, 10d
section 中期 (2026 Q1)
一键演示/验证 CLI 工作流: 2026-01, 15d
备份脚本增加快照与校验: 2026-01, 10d
section 远期 (2026 Q1-Q2)
模板化示例项目集: 2026-02, 20d
多模型对比与评估基线: 2026-02, 20d
要开始 Vibe Coding,你只需要以下两种工具之一:
本指南同时适用于 CLI 终端版本和 VSCode 扩展版本(Codex 和 Claude Code 都有扩展,且界面更新)。
*(注:本指南早期版本使用的是 Grok 3,后来切换到 Gemini 2.5 Pro,现在我们使用的是 Claude 4.5(或 gpt-5.1-codex.1-codex (xhigh)))*
(注2:如果你想使用 Cursor,请查看本指南的 1.1 版本,但我们认为它目前不如 Codex CLI 或 Claude Code 强大)
CLAUDE.md / Agents.md救救孩子,感谢了,好人一生平安🙏🙏🙏
TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BReyHjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC0xa396923a71ee7D9480b346a17dDeEb2c0C287BBCbc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e572155580感谢所有为本项目做出贡献的开发者!
特别鸣谢以下成员的宝贵贡献 (排名不分先后):
@shao__meng |
@0XBard_thomas |
@Pluvio9yte |
@xDinoDeer |
@geekbb
@GitHub_Daily
我们热烈欢迎各种形式的贡献。如果您对本项目有任何想法或建议,请随时开启一个 Issue 或提交一个 Pull Request。
在您开始之前,请花时间阅读我们的 贡献指南 (CONTRIBUTING.md) 和 行为准则 (CODE_OF_CONDUCT.md)。
本项目采用 MIT 许可证。