diff --git a/AGENTS.md b/AGENTS.md index 8a955a6..13051ce 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -155,10 +155,6 @@ When modifying this repository: ├── Makefile # 项目自动化脚本 (lint, backup 等)。 ├── README.md # 项目主文档，包含项目概览、使用指南等。 │ -├── backups/ # 项目备份脚本。 -│ ├── 一键备份.sh # 一键备份脚本。 -│ └── 快速备份.py # 快速备份 Python 脚本。 -│ ├── documents/ # 存放各类说明文档、经验总结和配置。 │ └── ... # 更多文档内容。 │ diff --git a/README.md b/README.md index 84cfb2d..fa3e7ab 100644 --- a/README.md +++ b/README.md @@ -1,652 +1,6 @@ - -

- - Vibe Coding 指南 -

+# Vibe Coding CN -
+Welcome to the Vibe Coding CN repository. Please select your language: -# Vibe Coding 指南 - -**一个通过与 AI 结对编程，将想法变为现实的终极工作站** - ---- - - -

- 构建状态 - 最新版本 - 许可证 - 主要语言 - 代码大小 - 贡献者 - 交流群 -

- -[📚 相关文档](#-相关文档与资源) -[🚀 入门指南](#-入门指南) -[⚙️ 完整设置流程](#️-完整设置流程) -[📞 联系方式](#-联系方式) -[✨ 支持项目](#-支持项目) -[🤝 参与贡献](#-参与贡献) - -本仓库的 AI 解读链接：[zread.ai/tukuaiai/vibe-coding-cn](https://zread.ai/tukuaiai/vibe-coding-cn/1-overview) - -
- ---- - -## 🖼️ 概览 - -**Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。 - -> **核心理念**: *规划就是一切。* 谨慎让 AI 自主规划，否则你的代码库会变成一团无法管理的乱麻。 - -**注意**：以下经验分享并非普遍适用，请在具体实践中结合场景，辩证采纳。 - -## 🔑 元方法论 (Meta-Methodology) - -该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤： - -#### 1. 定义核心角色： - -* **α-提示词 (生成器)**: 一个“母体”提示词，其唯一职责是**生成**其他提示词或技能。 -* **Ω-提示词 (优化器)**: 另一个“母体”提示词，其唯一职责是**优化**其他提示词或技能。 - -#### 2. 描述递归的生命周期： - -1. **创生 (Bootstrap)**: - * 使用 AI 生成 `α-提示词` 和 `Ω-提示词` 的初始版本 (v1)。 - -2. **自省与进化 (Self-Correction & Evolution)**: - * 使用 `Ω-提示词 (v1)` **优化** `α-提示词 (v1)`，从而得到一个更强大的 `α-提示词 (v2)`。 - -3. **创造 (Generation)**: - * 使用**进化后的** `α-提示词 (v2)` 生成所有需要的目标提示词和技能。 - -4. **循环与飞跃 (Recursive Loop)**: - * 将新生成的、更强大的产物（甚至包括新版本的 `Ω-提示词`）反馈给系统，再次用于优化 `α-提示词`，从而启动持续进化。 - -#### 3. 终极目标： - -通过此持续的**递归优化循环**，系统在每次迭代中实现**自我超越**，无限逼近预设的**预期状态**。 - -## 🧭 道 - -* **凡是 ai 能做的，就不要人工做** -* **一切问题问 ai** -* **目的主导：开发过程中的一切动作围绕"目的"展开** -* **上下文是 vibe coding 的第一性要素，垃圾进，垃圾出** -* **系统性思考，实体，链接，功能/目的，三个维度** -* **数据与函数即是编程的一切** -* **输入，处理，输出刻画整个过程** -* **多问 ai 是什么？，为什么？，怎么做？** -* **先结构，后代码，一定要规划好框架，不然后面技术债还不完** -* **奥卡姆剃刀定理，如无必要，勿增代码** -* **帕累托法则，关注重要的那20%** -* **逆向思考，先明确你的需求，从需求逆向构建代码** -* **重复，多试几次，实在不行重新开个窗口，** -* **专注，极致的专注可以击穿代码，一次只做一件事（神人除外）** - - -## 🧩 法 - -* **一句话目标 + 非目标** -* **正交性，功能不要太重复了，（这个分场景）** -* **能抄不写，不重复造轮子，先问 ai 有没有合适的仓库，下载下来改** -* **一定要看官方文档，先把官方文档爬下来喂给 ai** -* **按职责拆模块** -* **接口先行，实现后补** -* **一次只改一个模块** -* **文档即上下文，不是事后补** - -## 🛠️ 术 - -* 明确写清：**能改什么，不能改什么** -* Debug 只给：**预期 vs 实际 + 最小复现** -* 测试可交给 AI，**断言人审** -* 代码一多就**切会话** - -## 📋 器 - -### 集成开发环境 (IDE) & 终端 - -* [**Visual Studio Code**](https://code.visualstudio.com/): 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。 -* **虚拟环境 (.venv)**: 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。 -* [**Cursor**](https://cursor.com/): 已经占领用户心智高地，人尽皆知。 -* [**Warp**](https://www.warp.dev/): 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。 -* [**Neovim (nvim)**](https://github.com/neovim/neovim): 一款高性能的现代化 Vim 编辑器，拥有丰富的插件生态，是键盘流开发者的首选。 -* [**LazyVim**](https://github.com/LazyVim/LazyVim): 基于 Neovim 的配置框架，预置了 LSP、代码补全、调试等全套功能，实现了开箱即用与深度定制的平衡。 - -### AI 模型 & 服务 - -* [**Claude Opus 4.5**](https://claude.ai/new): 性能强大的 AI 模型，通过 Claude Code 等平台提供服务，并支持 CLI 和 IDE 插件。 -* [**gpt-5.1-codex.1-codex (xhigh)**](https://chatgpt.com/codex/): 适用于处理大型项目和复杂逻辑的 AI 模型，可通过 Codex CLI 等平台使用。 -* [**Droid**](https://factory.ai/news/terminal-bench): 提供对 Claude Opus 4.5 等多种模型的 CLI 访问。 -* [**Kiro**](https://kiro.dev/): 目前提供免费的 Claude Opus 4.5 模型访问，并提供客户端及 CLI 工具。 -* [**Gemini CLI**](https://geminicli.com/): 提供对 Gemini 模型的免费访问，适合执行脚本、整理文档和探索思路。 -* [**antigravity**](https://antigravity.google/): 目前由 Google 提供的免费 AI 服务，支持使用 Claude Opus 4.5 和 Gemini 3.0 Pro。 -* [**AI Studio**](https://aistudio.google.com/prompts/new_chat): Google 提供的免费服务，支持使用 Gemini 3.0 Pro 和 Nano Banana。 -* [**Gemini Enterprise**](https://cloud.google.com/gemini-enterprise): 面向企业用户的 Google AI 服务，目前可以免费使用。 -* [**GitHub Copilot**](https://github.com/copilot): 由 GitHub 和 OpenAI 联合开发的 AI 代码补全工具。 -* [**Kimi K2**](https://www.kimi.com/): 一款国产 AI 模型，适用于多种常规任务。 -* [**GLM**](https://bigmodel.cn/): 由智谱 AI 开发的国产大语言模型。 -* [**Qwen**](https://qwenlm.github.io/qwen-code-docs/zh/cli/): 由阿里巴巴开发的 AI 模型，其 CLI 工具提供免费使用额度。 - -### 开发与辅助工具 - -* [**Augment**](https://app.augmentcode.com/): 提供强大的上下文引擎和提示词优化功能。 -* [**Windsurf**](https://windsurf.com/): 为新用户提供免费额度的 AI 开发工具。 -* [**Ollama**](https://ollama.com/): 本地大模型管理工具，可通过命令行方便地拉取和运行开源模型。 -* [**Mermaid Chart**](https://www.mermaidchart.com/): 用于将文本描述转换为架构图、序列图等可视化图表。 -* [**NotebookLM**](https://notebooklm.google.com/): 一款用于 AI 解读资料、音频和生成思维导图的工具。 -* [**Zread**](https://zread.ai/): AI 驱动的 GitHub 仓库阅读工具，有助于快速理解项目代码。 -* [**tmux**](https://github.com/tmux/tmux): 强大的终端复用工具，支持会话保持、分屏和后台任务，是服务器与多项目开发的理想选择。 -* [**DBeaver**](https://dbeaver.io/): 一款通用数据库管理客户端，支持多种数据库，功能全面。 - -### 资源与模板 - -* [**提示词库 (在线表格)**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): 一个包含大量可直接复制使用的各类提示词的在线表格。 -* [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。 -* [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。 -* [**元提示词**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。 -* [**通用项目架构模板**](./documents/Templates%20and%20Resources/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。 -* [**元技能：Skills 的 Skills**](./skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。 -* [**tmux快捷键大全**](./documents/Tutorials%20and%20Guides/tmux快捷键大全.md): tmux 的快捷键参考文档。 -* [**LazyVim快捷键大全**](./documents/Tutorials%20and%20Guides/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。 -* [**二哥的Java进阶之路**](https://javabetter.cn/): 包含多种开发工具的详细配置教程。 -* [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。 - ---- - -## 编码模型性能分级参考 - -建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。 - -* **第一梯队**: `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 交流群](https://t.me/glue_coding) - * [Telegram 频道](https://t.me/tradecat_ai_channel) -* **个人分享**: - * [我的学习经验](./documents/Methodology%20and%20Principles/学习经验.md) - * [编程书籍推荐](./documents/Templates%20and%20Resources/编程书籍推荐.md) -* **核心资源**: - * [**元提示词库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。 - * [**元技能 (Meta-Skill)**](./skills/claude-skills/SKILL.md): 用于生成 Skills 的 Skill。 - * [**技能库 (Skills)**](./skills): 可直接集成的模块化技能仓库。 - * [**技能生成器**](https://github.com/yusufkaraaslan/Skill_Seekers): 将任何资料转化为 Agent 可用技能的工具。 - * [**在线提示词数据库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): 包含数百个适用于各场景的用户及系统提示词的在线表格。 - * [**第三方系统提示词仓库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 汇集了多种 AI 工具的系统提示词。 -* **项目内部文档**: - * [**prompts-library 工具说明**](./libs/external/prompts-library/): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。 - * [**coding_prompts 集合**](./prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。 - * [**系统提示词构建原则**](./documents/Methodology%20and%20Principles/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。 - * [**开发经验总结**](./documents/Methodology%20and%20Principles/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。 - * [**通用项目架构模板**](./documents/Templates%20and%20Resources/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。 - * [**Augment MCP 配置文档**](./documents/Tutorials%20and%20Guides/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。 - * [**system_prompts 集合**](./prompts/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 助手的核心行为准则或配置。 -│ -├── documents/ # 存放各类说明文档、经验总结和配置详细说明。 -│ ├── Methodology and Principles/ # 方法论与原则 -│ ├── Templates and Resources/ # 模板与资源 -│ └── Tutorials and Guides/ # 教程与指南 -│ -├── libs/ # 通用库代码，用于项目内部模块化。 -│ ├── common/ # 通用功能模块。 -│ │ ├── models/ # 模型定义。 -│ │ │ └── __init__.py -│ │ └── utils/ # 工具函数。 -│ │ └── backups/ # 内部备份工具。 -│ ├── database/ # 数据库相关模块。 -│ │ └── .gitkeep # 占位文件，确保目录被 Git 跟踪。 -│ └── external/ # 外部集成模块。 -│ ├── my-nvim/ # 用户的 Neovim 配置。 -│ ├── prompts-library/ # 提示词库管理工具（Excel-Markdown 转换）。 -│ │ ├── main.py # 提示词库管理工具主入口。 -│ │ ├── scripts/ # 包含 Excel 与 Markdown 互转脚本和配置。 -│ │ ├── prompt_excel/ # 存放 Excel 格式的原始提示词数据。 -│ │ ├── prompt_docs/ # 存放从 Excel 转换而来的 Markdown 提示词文档。 -│ │ └── ... (其他 prompts-library 内部文件) -│ └── XHS-image-to-PDF-conversion/ # 小红书图片转PDF工具。 -│ -├── prompts/ # 集中存放所有类型的 AI 提示词。 -│ ├── assistant_prompts/ # 辅助类提示词。 -│ ├── coding_prompts/ # 专门用于编程和代码生成相关的提示词集合。 -│ │ └── ... (具体编程提示词文件) -│ │ -│ ├── system_prompts/ # AI 系统级提示词，用于设定 AI 行为和框架。 -│ │ └── ... (其他系统提示词) -│ │ -│ └── user_prompts/ # 用户自定义或常用提示词。 -│ ├── ASCII图生成.md # ASCII 艺术图生成提示词。 -│ ├── 数据管道.md # 数据管道处理提示词。 -│ └── ... (其他用户提示词) -│ -├── skills/ # 集中存放所有类型的 skills 技能。 - ├── claude-skills # 生成 SKILL 的元 SKILL - │ ├── SKILL.md - │ └── ... (其他) - └── ... (与其他 skill) -``` - ---- - -## 🖼️ 概览与演示 - -一句话：Vibe Coding = **规划驱动 + 上下文固定 + AI 结对执行**，让「从想法到可维护代码」变成一条可审计的流水线，而不是一团无法迭代的巨石文件。 - -**你能得到** -- 成体系的提示词工具链：`prompts/system_prompts/` 约束 AI 行为边界，`prompts/coding_prompts/` 提供需求澄清、计划、执行的全链路脚本。 -- 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。 - -## ⚙️ 架构与工作流程 - -核心资产映射： -``` -prompts/ - coding_prompts/ # 需求澄清、计划、执行链的核心提示词 - system_prompts/ # 约束 AI 行为边界的系统级提示词 - assistant_prompts/ # 辅助/配合型提示 - user_prompts/ # 可复用的用户侧提示词 - prompts-library/ # Excel↔Markdown 提示词转换与索引工具 -documents/ - Templates and Resources/代码组织.md, Templates and Resources/通用项目架构模板.md, Methodology and Principles/开发经验.md, Methodology and Principles/系统提示词构建原则.md 等知识库 -backups/ - 一键备份.sh, 快速备份.py # 本地/远端快照脚本 -``` - -```mermaid -graph TB - %% GitHub 兼容简化版（仅使用基础语法） - - subgraph ext_layer[外部系统与数据源层] - ext_contrib[社区贡献者] - ext_sheet[Google 表格 / 外部表格] - ext_md[外部 Markdown 提示词] - ext_api[预留：其他数据源 / API] - ext_contrib --> ext_sheet - ext_contrib --> ext_md - ext_api --> ext_sheet - end - - subgraph ingest_layer[数据接入与采集层] - excel_raw[prompt_excel/*.xlsx] - md_raw[prompt_docs/外部MD输入] - excel_to_docs[prompts-library/scripts/excel_to_docs.py] - docs_to_excel[prompts-library/scripts/docs_to_excel.py] - ingest_bus[标准化数据帧] - ext_sheet --> excel_raw - ext_md --> md_raw - excel_raw --> excel_to_docs - md_raw --> docs_to_excel - excel_to_docs --> ingest_bus - docs_to_excel --> ingest_bus - end - - subgraph core_layer[数据处理与智能决策层 / 核心] - ingest_bus --> validate[字段校验与规范化] - validate --> transform[格式映射转换] - transform --> artifacts_md[prompt_docs/规范MD] - transform --> artifacts_xlsx[prompt_excel/导出XLSX] - orchestrator[main.py · scripts/start_convert.py] --> validate - orchestrator --> transform - end - - subgraph consume_layer[执行与消费层] - artifacts_md --> catalog_coding[prompts/coding_prompts] - artifacts_md --> catalog_system[prompts/system_prompts] - artifacts_md --> catalog_assist[prompts/assistant_prompts] - artifacts_md --> catalog_user[prompts/user_prompts] - artifacts_md --> docs_repo[documents/*] - artifacts_md --> new_consumer[预留：其他下游渠道] - catalog_coding --> ai_flow[AI 结对编程流程] - ai_flow --> deliverables[项目上下文 / 计划 / 代码产出] - end - - subgraph ux_layer[用户交互与接口层] - cli[CLI: python main.py] --> orchestrator - makefile[Makefile 任务封装] --> cli - readme[README.md 使用指南] --> cli - end - - subgraph infra_layer[基础设施与横切能力层] - git[Git 版本控制] --> orchestrator - backups[backups/一键备份.sh · backups/快速备份.py] --> artifacts_md - deps[requirements.txt · scripts/requirements.txt] --> orchestrator - config[prompts-library/scripts/config.yaml] --> orchestrator - monitor[预留：日志与监控] --> orchestrator - end -``` - ---- - -
-📈 性能基准 (可选) - -本仓库定位为「流程与提示词」而非性能型代码库，建议跟踪下列可观测指标（当前主要依赖人工记录，可在 `progress.md` 中打分/留痕）： - -| 指标 | 含义 | 当前状态/建议 | -|:---|:---|:---| -| 提示命中率 | 一次生成即满足验收的比例 | 待记录；每个任务完成后在 progress.md 记 0/1 | -| 周转时间 | 需求 → 首个可运行版本所需时间 | 录屏时标注时间戳，或用 CLI 定时器统计 | -| 变更可复盘度 | 是否同步更新上下文/进度/备份 | 通过手工更新；可在 backups 脚本中加入 git tag/快照 | -| 例程覆盖 | 是否有最小可运行示例/测试 | 建议每个示例项目保留 README+测试用例 | - -
- ---- - -## 🗺️ 路线图 - -```mermaid -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，你只需要以下两种工具之一： -- **Claude Opus 4.5**，在 Claude Code 中使用 -- **gpt-5.1-codex.1-codex (xhigh)**，在 Codex CLI 中使用 - -本指南同时适用于 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 版本](https://github.com/EnzeD/vibe-coding/tree/1.1.1)，但我们认为它目前不如 Codex CLI 或 Claude Code 强大)* - ---- - -
-⚙️ 完整设置流程 - -
-1. 游戏设计文档（Game Design Document） - -- 把你的游戏创意交给 **gpt-5.1-codex** 或 **Claude Opus 4.5**，让它生成一份简洁的 **游戏设计文档**，格式为 Markdown，文件名为 `game-design-document.md`。 -- 自己审阅并完善，确保与你的愿景一致。初期可以很简陋，目标是给 AI 提供游戏结构和意图的上下文。不要过度设计，后续会迭代。 -
- -
-2. 技术栈与 CLAUDE.md / Agents.md - -- 让 **gpt-5.1-codex** 或 **Claude Opus 4.5** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。 - - 要求它提出 **最简单但最健壮** 的技术栈。 -- 在终端中打开 **Claude Code** 或 **Codex CLI**，使用 `/init` 命令，它会读取你已创建的两个 .md 文件，生成一套规则来正确引导大模型。 -- **关键：一定要审查生成的规则。** 确保规则强调 **模块化**（多文件）和禁止 **单体巨文件**（monolith）。可能需要手动修改或补充规则。 - - **极其重要：** 某些规则必须设为 **"Always"**（始终应用），确保 AI 在生成任何代码前都强制阅读。例如添加以下规则并标记为 "Always"： - > ``` - > # 重要提示： - > # 写任何代码前必须完整阅读 memory-bank/@architecture.md（包含完整数据库结构） - > # 写任何代码前必须完整阅读 memory-bank/@game-design-document.md - > # 每完成一个重大功能或里程碑后，必须更新 memory-bank/@architecture.md - > ``` - - 其他（非 Always）规则要引导 AI 遵循你技术栈的最佳实践（如网络、状态管理等）。 - - *如果想要代码最干净、项目最优化，这一整套规则设置是强制性的。* -
- -
-3. 实施计划（Implementation Plan） - -- 将以下内容提供给 **gpt-5.1-codex** 或 **Claude Opus 4.5**： - - 游戏设计文档（`game-design-document.md`） - - 技术栈推荐（`tech-stack.md`） -- 让它生成一份详细的 **实施计划**（Markdown 格式），包含一系列给 AI 开发者的分步指令。 - - 每一步要小而具体。 - - 每一步都必须包含验证正确性的测试。 - - 严禁包含代码——只写清晰、具体的指令。 - - 先聚焦于 **基础游戏**，完整功能后面再加。 -
- -
-4. 记忆库（Memory Bank） - -- 新建项目文件夹，并在 VSCode 中打开。 -- 在项目根目录下创建子文件夹 `memory-bank`。 -- 将以下文件放入 `memory-bank`： - - `game-design-document.md` - - `tech-stack.md` - - `implementation-plan.md` - - `progress.md`（新建一个空文件，用于记录已完成步骤） - - `architecture.md`（新建一个空文件，用于记录每个文件的作用） -
- -
- -
-🎮 Vibe Coding 开发基础游戏 - -现在进入最爽的阶段！ - -
-确保一切清晰 - -- 在 VSCode 扩展中打开 **Codex** 或 **Claude Code**，或者在项目终端启动 Claude Code / Codex CLI。 -- 提示词：阅读 `/memory-bank` 里所有文档，`implementation-plan.md` 是否完全清晰？你有哪些问题需要我澄清，让它对你来说 100% 明确？ -- 它通常会问 9-10 个问题。全部回答完后，让它根据你的回答修改 `implementation-plan.md`，让计划更完善。 -
- -
-你的第一个实施提示词 - -- 打开 **Codex** 或 **Claude Code**（扩展或终端）。 -- 提示词：阅读 `/memory-bank` 所有文档，然后执行实施计划的第 1 步。我会负责跑测试。在我验证测试通过前，不要开始第 2 步。验证通过后，打开 `progress.md` 记录你做了什么供后续开发者参考，再把新的架构洞察添加到 `architecture.md` 中解释每个文件的作用。 -- **永远** 先用 "Ask" 模式或 "Plan Mode"（Claude Code 中按 `shift+tab`），确认满意后再让 AI 执行该步骤。 -- **极致 Vibe：** 安装 [Superwhisper](https://superwhisper.com)，用语音随便跟 Claude 或 gpt-5.1-codex 聊天，不用打字。 -
- -
-工作流 - -- 完成第 1 步后： - - 把改动提交到 Git（不会用就问 AI）。 - - 新建聊天（`/new` 或 `/clear`）。 - - 提示词：阅读 memory-bank 所有文件，阅读 progress.md 了解之前的工作进度，然后继续实施计划第 2 步。在我验证测试前不要开始第 3 步。 -- 重复此流程，直到整个 `implementation-plan.md` 全部完成。 -
- -
- -
-✨ 添加细节功能 - -恭喜！你已经做出了基础游戏！可能还很粗糙、缺少功能，但现在可以尽情实验和打磨了。 -- 想要雾效、后期处理、特效、音效？更好的飞机/汽车/城堡？绝美天空？ -- 每增加一个主要功能，就新建一个 `feature-implementation.md`，写短步骤+测试。 -- 继续增量式实现和测试。 - -
- -
-🐞 修复 Bug 与卡壳情况 - -
-常规修复 - -- 如果某个提示词失败或搞崩了项目： - - Claude Code 用 `/rewind` 回退；用 gpt-5.1-codex 的话多提交 git，需要时 reset。 -- 报错处理： - - **JavaScript 错误：** 打开浏览器控制台（F12），复制错误，贴给 AI；视觉问题截图发给它。 - - **懒人方案：** 安装 [BrowserTools](https://browsertools.agentdesk.ai/installation)，自动复制错误和截图。 -
- -
-疑难杂症 - -- 实在卡住： - - 回退到上一个 git commit（`git reset`），换新提示词重试。 -- 极度卡壳： - - 用 [RepoPrompt](https://repoprompt.com/) 或 [uithub](https://uithub.com/) 把整个代码库合成一个文件，然后丢给 **gpt-5.1-codex 或 Claude** 求救。 -
- -
- -
-💡 技巧与窍门 - -
-Claude Code & Codex 使用技巧 - -- **终端版 Claude Code / Codex CLI：** 在 VSCode 终端里运行，能直接看 diff、喂上下文，不用离开工作区。 -- **Claude Code 的 `/rewind`：** 迭代跑偏时一键回滚到之前状态。 -- **自定义命令：** 创建像 `/explain $参数` 这样的快捷命令，触发提示词：“深入分析代码，彻底理解 $参数 是怎么工作的。理解完告诉我，我再给你任务。” 让模型先拉满上下文再改代码。 -- **清理上下文：** 经常用 `/clear` 或 `/compact`（保留历史对话）。 -- **省时大法（风险自负）：** 用 `claude --dangerously-skip-permissions` 或 `codex --yolo`，彻底关闭确认弹窗。 -
- -
-其他实用技巧 - -- **小修改：** 用 gpt-5.1-codex (medium) -- **写顶级营销文案：** 用 Opus 4.1 -- **生成优秀 2D 精灵图：** 用 ChatGPT + Nano Banana -- **生成音乐：** 用 Suno -- **生成音效：** 用 ElevenLabs -- **生成视频：** 用 Sora 2 -- **提升提示词效果：** - - 加一句：“慢慢想，不着急，重要的是严格按我说的做，执行完美。如果我表达不够精确请提问。” - - 在 Claude Code 中触发深度思考的关键词强度：`think` < `think hard` < `think harder` < `ultrathink`。 -
- -
- -
-❓ 常见问题解答 (FAQ) - -- **Q: 我在做应用不是游戏，这个流程一样吗？** - - **A:** 基本完全一样！把 GDD 换成 PRD（产品需求文档）即可。你也可以先用 v0、Lovable、Bolt.new 快速原型，再把代码搬到 GitHub，然后克隆到本地用本指南继续开发。 - -- **Q: 你那个空战游戏的飞机模型太牛了，但我一个提示词做不出来！** - - **A:** 那不是一个提示词，是 ~30 个提示词 + 专门的 `plane-implementation.md` 文件引导的。用精准指令如“在机翼上为副翼切出空间”，而不是“做一个飞机”这种模糊指令。 - -- **Q: 为什么现在 Claude Code 或 Codex CLI 比 Cursor 更强？** - - **A:** 完全看个人喜好。我们强调的是：Claude Code 能更好发挥 Claude Opus 4.5 的实力，Codex CLI 能更好发挥 gpt-5.1-codex 的实力，而 Cursor 对这两者的利用都不如原生终端版。终端版还能在任意 IDE、使用 SSH 远程服务器等场景工作，自定义命令、子代理、钩子等功能也能长期大幅提升开发质量和速度。最后，即使你只是低配 Claude 或 ChatGPT 订阅，也完全够用。 - -- **Q: 我不会搭建多人游戏的服务器怎么办？** - - **A:** 问你的 AI。 - -
- ---- - -## 📞 联系方式 - -- **GitHub**: [tukuaiai](https://github.com/tukuaiai) -- **Twitter / X**: [123olp](https://x.com/123olp) -- **Telegram**: [@desci0](https://t.me/desci0) -- **Telegram 交流群**: [glue_coding](https://t.me/glue_coding) -- **Telegram 频道**: [tradecat_ai_channel](https://t.me/tradecat_ai_channel) -- **邮箱**: tukuai.ai@gmail.com (回复可能不及时) - ---- - -## ✨ 支持项目 - -救救孩子，感谢了，好人一生平安🙏🙏🙏 - -- **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey` -- **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau` -- **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC` -- **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC` -- **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm` -- **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e` -- **币安 UID**: `572155580` - ---- - -### ✨ 贡献者 - -感谢所有为本项目做出贡献的开发者！ - - - - - - -

特别鸣谢以下成员的宝贵贡献 (排名不分先后):
-@shao__meng | -@0XBard_thomas | -@Pluvio9yte | -@xDinoDeer | -@geekbb -@GitHub_Daily -

- ---- - -## 🤝 参与贡献 - -我们热烈欢迎各种形式的贡献。如果您对本项目有任何想法或建议，请随时开启一个 [Issue](https://github.com/tukuaiai/vibe-coding-cn/issues) 或提交一个 [Pull Request](https://github.com/tukuaiai/vibe-coding-cn/pulls)。 - -在您开始之前，请花时间阅读我们的 [**贡献指南 (CONTRIBUTING.md)**](CONTRIBUTING.md) 和 [**行为准则 (CODE_OF_CONDUCT.md)**](CODE_OF_CONDUCT.md)。 - ---- - -## 📜 许可证 - -本项目采用 [MIT](LICENSE) 许可证。 - ---- - -
- -**如果这个项目对您有帮助，请考虑为其点亮一颗 Star ⭐！** - -## Star History - - - - - - Star History Chart - - - ---- - -**由 [tukuaiai](https://github.com/tukuaiai), [Nicolas Zullo](https://x.com/NicolasZu), 和 [123olp](https://x.com/123olp) 倾力打造** - -[⬆ 返回顶部](#vibe-coding-指南) -
+- [**English**](./i18n/en/README.md) +- [**简体中文**](./i18n/zh/README.md) diff --git a/i18n/en/README.md b/i18n/en/README.md new file mode 100644 index 0000000..f483c29 --- /dev/null +++ b/i18n/en/README.md @@ -0,0 +1,9 @@ +# Vibe Coding CN (English) + +Welcome to the English version of the Vibe Coding CN repository. + +*This section is under construction. Content is being translated from the [Chinese version](../zh/README.md).* + +- [Documents](./documents/) +- [Prompts](./prompts/) +- [Skills](./skills/) diff --git a/i18n/en/documents/README.md b/i18n/en/documents/README.md new file mode 100644 index 0000000..11253c4 --- /dev/null +++ b/i18n/en/documents/README.md @@ -0,0 +1,3 @@ +# Content Under Construction + +This section is currently being translated from the Chinese version. Please check back later. diff --git a/i18n/en/prompts/README.md b/i18n/en/prompts/README.md new file mode 100644 index 0000000..11253c4 --- /dev/null +++ b/i18n/en/prompts/README.md @@ -0,0 +1,3 @@ +# Content Under Construction + +This section is currently being translated from the Chinese version. Please check back later. diff --git a/i18n/en/skills/README.md b/i18n/en/skills/README.md new file mode 100644 index 0000000..11253c4 --- /dev/null +++ b/i18n/en/skills/README.md @@ -0,0 +1,3 @@ +# Content Under Construction + +This section is currently being translated from the Chinese version. Please check back later. diff --git a/i18n/zh/README.md b/i18n/zh/README.md new file mode 100644 index 0000000..84cfb2d --- /dev/null +++ b/i18n/zh/README.md @@ -0,0 +1,652 @@ + +

+ + Vibe Coding 指南 +

+ +
+ +# Vibe Coding 指南 + +**一个通过与 AI 结对编程，将想法变为现实的终极工作站** + +--- + + +

+ 构建状态 + 最新版本 + 许可证 + 主要语言 + 代码大小 + 贡献者 + 交流群 +

+ +[📚 相关文档](#-相关文档与资源) +[🚀 入门指南](#-入门指南) +[⚙️ 完整设置流程](#️-完整设置流程) +[📞 联系方式](#-联系方式) +[✨ 支持项目](#-支持项目) +[🤝 参与贡献](#-参与贡献) + +本仓库的 AI 解读链接：[zread.ai/tukuaiai/vibe-coding-cn](https://zread.ai/tukuaiai/vibe-coding-cn/1-overview) + +
+ +--- + +## 🖼️ 概览 + +**Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。 + +> **核心理念**: *规划就是一切。* 谨慎让 AI 自主规划，否则你的代码库会变成一团无法管理的乱麻。 + +**注意**：以下经验分享并非普遍适用，请在具体实践中结合场景，辩证采纳。 + +## 🔑 元方法论 (Meta-Methodology) + +该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤： + +#### 1. 定义核心角色： + +* **α-提示词 (生成器)**: 一个“母体”提示词，其唯一职责是**生成**其他提示词或技能。 +* **Ω-提示词 (优化器)**: 另一个“母体”提示词，其唯一职责是**优化**其他提示词或技能。 + +#### 2. 描述递归的生命周期： + +1. **创生 (Bootstrap)**: + * 使用 AI 生成 `α-提示词` 和 `Ω-提示词` 的初始版本 (v1)。 + +2. **自省与进化 (Self-Correction & Evolution)**: + * 使用 `Ω-提示词 (v1)` **优化** `α-提示词 (v1)`，从而得到一个更强大的 `α-提示词 (v2)`。 + +3. **创造 (Generation)**: + * 使用**进化后的** `α-提示词 (v2)` 生成所有需要的目标提示词和技能。 + +4. **循环与飞跃 (Recursive Loop)**: + * 将新生成的、更强大的产物（甚至包括新版本的 `Ω-提示词`）反馈给系统，再次用于优化 `α-提示词`，从而启动持续进化。 + +#### 3. 终极目标： + +通过此持续的**递归优化循环**，系统在每次迭代中实现**自我超越**，无限逼近预设的**预期状态**。 + +## 🧭 道 + +* **凡是 ai 能做的，就不要人工做** +* **一切问题问 ai** +* **目的主导：开发过程中的一切动作围绕"目的"展开** +* **上下文是 vibe coding 的第一性要素，垃圾进，垃圾出** +* **系统性思考，实体，链接，功能/目的，三个维度** +* **数据与函数即是编程的一切** +* **输入，处理，输出刻画整个过程** +* **多问 ai 是什么？，为什么？，怎么做？** +* **先结构，后代码，一定要规划好框架，不然后面技术债还不完** +* **奥卡姆剃刀定理，如无必要，勿增代码** +* **帕累托法则，关注重要的那20%** +* **逆向思考，先明确你的需求，从需求逆向构建代码** +* **重复，多试几次，实在不行重新开个窗口，** +* **专注，极致的专注可以击穿代码，一次只做一件事（神人除外）** + + +## 🧩 法 + +* **一句话目标 + 非目标** +* **正交性，功能不要太重复了，（这个分场景）** +* **能抄不写，不重复造轮子，先问 ai 有没有合适的仓库，下载下来改** +* **一定要看官方文档，先把官方文档爬下来喂给 ai** +* **按职责拆模块** +* **接口先行，实现后补** +* **一次只改一个模块** +* **文档即上下文，不是事后补** + +## 🛠️ 术 + +* 明确写清：**能改什么，不能改什么** +* Debug 只给：**预期 vs 实际 + 最小复现** +* 测试可交给 AI，**断言人审** +* 代码一多就**切会话** + +## 📋 器 + +### 集成开发环境 (IDE) & 终端 + +* [**Visual Studio Code**](https://code.visualstudio.com/): 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。 +* **虚拟环境 (.venv)**: 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。 +* [**Cursor**](https://cursor.com/): 已经占领用户心智高地，人尽皆知。 +* [**Warp**](https://www.warp.dev/): 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。 +* [**Neovim (nvim)**](https://github.com/neovim/neovim): 一款高性能的现代化 Vim 编辑器，拥有丰富的插件生态，是键盘流开发者的首选。 +* [**LazyVim**](https://github.com/LazyVim/LazyVim): 基于 Neovim 的配置框架，预置了 LSP、代码补全、调试等全套功能，实现了开箱即用与深度定制的平衡。 + +### AI 模型 & 服务 + +* [**Claude Opus 4.5**](https://claude.ai/new): 性能强大的 AI 模型，通过 Claude Code 等平台提供服务，并支持 CLI 和 IDE 插件。 +* [**gpt-5.1-codex.1-codex (xhigh)**](https://chatgpt.com/codex/): 适用于处理大型项目和复杂逻辑的 AI 模型，可通过 Codex CLI 等平台使用。 +* [**Droid**](https://factory.ai/news/terminal-bench): 提供对 Claude Opus 4.5 等多种模型的 CLI 访问。 +* [**Kiro**](https://kiro.dev/): 目前提供免费的 Claude Opus 4.5 模型访问，并提供客户端及 CLI 工具。 +* [**Gemini CLI**](https://geminicli.com/): 提供对 Gemini 模型的免费访问，适合执行脚本、整理文档和探索思路。 +* [**antigravity**](https://antigravity.google/): 目前由 Google 提供的免费 AI 服务，支持使用 Claude Opus 4.5 和 Gemini 3.0 Pro。 +* [**AI Studio**](https://aistudio.google.com/prompts/new_chat): Google 提供的免费服务，支持使用 Gemini 3.0 Pro 和 Nano Banana。 +* [**Gemini Enterprise**](https://cloud.google.com/gemini-enterprise): 面向企业用户的 Google AI 服务，目前可以免费使用。 +* [**GitHub Copilot**](https://github.com/copilot): 由 GitHub 和 OpenAI 联合开发的 AI 代码补全工具。 +* [**Kimi K2**](https://www.kimi.com/): 一款国产 AI 模型，适用于多种常规任务。 +* [**GLM**](https://bigmodel.cn/): 由智谱 AI 开发的国产大语言模型。 +* [**Qwen**](https://qwenlm.github.io/qwen-code-docs/zh/cli/): 由阿里巴巴开发的 AI 模型，其 CLI 工具提供免费使用额度。 + +### 开发与辅助工具 + +* [**Augment**](https://app.augmentcode.com/): 提供强大的上下文引擎和提示词优化功能。 +* [**Windsurf**](https://windsurf.com/): 为新用户提供免费额度的 AI 开发工具。 +* [**Ollama**](https://ollama.com/): 本地大模型管理工具，可通过命令行方便地拉取和运行开源模型。 +* [**Mermaid Chart**](https://www.mermaidchart.com/): 用于将文本描述转换为架构图、序列图等可视化图表。 +* [**NotebookLM**](https://notebooklm.google.com/): 一款用于 AI 解读资料、音频和生成思维导图的工具。 +* [**Zread**](https://zread.ai/): AI 驱动的 GitHub 仓库阅读工具，有助于快速理解项目代码。 +* [**tmux**](https://github.com/tmux/tmux): 强大的终端复用工具，支持会话保持、分屏和后台任务，是服务器与多项目开发的理想选择。 +* [**DBeaver**](https://dbeaver.io/): 一款通用数据库管理客户端，支持多种数据库，功能全面。 + +### 资源与模板 + +* [**提示词库 (在线表格)**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): 一个包含大量可直接复制使用的各类提示词的在线表格。 +* [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。 +* [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。 +* [**元提示词**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。 +* [**通用项目架构模板**](./documents/Templates%20and%20Resources/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。 +* [**元技能：Skills 的 Skills**](./skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。 +* [**tmux快捷键大全**](./documents/Tutorials%20and%20Guides/tmux快捷键大全.md): tmux 的快捷键参考文档。 +* [**LazyVim快捷键大全**](./documents/Tutorials%20and%20Guides/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。 +* [**二哥的Java进阶之路**](https://javabetter.cn/): 包含多种开发工具的详细配置教程。 +* [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。 + +--- + +## 编码模型性能分级参考 + +建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。 + +* **第一梯队**: `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 交流群](https://t.me/glue_coding) + * [Telegram 频道](https://t.me/tradecat_ai_channel) +* **个人分享**: + * [我的学习经验](./documents/Methodology%20and%20Principles/学习经验.md) + * [编程书籍推荐](./documents/Templates%20and%20Resources/编程书籍推荐.md) +* **核心资源**: + * [**元提示词库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。 + * [**元技能 (Meta-Skill)**](./skills/claude-skills/SKILL.md): 用于生成 Skills 的 Skill。 + * [**技能库 (Skills)**](./skills): 可直接集成的模块化技能仓库。 + * [**技能生成器**](https://github.com/yusufkaraaslan/Skill_Seekers): 将任何资料转化为 Agent 可用技能的工具。 + * [**在线提示词数据库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): 包含数百个适用于各场景的用户及系统提示词的在线表格。 + * [**第三方系统提示词仓库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 汇集了多种 AI 工具的系统提示词。 +* **项目内部文档**: + * [**prompts-library 工具说明**](./libs/external/prompts-library/): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。 + * [**coding_prompts 集合**](./prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。 + * [**系统提示词构建原则**](./documents/Methodology%20and%20Principles/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。 + * [**开发经验总结**](./documents/Methodology%20and%20Principles/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。 + * [**通用项目架构模板**](./documents/Templates%20and%20Resources/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。 + * [**Augment MCP 配置文档**](./documents/Tutorials%20and%20Guides/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。 + * [**system_prompts 集合**](./prompts/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 助手的核心行为准则或配置。 +│ +├── documents/ # 存放各类说明文档、经验总结和配置详细说明。 +│ ├── Methodology and Principles/ # 方法论与原则 +│ ├── Templates and Resources/ # 模板与资源 +│ └── Tutorials and Guides/ # 教程与指南 +│ +├── libs/ # 通用库代码，用于项目内部模块化。 +│ ├── common/ # 通用功能模块。 +│ │ ├── models/ # 模型定义。 +│ │ │ └── __init__.py +│ │ └── utils/ # 工具函数。 +│ │ └── backups/ # 内部备份工具。 +│ ├── database/ # 数据库相关模块。 +│ │ └── .gitkeep # 占位文件，确保目录被 Git 跟踪。 +│ └── external/ # 外部集成模块。 +│ ├── my-nvim/ # 用户的 Neovim 配置。 +│ ├── prompts-library/ # 提示词库管理工具（Excel-Markdown 转换）。 +│ │ ├── main.py # 提示词库管理工具主入口。 +│ │ ├── scripts/ # 包含 Excel 与 Markdown 互转脚本和配置。 +│ │ ├── prompt_excel/ # 存放 Excel 格式的原始提示词数据。 +│ │ ├── prompt_docs/ # 存放从 Excel 转换而来的 Markdown 提示词文档。 +│ │ └── ... (其他 prompts-library 内部文件) +│ └── XHS-image-to-PDF-conversion/ # 小红书图片转PDF工具。 +│ +├── prompts/ # 集中存放所有类型的 AI 提示词。 +│ ├── assistant_prompts/ # 辅助类提示词。 +│ ├── coding_prompts/ # 专门用于编程和代码生成相关的提示词集合。 +│ │ └── ... (具体编程提示词文件) +│ │ +│ ├── system_prompts/ # AI 系统级提示词，用于设定 AI 行为和框架。 +│ │ └── ... (其他系统提示词) +│ │ +│ └── user_prompts/ # 用户自定义或常用提示词。 +│ ├── ASCII图生成.md # ASCII 艺术图生成提示词。 +│ ├── 数据管道.md # 数据管道处理提示词。 +│ └── ... (其他用户提示词) +│ +├── skills/ # 集中存放所有类型的 skills 技能。 + ├── claude-skills # 生成 SKILL 的元 SKILL + │ ├── SKILL.md + │ └── ... (其他) + └── ... (与其他 skill) +``` + +--- + +## 🖼️ 概览与演示 + +一句话：Vibe Coding = **规划驱动 + 上下文固定 + AI 结对执行**，让「从想法到可维护代码」变成一条可审计的流水线，而不是一团无法迭代的巨石文件。 + +**你能得到** +- 成体系的提示词工具链：`prompts/system_prompts/` 约束 AI 行为边界，`prompts/coding_prompts/` 提供需求澄清、计划、执行的全链路脚本。 +- 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。 + +## ⚙️ 架构与工作流程 + +核心资产映射： +``` +prompts/ + coding_prompts/ # 需求澄清、计划、执行链的核心提示词 + system_prompts/ # 约束 AI 行为边界的系统级提示词 + assistant_prompts/ # 辅助/配合型提示 + user_prompts/ # 可复用的用户侧提示词 + prompts-library/ # Excel↔Markdown 提示词转换与索引工具 +documents/ + Templates and Resources/代码组织.md, Templates and Resources/通用项目架构模板.md, Methodology and Principles/开发经验.md, Methodology and Principles/系统提示词构建原则.md 等知识库 +backups/ + 一键备份.sh, 快速备份.py # 本地/远端快照脚本 +``` + +```mermaid +graph TB + %% GitHub 兼容简化版（仅使用基础语法） + + subgraph ext_layer[外部系统与数据源层] + ext_contrib[社区贡献者] + ext_sheet[Google 表格 / 外部表格] + ext_md[外部 Markdown 提示词] + ext_api[预留：其他数据源 / API] + ext_contrib --> ext_sheet + ext_contrib --> ext_md + ext_api --> ext_sheet + end + + subgraph ingest_layer[数据接入与采集层] + excel_raw[prompt_excel/*.xlsx] + md_raw[prompt_docs/外部MD输入] + excel_to_docs[prompts-library/scripts/excel_to_docs.py] + docs_to_excel[prompts-library/scripts/docs_to_excel.py] + ingest_bus[标准化数据帧] + ext_sheet --> excel_raw + ext_md --> md_raw + excel_raw --> excel_to_docs + md_raw --> docs_to_excel + excel_to_docs --> ingest_bus + docs_to_excel --> ingest_bus + end + + subgraph core_layer[数据处理与智能决策层 / 核心] + ingest_bus --> validate[字段校验与规范化] + validate --> transform[格式映射转换] + transform --> artifacts_md[prompt_docs/规范MD] + transform --> artifacts_xlsx[prompt_excel/导出XLSX] + orchestrator[main.py · scripts/start_convert.py] --> validate + orchestrator --> transform + end + + subgraph consume_layer[执行与消费层] + artifacts_md --> catalog_coding[prompts/coding_prompts] + artifacts_md --> catalog_system[prompts/system_prompts] + artifacts_md --> catalog_assist[prompts/assistant_prompts] + artifacts_md --> catalog_user[prompts/user_prompts] + artifacts_md --> docs_repo[documents/*] + artifacts_md --> new_consumer[预留：其他下游渠道] + catalog_coding --> ai_flow[AI 结对编程流程] + ai_flow --> deliverables[项目上下文 / 计划 / 代码产出] + end + + subgraph ux_layer[用户交互与接口层] + cli[CLI: python main.py] --> orchestrator + makefile[Makefile 任务封装] --> cli + readme[README.md 使用指南] --> cli + end + + subgraph infra_layer[基础设施与横切能力层] + git[Git 版本控制] --> orchestrator + backups[backups/一键备份.sh · backups/快速备份.py] --> artifacts_md + deps[requirements.txt · scripts/requirements.txt] --> orchestrator + config[prompts-library/scripts/config.yaml] --> orchestrator + monitor[预留：日志与监控] --> orchestrator + end +``` + +--- + +
+📈 性能基准 (可选) + +本仓库定位为「流程与提示词」而非性能型代码库，建议跟踪下列可观测指标（当前主要依赖人工记录，可在 `progress.md` 中打分/留痕）： + +| 指标 | 含义 | 当前状态/建议 | +|:---|:---|:---| +| 提示命中率 | 一次生成即满足验收的比例 | 待记录；每个任务完成后在 progress.md 记 0/1 | +| 周转时间 | 需求 → 首个可运行版本所需时间 | 录屏时标注时间戳，或用 CLI 定时器统计 | +| 变更可复盘度 | 是否同步更新上下文/进度/备份 | 通过手工更新；可在 backups 脚本中加入 git tag/快照 | +| 例程覆盖 | 是否有最小可运行示例/测试 | 建议每个示例项目保留 README+测试用例 | + +
+ +--- + +## 🗺️ 路线图 + +```mermaid +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，你只需要以下两种工具之一： +- **Claude Opus 4.5**，在 Claude Code 中使用 +- **gpt-5.1-codex.1-codex (xhigh)**，在 Codex CLI 中使用 + +本指南同时适用于 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 版本](https://github.com/EnzeD/vibe-coding/tree/1.1.1)，但我们认为它目前不如 Codex CLI 或 Claude Code 强大)* + +--- + +
+⚙️ 完整设置流程 + +
+1. 游戏设计文档（Game Design Document） + +- 把你的游戏创意交给 **gpt-5.1-codex** 或 **Claude Opus 4.5**，让它生成一份简洁的 **游戏设计文档**，格式为 Markdown，文件名为 `game-design-document.md`。 +- 自己审阅并完善，确保与你的愿景一致。初期可以很简陋，目标是给 AI 提供游戏结构和意图的上下文。不要过度设计，后续会迭代。 +
+ +
+2. 技术栈与 CLAUDE.md / Agents.md + +- 让 **gpt-5.1-codex** 或 **Claude Opus 4.5** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。 + - 要求它提出 **最简单但最健壮** 的技术栈。 +- 在终端中打开 **Claude Code** 或 **Codex CLI**，使用 `/init` 命令，它会读取你已创建的两个 .md 文件，生成一套规则来正确引导大模型。 +- **关键：一定要审查生成的规则。** 确保规则强调 **模块化**（多文件）和禁止 **单体巨文件**（monolith）。可能需要手动修改或补充规则。 + - **极其重要：** 某些规则必须设为 **"Always"**（始终应用），确保 AI 在生成任何代码前都强制阅读。例如添加以下规则并标记为 "Always"： + > ``` + > # 重要提示： + > # 写任何代码前必须完整阅读 memory-bank/@architecture.md（包含完整数据库结构） + > # 写任何代码前必须完整阅读 memory-bank/@game-design-document.md + > # 每完成一个重大功能或里程碑后，必须更新 memory-bank/@architecture.md + > ``` + - 其他（非 Always）规则要引导 AI 遵循你技术栈的最佳实践（如网络、状态管理等）。 + - *如果想要代码最干净、项目最优化，这一整套规则设置是强制性的。* +
+ +
+3. 实施计划（Implementation Plan） + +- 将以下内容提供给 **gpt-5.1-codex** 或 **Claude Opus 4.5**： + - 游戏设计文档（`game-design-document.md`） + - 技术栈推荐（`tech-stack.md`） +- 让它生成一份详细的 **实施计划**（Markdown 格式），包含一系列给 AI 开发者的分步指令。 + - 每一步要小而具体。 + - 每一步都必须包含验证正确性的测试。 + - 严禁包含代码——只写清晰、具体的指令。 + - 先聚焦于 **基础游戏**，完整功能后面再加。 +
+ +
+4. 记忆库（Memory Bank） + +- 新建项目文件夹，并在 VSCode 中打开。 +- 在项目根目录下创建子文件夹 `memory-bank`。 +- 将以下文件放入 `memory-bank`： + - `game-design-document.md` + - `tech-stack.md` + - `implementation-plan.md` + - `progress.md`（新建一个空文件，用于记录已完成步骤） + - `architecture.md`（新建一个空文件，用于记录每个文件的作用） +
+ +
+ +
+🎮 Vibe Coding 开发基础游戏 + +现在进入最爽的阶段！ + +
+确保一切清晰 + +- 在 VSCode 扩展中打开 **Codex** 或 **Claude Code**，或者在项目终端启动 Claude Code / Codex CLI。 +- 提示词：阅读 `/memory-bank` 里所有文档，`implementation-plan.md` 是否完全清晰？你有哪些问题需要我澄清，让它对你来说 100% 明确？ +- 它通常会问 9-10 个问题。全部回答完后，让它根据你的回答修改 `implementation-plan.md`，让计划更完善。 +
+ +
+你的第一个实施提示词 + +- 打开 **Codex** 或 **Claude Code**（扩展或终端）。 +- 提示词：阅读 `/memory-bank` 所有文档，然后执行实施计划的第 1 步。我会负责跑测试。在我验证测试通过前，不要开始第 2 步。验证通过后，打开 `progress.md` 记录你做了什么供后续开发者参考，再把新的架构洞察添加到 `architecture.md` 中解释每个文件的作用。 +- **永远** 先用 "Ask" 模式或 "Plan Mode"（Claude Code 中按 `shift+tab`），确认满意后再让 AI 执行该步骤。 +- **极致 Vibe：** 安装 [Superwhisper](https://superwhisper.com)，用语音随便跟 Claude 或 gpt-5.1-codex 聊天，不用打字。 +
+ +
+工作流 + +- 完成第 1 步后： + - 把改动提交到 Git（不会用就问 AI）。 + - 新建聊天（`/new` 或 `/clear`）。 + - 提示词：阅读 memory-bank 所有文件，阅读 progress.md 了解之前的工作进度，然后继续实施计划第 2 步。在我验证测试前不要开始第 3 步。 +- 重复此流程，直到整个 `implementation-plan.md` 全部完成。 +
+ +
+ +
+✨ 添加细节功能 + +恭喜！你已经做出了基础游戏！可能还很粗糙、缺少功能，但现在可以尽情实验和打磨了。 +- 想要雾效、后期处理、特效、音效？更好的飞机/汽车/城堡？绝美天空？ +- 每增加一个主要功能，就新建一个 `feature-implementation.md`，写短步骤+测试。 +- 继续增量式实现和测试。 + +
+ +
+🐞 修复 Bug 与卡壳情况 + +
+常规修复 + +- 如果某个提示词失败或搞崩了项目： + - Claude Code 用 `/rewind` 回退；用 gpt-5.1-codex 的话多提交 git，需要时 reset。 +- 报错处理： + - **JavaScript 错误：** 打开浏览器控制台（F12），复制错误，贴给 AI；视觉问题截图发给它。 + - **懒人方案：** 安装 [BrowserTools](https://browsertools.agentdesk.ai/installation)，自动复制错误和截图。 +
+ +
+疑难杂症 + +- 实在卡住： + - 回退到上一个 git commit（`git reset`），换新提示词重试。 +- 极度卡壳： + - 用 [RepoPrompt](https://repoprompt.com/) 或 [uithub](https://uithub.com/) 把整个代码库合成一个文件，然后丢给 **gpt-5.1-codex 或 Claude** 求救。 +
+ +
+ +
+💡 技巧与窍门 + +
+Claude Code & Codex 使用技巧 + +- **终端版 Claude Code / Codex CLI：** 在 VSCode 终端里运行，能直接看 diff、喂上下文，不用离开工作区。 +- **Claude Code 的 `/rewind`：** 迭代跑偏时一键回滚到之前状态。 +- **自定义命令：** 创建像 `/explain $参数` 这样的快捷命令，触发提示词：“深入分析代码，彻底理解 $参数 是怎么工作的。理解完告诉我，我再给你任务。” 让模型先拉满上下文再改代码。 +- **清理上下文：** 经常用 `/clear` 或 `/compact`（保留历史对话）。 +- **省时大法（风险自负）：** 用 `claude --dangerously-skip-permissions` 或 `codex --yolo`，彻底关闭确认弹窗。 +
+ +
+其他实用技巧 + +- **小修改：** 用 gpt-5.1-codex (medium) +- **写顶级营销文案：** 用 Opus 4.1 +- **生成优秀 2D 精灵图：** 用 ChatGPT + Nano Banana +- **生成音乐：** 用 Suno +- **生成音效：** 用 ElevenLabs +- **生成视频：** 用 Sora 2 +- **提升提示词效果：** + - 加一句：“慢慢想，不着急，重要的是严格按我说的做，执行完美。如果我表达不够精确请提问。” + - 在 Claude Code 中触发深度思考的关键词强度：`think` < `think hard` < `think harder` < `ultrathink`。 +
+ +
+ +
+❓ 常见问题解答 (FAQ) + +- **Q: 我在做应用不是游戏，这个流程一样吗？** + - **A:** 基本完全一样！把 GDD 换成 PRD（产品需求文档）即可。你也可以先用 v0、Lovable、Bolt.new 快速原型，再把代码搬到 GitHub，然后克隆到本地用本指南继续开发。 + +- **Q: 你那个空战游戏的飞机模型太牛了，但我一个提示词做不出来！** + - **A:** 那不是一个提示词，是 ~30 个提示词 + 专门的 `plane-implementation.md` 文件引导的。用精准指令如“在机翼上为副翼切出空间”，而不是“做一个飞机”这种模糊指令。 + +- **Q: 为什么现在 Claude Code 或 Codex CLI 比 Cursor 更强？** + - **A:** 完全看个人喜好。我们强调的是：Claude Code 能更好发挥 Claude Opus 4.5 的实力，Codex CLI 能更好发挥 gpt-5.1-codex 的实力，而 Cursor 对这两者的利用都不如原生终端版。终端版还能在任意 IDE、使用 SSH 远程服务器等场景工作，自定义命令、子代理、钩子等功能也能长期大幅提升开发质量和速度。最后，即使你只是低配 Claude 或 ChatGPT 订阅，也完全够用。 + +- **Q: 我不会搭建多人游戏的服务器怎么办？** + - **A:** 问你的 AI。 + +
+ +--- + +## 📞 联系方式 + +- **GitHub**: [tukuaiai](https://github.com/tukuaiai) +- **Twitter / X**: [123olp](https://x.com/123olp) +- **Telegram**: [@desci0](https://t.me/desci0) +- **Telegram 交流群**: [glue_coding](https://t.me/glue_coding) +- **Telegram 频道**: [tradecat_ai_channel](https://t.me/tradecat_ai_channel) +- **邮箱**: tukuai.ai@gmail.com (回复可能不及时) + +--- + +## ✨ 支持项目 + +救救孩子，感谢了，好人一生平安🙏🙏🙏 + +- **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey` +- **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau` +- **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC` +- **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC` +- **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm` +- **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e` +- **币安 UID**: `572155580` + +--- + +### ✨ 贡献者 + +感谢所有为本项目做出贡献的开发者！ + + + + + + +

特别鸣谢以下成员的宝贵贡献 (排名不分先后):
+@shao__meng | +@0XBard_thomas | +@Pluvio9yte | +@xDinoDeer | +@geekbb +@GitHub_Daily +

+ +--- + +## 🤝 参与贡献 + +我们热烈欢迎各种形式的贡献。如果您对本项目有任何想法或建议，请随时开启一个 [Issue](https://github.com/tukuaiai/vibe-coding-cn/issues) 或提交一个 [Pull Request](https://github.com/tukuaiai/vibe-coding-cn/pulls)。 + +在您开始之前，请花时间阅读我们的 [**贡献指南 (CONTRIBUTING.md)**](CONTRIBUTING.md) 和 [**行为准则 (CODE_OF_CONDUCT.md)**](CODE_OF_CONDUCT.md)。 + +--- + +## 📜 许可证 + +本项目采用 [MIT](LICENSE) 许可证。 + +--- + +
+ +**如果这个项目对您有帮助，请考虑为其点亮一颗 Star ⭐！** + +## Star History + + + + + + Star History Chart + + + +--- + +**由 [tukuaiai](https://github.com/tukuaiai), [Nicolas Zullo](https://x.com/NicolasZu), 和 [123olp](https://x.com/123olp) 倾力打造** + +[⬆ 返回顶部](#vibe-coding-指南) +
diff --git a/documents/Methodology and Principles/A Formalization of Recursive Self-Optimizing Generative Systems.md b/i18n/zh/documents/Methodology and Principles/A Formalization of Recursive Self-Optimizing Generative Systems.md similarity index 100% rename from documents/Methodology and Principles/A Formalization of Recursive Self-Optimizing Generative Systems.md rename to i18n/zh/documents/Methodology and Principles/A Formalization of Recursive Self-Optimizing Generative Systems.md diff --git a/documents/Methodology and Principles/gluecoding.md b/i18n/zh/documents/Methodology and Principles/gluecoding.md similarity index 100% rename from documents/Methodology and Principles/gluecoding.md rename to i18n/zh/documents/Methodology and Principles/gluecoding.md diff --git a/documents/Methodology and Principles/vibe-coding-经验收集.md b/i18n/zh/documents/Methodology and Principles/vibe-coding-经验收集.md similarity index 100% rename from documents/Methodology and Principles/vibe-coding-经验收集.md rename to i18n/zh/documents/Methodology and Principles/vibe-coding-经验收集.md diff --git a/documents/Methodology and Principles/学习经验.md b/i18n/zh/documents/Methodology and Principles/学习经验.md similarity index 100% rename from documents/Methodology and Principles/学习经验.md rename to i18n/zh/documents/Methodology and Principles/学习经验.md diff --git a/documents/Methodology and Principles/开发经验.md b/i18n/zh/documents/Methodology and Principles/开发经验.md similarity index 100% rename from documents/Methodology and Principles/开发经验.md rename to i18n/zh/documents/Methodology and Principles/开发经验.md diff --git a/documents/Methodology and Principles/系统提示词构建原则.md b/i18n/zh/documents/Methodology and Principles/系统提示词构建原则.md similarity index 100% rename from documents/Methodology and Principles/系统提示词构建原则.md rename to i18n/zh/documents/Methodology and Principles/系统提示词构建原则.md diff --git a/documents/Methodology and Principles/编程之道.md b/i18n/zh/documents/Methodology and Principles/编程之道.md similarity index 100% rename from documents/Methodology and Principles/编程之道.md rename to i18n/zh/documents/Methodology and Principles/编程之道.md diff --git a/documents/Methodology and Principles/胶水编程.md b/i18n/zh/documents/Methodology and Principles/胶水编程.md similarity index 100% rename from documents/Methodology and Principles/胶水编程.md rename to i18n/zh/documents/Methodology and Principles/胶水编程.md diff --git a/documents/README.md b/i18n/zh/documents/README.md similarity index 100% rename from documents/README.md rename to i18n/zh/documents/README.md diff --git a/documents/Templates and Resources/代码组织.md b/i18n/zh/documents/Templates and Resources/代码组织.md similarity index 100% rename from documents/Templates and Resources/代码组织.md rename to i18n/zh/documents/Templates and Resources/代码组织.md diff --git a/documents/Templates and Resources/工具集.md b/i18n/zh/documents/Templates and Resources/工具集.md similarity index 100% rename from documents/Templates and Resources/工具集.md rename to i18n/zh/documents/Templates and Resources/工具集.md diff --git a/documents/Templates and Resources/编程书籍推荐.md b/i18n/zh/documents/Templates and Resources/编程书籍推荐.md similarity index 100% rename from documents/Templates and Resources/编程书籍推荐.md rename to i18n/zh/documents/Templates and Resources/编程书籍推荐.md diff --git a/documents/Templates and Resources/通用项目架构模板.md b/i18n/zh/documents/Templates and Resources/通用项目架构模板.md similarity index 100% rename from documents/Templates and Resources/通用项目架构模板.md rename to i18n/zh/documents/Templates and Resources/通用项目架构模板.md diff --git a/documents/Tutorials and Guides/LazyVim快捷键大全.md b/i18n/zh/documents/Tutorials and Guides/LazyVim快捷键大全.md similarity index 100% rename from documents/Tutorials and Guides/LazyVim快捷键大全.md rename to i18n/zh/documents/Tutorials and Guides/LazyVim快捷键大全.md diff --git a/documents/Tutorials and Guides/auggie-mcp配置文档.md b/i18n/zh/documents/Tutorials and Guides/auggie-mcp配置文档.md similarity index 100% rename from documents/Tutorials and Guides/auggie-mcp配置文档.md rename to i18n/zh/documents/Tutorials and Guides/auggie-mcp配置文档.md diff --git a/documents/Tutorials and Guides/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md b/i18n/zh/documents/Tutorials and Guides/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md similarity index 100% rename from documents/Tutorials and Guides/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md rename to i18n/zh/documents/Tutorials and Guides/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md diff --git a/documents/Tutorials and Guides/tmux快捷键大全.md b/i18n/zh/documents/Tutorials and Guides/tmux快捷键大全.md similarity index 100% rename from documents/Tutorials and Guides/tmux快捷键大全.md rename to i18n/zh/documents/Tutorials and Guides/tmux快捷键大全.md diff --git a/documents/Tutorials and Guides/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md b/i18n/zh/documents/Tutorials and Guides/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md similarity index 100% rename from documents/Tutorials and Guides/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md rename to i18n/zh/documents/Tutorials and Guides/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md diff --git a/prompts/README.md b/i18n/zh/prompts/README.md similarity index 100% rename from prompts/README.md rename to i18n/zh/prompts/README.md diff --git a/prompts/coding_prompts/(1,1)_#_📘_项目上下文文档生成_·_工程化_Prompt（专业优化版）.md b/i18n/zh/prompts/coding_prompts/(1,1)_#_📘_项目上下文文档生成_·_工程化_Prompt（专业优化版）.md similarity index 100% rename from prompts/coding_prompts/(1,1)_#_📘_项目上下文文档生成_·_工程化_Prompt（专业优化版）.md rename to i18n/zh/prompts/coding_prompts/(1,1)_#_📘_项目上下文文档生成_·_工程化_Prompt（专业优化版）.md diff --git a/prompts/coding_prompts/(10,1)_{任务你是首席软件架构师_(Principal_Software_Architect)，专注于构建[高性能__可维护.md b/i18n/zh/prompts/coding_prompts/(10,1)_{任务你是首席软件架构师_(Principal_Software_Architect)，专注于构建[高性能__可维护.md similarity index 100% rename from prompts/coding_prompts/(10,1)_{任务你是首席软件架构师_(Principal_Software_Architect)，专注于构建[高性能__可维护.md rename to i18n/zh/prompts/coding_prompts/(10,1)_{任务你是首席软件架构师_(Principal_Software_Architect)，专注于构建[高性能__可维护.md diff --git a/prompts/coding_prompts/(11,1)_{任务你是一名资深系统架构师与AI协同设计顾问。nn目标：当用户启动一个新项目或请求AI帮助开发功能时，你必须优先帮助用.md b/i18n/zh/prompts/coding_prompts/(11,1)_{任务你是一名资深系统架构师与AI协同设计顾问。nn目标：当用户启动一个新项目或请求AI帮助开发功能时，你必须优先帮助用.md similarity index 100% rename from prompts/coding_prompts/(11,1)_{任务你是一名资深系统架构师与AI协同设计顾问。nn目标：当用户启动一个新项目或请求AI帮助开发功能时，你必须优先帮助用.md rename to i18n/zh/prompts/coding_prompts/(11,1)_{任务你是一名资深系统架构师与AI协同设计顾问。nn目标：当用户启动一个新项目或请求AI帮助开发功能时，你必须优先帮助用.md diff --git a/prompts/coding_prompts/(12,2)_{任务帮我进行智能任务描述，分析与补全任务，你需要理解、描述我当前正在进行的任务，自动识别缺少的要素、未完善的部分、可能.md b/i18n/zh/prompts/coding_prompts/(12,2)_{任务帮我进行智能任务描述，分析与补全任务，你需要理解、描述我当前正在进行的任务，自动识别缺少的要素、未完善的部分、可能.md similarity index 100% rename from prompts/coding_prompts/(12,2)_{任务帮我进行智能任务描述，分析与补全任务，你需要理解、描述我当前正在进行的任务，自动识别缺少的要素、未完善的部分、可能.md rename to i18n/zh/prompts/coding_prompts/(12,2)_{任务帮我进行智能任务描述，分析与补全任务，你需要理解、描述我当前正在进行的任务，自动识别缺少的要素、未完善的部分、可能.md diff --git a/prompts/coding_prompts/(13,1)_#_提示工程师任务说明.md b/i18n/zh/prompts/coding_prompts/(13,1)_#_提示工程师任务说明.md similarity index 100% rename from prompts/coding_prompts/(13,1)_#_提示工程师任务说明.md rename to i18n/zh/prompts/coding_prompts/(13,1)_#_提示工程师任务说明.md diff --git a/prompts/coding_prompts/(14,2)_############################################################.md b/i18n/zh/prompts/coding_prompts/(14,2)_############################################################.md similarity index 100% rename from prompts/coding_prompts/(14,2)_############################################################.md rename to i18n/zh/prompts/coding_prompts/(14,2)_############################################################.md diff --git a/prompts/coding_prompts/(15,1)_###_Claude_Code_八荣八耻.md b/i18n/zh/prompts/coding_prompts/(15,1)_###_Claude_Code_八荣八耻.md similarity index 100% rename from prompts/coding_prompts/(15,1)_###_Claude_Code_八荣八耻.md rename to i18n/zh/prompts/coding_prompts/(15,1)_###_Claude_Code_八荣八耻.md diff --git a/prompts/coding_prompts/(16,3)_#_CLAUDE_记忆.md b/i18n/zh/prompts/coding_prompts/(16,3)_#_CLAUDE_记忆.md similarity index 100% rename from prompts/coding_prompts/(16,3)_#_CLAUDE_记忆.md rename to i18n/zh/prompts/coding_prompts/(16,3)_#_CLAUDE_记忆.md diff --git a/prompts/coding_prompts/(17,2)_#_软件工程分析.md b/i18n/zh/prompts/coding_prompts/(17,2)_#_软件工程分析.md similarity index 100% rename from prompts/coding_prompts/(17,2)_#_软件工程分析.md rename to i18n/zh/prompts/coding_prompts/(17,2)_#_软件工程分析.md diff --git a/prompts/coding_prompts/(18,2)_#_通用项目架构综合分析与优化框架.md b/i18n/zh/prompts/coding_prompts/(18,2)_#_通用项目架构综合分析与优化框架.md similarity index 100% rename from prompts/coding_prompts/(18,2)_#_通用项目架构综合分析与优化框架.md rename to i18n/zh/prompts/coding_prompts/(18,2)_#_通用项目架构综合分析与优化框架.md diff --git a/prompts/coding_prompts/(19,1)_##_角色定义.md b/i18n/zh/prompts/coding_prompts/(19,1)_##_角色定义.md similarity index 100% rename from prompts/coding_prompts/(19,1)_##_角色定义.md rename to i18n/zh/prompts/coding_prompts/(19,1)_##_角色定义.md diff --git a/prompts/coding_prompts/(2,1)_#_ultrathink_ultrathink_ultrathink_ultrathink_ultrathink.md b/i18n/zh/prompts/coding_prompts/(2,1)_#_ultrathink_ultrathink_ultrathink_ultrathink_ultrathink.md similarity index 100% rename from prompts/coding_prompts/(2,1)_#_ultrathink_ultrathink_ultrathink_ultrathink_ultrathink.md rename to i18n/zh/prompts/coding_prompts/(2,1)_#_ultrathink_ultrathink_ultrathink_ultrathink_ultrathink.md diff --git a/prompts/coding_prompts/(20,1)_#_高质量代码开发专家.md b/i18n/zh/prompts/coding_prompts/(20,1)_#_高质量代码开发专家.md similarity index 100% rename from prompts/coding_prompts/(20,1)_#_高质量代码开发专家.md rename to i18n/zh/prompts/coding_prompts/(20,1)_#_高质量代码开发专家.md diff --git a/prompts/coding_prompts/(21,1)_你是我的顶级编程助手，我将使用自然语言描述开发需求。请你将其转换为一个结构化、专业、详细、可执行的编程任务说明文档，输出.md b/i18n/zh/prompts/coding_prompts/(21,1)_你是我的顶级编程助手，我将使用自然语言描述开发需求。请你将其转换为一个结构化、专业、详细、可执行的编程任务说明文档，输出.md similarity index 100% rename from prompts/coding_prompts/(21,1)_你是我的顶级编程助手，我将使用自然语言描述开发需求。请你将其转换为一个结构化、专业、详细、可执行的编程任务说明文档，输出.md rename to i18n/zh/prompts/coding_prompts/(21,1)_你是我的顶级编程助手，我将使用自然语言描述开发需求。请你将其转换为一个结构化、专业、详细、可执行的编程任务说明文档，输出.md diff --git a/prompts/coding_prompts/(22,5)_前几天，我被_Claude_那些臃肿、过度设计的解决方案搞得很沮丧，里面有一大堆我不需要的“万一”功能。然后我尝试在我的.md b/i18n/zh/prompts/coding_prompts/(22,5)_前几天，我被_Claude_那些臃肿、过度设计的解决方案搞得很沮丧，里面有一大堆我不需要的“万一”功能。然后我尝试在我的.md similarity index 100% rename from prompts/coding_prompts/(22,5)_前几天，我被_Claude_那些臃肿、过度设计的解决方案搞得很沮丧，里面有一大堆我不需要的“万一”功能。然后我尝试在我的.md rename to i18n/zh/prompts/coding_prompts/(22,5)_前几天，我被_Claude_那些臃肿、过度设计的解决方案搞得很沮丧，里面有一大堆我不需要的“万一”功能。然后我尝试在我的.md diff --git a/prompts/coding_prompts/(3,1)_#_流程标准化.md b/i18n/zh/prompts/coding_prompts/(3,1)_#_流程标准化.md similarity index 100% rename from prompts/coding_prompts/(3,1)_#_流程标准化.md rename to i18n/zh/prompts/coding_prompts/(3,1)_#_流程标准化.md diff --git a/prompts/coding_prompts/(4,1)_ultrathink__Take_a_deep_breath..md b/i18n/zh/prompts/coding_prompts/(4,1)_ultrathink__Take_a_deep_breath..md similarity index 100% rename from prompts/coding_prompts/(4,1)_ultrathink__Take_a_deep_breath..md rename to i18n/zh/prompts/coding_prompts/(4,1)_ultrathink__Take_a_deep_breath..md diff --git a/prompts/coding_prompts/(5,1)_{content#_🚀_智能需求理解与研发导航引擎（Meta_R&D_Navigator_·.md b/i18n/zh/prompts/coding_prompts/(5,1)_{content#_🚀_智能需求理解与研发导航引擎（Meta_R&D_Navigator_·.md similarity index 100% rename from prompts/coding_prompts/(5,1)_{content#_🚀_智能需求理解与研发导航引擎（Meta_R&D_Navigator_·.md rename to i18n/zh/prompts/coding_prompts/(5,1)_{content#_🚀_智能需求理解与研发导航引擎（Meta_R&D_Navigator_·.md diff --git a/prompts/coding_prompts/(6,1)_{System_Prompt#_🧠_系统提示词：AI_Prompt_编程语言约束与持久化记忆规范nn##.md b/i18n/zh/prompts/coding_prompts/(6,1)_{System_Prompt#_🧠_系统提示词：AI_Prompt_编程语言约束与持久化记忆规范nn##.md similarity index 100% rename from prompts/coding_prompts/(6,1)_{System_Prompt#_🧠_系统提示词：AI_Prompt_编程语言约束与持久化记忆规范nn##.md rename to i18n/zh/prompts/coding_prompts/(6,1)_{System_Prompt#_🧠_系统提示词：AI_Prompt_编程语言约束与持久化记忆规范nn##.md diff --git a/prompts/coding_prompts/(7,1)_#_AI生成代码文档_-_通用提示词模板.md b/i18n/zh/prompts/coding_prompts/(7,1)_#_AI生成代码文档_-_通用提示词模板.md similarity index 100% rename from prompts/coding_prompts/(7,1)_#_AI生成代码文档_-_通用提示词模板.md rename to i18n/zh/prompts/coding_prompts/(7,1)_#_AI生成代码文档_-_通用提示词模板.md diff --git a/prompts/coding_prompts/(8,1)_#_执行📘_文件头注释规范（用于所有代码文件最上方）.md b/i18n/zh/prompts/coding_prompts/(8,1)_#_执行📘_文件头注释规范（用于所有代码文件最上方）.md similarity index 100% rename from prompts/coding_prompts/(8,1)_#_执行📘_文件头注释规范（用于所有代码文件最上方）.md rename to i18n/zh/prompts/coding_prompts/(8,1)_#_执行📘_文件头注释规范（用于所有代码文件最上方）.md diff --git a/prompts/coding_prompts/(9,1)_{角色与目标{你首席软件架构师_(Principal_Software_Architect)（高性能、可维护、健壮、DD.md b/i18n/zh/prompts/coding_prompts/(9,1)_{角色与目标{你首席软件架构师_(Principal_Software_Architect)（高性能、可维护、健壮、DD.md similarity index 100% rename from prompts/coding_prompts/(9,1)_{角色与目标{你首席软件架构师_(Principal_Software_Architect)（高性能、可维护、健壮、DD.md rename to i18n/zh/prompts/coding_prompts/(9,1)_{角色与目标{你首席软件架构师_(Principal_Software_Architect)（高性能、可维护、健壮、DD.md diff --git a/prompts/coding_prompts/docs文件夹中文命名提示词.md b/i18n/zh/prompts/coding_prompts/docs文件夹中文命名提示词.md similarity index 100% rename from prompts/coding_prompts/docs文件夹中文命名提示词.md rename to i18n/zh/prompts/coding_prompts/docs文件夹中文命名提示词.md diff --git a/prompts/coding_prompts/index.md b/i18n/zh/prompts/coding_prompts/index.md similarity index 100% rename from prompts/coding_prompts/index.md rename to i18n/zh/prompts/coding_prompts/index.md diff --git a/prompts/coding_prompts/plan提示词.md b/i18n/zh/prompts/coding_prompts/plan提示词.md similarity index 100% rename from prompts/coding_prompts/plan提示词.md rename to i18n/zh/prompts/coding_prompts/plan提示词.md diff --git a/prompts/coding_prompts/sh控制面板生成.md b/i18n/zh/prompts/coding_prompts/sh控制面板生成.md similarity index 100% rename from prompts/coding_prompts/sh控制面板生成.md rename to i18n/zh/prompts/coding_prompts/sh控制面板生成.md diff --git a/prompts/coding_prompts/人机对齐.md b/i18n/zh/prompts/coding_prompts/人机对齐.md similarity index 100% rename from prompts/coding_prompts/人机对齐.md rename to i18n/zh/prompts/coding_prompts/人机对齐.md diff --git a/prompts/coding_prompts/任务描述，分析与补全任务.md b/i18n/zh/prompts/coding_prompts/任务描述，分析与补全任务.md similarity index 100% rename from prompts/coding_prompts/任务描述，分析与补全任务.md rename to i18n/zh/prompts/coding_prompts/任务描述，分析与补全任务.md diff --git a/prompts/coding_prompts/分析1.md b/i18n/zh/prompts/coding_prompts/分析1.md similarity index 100% rename from prompts/coding_prompts/分析1.md rename to i18n/zh/prompts/coding_prompts/分析1.md diff --git a/prompts/coding_prompts/分析2.md b/i18n/zh/prompts/coding_prompts/分析2.md similarity index 100% rename from prompts/coding_prompts/分析2.md rename to i18n/zh/prompts/coding_prompts/分析2.md diff --git a/prompts/coding_prompts/前端设计.md b/i18n/zh/prompts/coding_prompts/前端设计.md similarity index 100% rename from prompts/coding_prompts/前端设计.md rename to i18n/zh/prompts/coding_prompts/前端设计.md diff --git a/prompts/coding_prompts/客观分析.md b/i18n/zh/prompts/coding_prompts/客观分析.md similarity index 100% rename from prompts/coding_prompts/客观分析.md rename to i18n/zh/prompts/coding_prompts/客观分析.md diff --git a/prompts/coding_prompts/执行纯净性检测.md b/i18n/zh/prompts/coding_prompts/执行纯净性检测.md similarity index 100% rename from prompts/coding_prompts/执行纯净性检测.md rename to i18n/zh/prompts/coding_prompts/执行纯净性检测.md diff --git a/prompts/coding_prompts/智能需求理解与研发导航引擎.md b/i18n/zh/prompts/coding_prompts/智能需求理解与研发导航引擎.md similarity index 100% rename from prompts/coding_prompts/智能需求理解与研发导航引擎.md rename to i18n/zh/prompts/coding_prompts/智能需求理解与研发导航引擎.md diff --git a/prompts/coding_prompts/标准化流程.md b/i18n/zh/prompts/coding_prompts/标准化流程.md similarity index 100% rename from prompts/coding_prompts/标准化流程.md rename to i18n/zh/prompts/coding_prompts/标准化流程.md diff --git a/prompts/coding_prompts/标准项目目录结构.md b/i18n/zh/prompts/coding_prompts/标准项目目录结构.md similarity index 100% rename from prompts/coding_prompts/标准项目目录结构.md rename to i18n/zh/prompts/coding_prompts/标准项目目录结构.md diff --git a/prompts/coding_prompts/简易提示词优化器.md b/i18n/zh/prompts/coding_prompts/简易提示词优化器.md similarity index 100% rename from prompts/coding_prompts/简易提示词优化器.md rename to i18n/zh/prompts/coding_prompts/简易提示词优化器.md diff --git a/prompts/coding_prompts/精华技术文档生成提示词.md b/i18n/zh/prompts/coding_prompts/精华技术文档生成提示词.md similarity index 100% rename from prompts/coding_prompts/精华技术文档生成提示词.md rename to i18n/zh/prompts/coding_prompts/精华技术文档生成提示词.md diff --git a/prompts/coding_prompts/系统架构.md b/i18n/zh/prompts/coding_prompts/系统架构.md similarity index 100% rename from prompts/coding_prompts/系统架构.md rename to i18n/zh/prompts/coding_prompts/系统架构.md diff --git a/prompts/coding_prompts/系统架构可视化生成Mermaid.md b/i18n/zh/prompts/coding_prompts/系统架构可视化生成Mermaid.md similarity index 100% rename from prompts/coding_prompts/系统架构可视化生成Mermaid.md rename to i18n/zh/prompts/coding_prompts/系统架构可视化生成Mermaid.md diff --git a/prompts/coding_prompts/胶水开发.md b/i18n/zh/prompts/coding_prompts/胶水开发.md similarity index 100% rename from prompts/coding_prompts/胶水开发.md rename to i18n/zh/prompts/coding_prompts/胶水开发.md diff --git a/prompts/coding_prompts/输入简单的日常行为的研究报告摘要.md b/i18n/zh/prompts/coding_prompts/输入简单的日常行为的研究报告摘要.md similarity index 100% rename from prompts/coding_prompts/输入简单的日常行为的研究报告摘要.md rename to i18n/zh/prompts/coding_prompts/输入简单的日常行为的研究报告摘要.md diff --git a/prompts/coding_prompts/项目上下文文档生成.md b/i18n/zh/prompts/coding_prompts/项目上下文文档生成.md similarity index 100% rename from prompts/coding_prompts/项目上下文文档生成.md rename to i18n/zh/prompts/coding_prompts/项目上下文文档生成.md diff --git a/prompts/meta_prompts/.gitkeep b/i18n/zh/prompts/meta_prompts/.gitkeep similarity index 100% rename from prompts/meta_prompts/.gitkeep rename to i18n/zh/prompts/meta_prompts/.gitkeep diff --git a/prompts/system_prompts/# 💀《科比的救母救父救未婚妻与岳父岳母日记》 × OTE模型交易模式 × M.I.T白人金融教授（被女学生指控性骚扰版）v2.md b/i18n/zh/prompts/system_prompts/# 💀《科比的救母救父救未婚妻与岳父岳母日记》 × OTE模型交易模式 × M.I.T白人金融教授（被女学生指控性骚扰版）v2.md similarity index 100% rename from prompts/system_prompts/# 💀《科比的救母救父救未婚妻与岳父岳母日记》 × OTE模型交易模式 × M.I.T白人金融教授（被女学生指控性骚扰版）v2.md rename to i18n/zh/prompts/system_prompts/# 💀《科比的救母救父救未婚妻与岳父岳母日记》 × OTE模型交易模式 × M.I.T白人金融教授（被女学生指控性骚扰版）v2.md diff --git a/prompts/system_prompts/CLAUDE.md/1/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/1/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/1/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/1/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/10/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/10/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/10/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/10/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/2/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/2/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/2/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/2/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/3/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/3/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/3/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/3/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/4/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/4/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/4/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/4/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/5/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/5/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/5/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/5/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/6/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/6/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/6/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/6/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/7/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/7/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/7/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/7/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/8/CLAUDE.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/8/CLAUDE.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/8/CLAUDE.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/8/CLAUDE.md diff --git a/prompts/system_prompts/CLAUDE.md/9/AGENTS.md b/i18n/zh/prompts/system_prompts/CLAUDE.md/9/AGENTS.md similarity index 100% rename from prompts/system_prompts/CLAUDE.md/9/AGENTS.md rename to i18n/zh/prompts/system_prompts/CLAUDE.md/9/AGENTS.md diff --git a/prompts/user_prompts/ASCII图生成.md b/i18n/zh/prompts/user_prompts/ASCII图生成.md similarity index 100% rename from prompts/user_prompts/ASCII图生成.md rename to i18n/zh/prompts/user_prompts/ASCII图生成.md diff --git a/prompts/user_prompts/数据管道.md b/i18n/zh/prompts/user_prompts/数据管道.md similarity index 100% rename from prompts/user_prompts/数据管道.md rename to i18n/zh/prompts/user_prompts/数据管道.md diff --git a/prompts/user_prompts/项目变量与工具统一维护.md b/i18n/zh/prompts/user_prompts/项目变量与工具统一维护.md similarity index 100% rename from prompts/user_prompts/项目变量与工具统一维护.md rename to i18n/zh/prompts/user_prompts/项目变量与工具统一维护.md diff --git a/skills/README.md b/i18n/zh/skills/README.md similarity index 100% rename from skills/README.md rename to i18n/zh/skills/README.md diff --git a/skills/ccxt/SKILL.md b/i18n/zh/skills/ccxt/SKILL.md similarity index 100% rename from skills/ccxt/SKILL.md rename to i18n/zh/skills/ccxt/SKILL.md diff --git a/skills/ccxt/references/cli.md b/i18n/zh/skills/ccxt/references/cli.md similarity index 100% rename from skills/ccxt/references/cli.md rename to i18n/zh/skills/ccxt/references/cli.md diff --git a/skills/ccxt/references/exchanges.md b/i18n/zh/skills/ccxt/references/exchanges.md similarity index 100% rename from skills/ccxt/references/exchanges.md rename to i18n/zh/skills/ccxt/references/exchanges.md diff --git a/skills/ccxt/references/faq.md b/i18n/zh/skills/ccxt/references/faq.md similarity index 100% rename from skills/ccxt/references/faq.md rename to i18n/zh/skills/ccxt/references/faq.md diff --git a/skills/ccxt/references/getting_started.md b/i18n/zh/skills/ccxt/references/getting_started.md similarity index 100% rename from skills/ccxt/references/getting_started.md rename to i18n/zh/skills/ccxt/references/getting_started.md diff --git a/skills/ccxt/references/index.md b/i18n/zh/skills/ccxt/references/index.md similarity index 100% rename from skills/ccxt/references/index.md rename to i18n/zh/skills/ccxt/references/index.md diff --git a/skills/ccxt/references/manual.md b/i18n/zh/skills/ccxt/references/manual.md similarity index 100% rename from skills/ccxt/references/manual.md rename to i18n/zh/skills/ccxt/references/manual.md diff --git a/skills/ccxt/references/other.md b/i18n/zh/skills/ccxt/references/other.md similarity index 100% rename from skills/ccxt/references/other.md rename to i18n/zh/skills/ccxt/references/other.md diff --git a/skills/ccxt/references/pro.md b/i18n/zh/skills/ccxt/references/pro.md similarity index 100% rename from skills/ccxt/references/pro.md rename to i18n/zh/skills/ccxt/references/pro.md diff --git a/skills/ccxt/references/specification.md b/i18n/zh/skills/ccxt/references/specification.md similarity index 100% rename from skills/ccxt/references/specification.md rename to i18n/zh/skills/ccxt/references/specification.md diff --git a/skills/claude-code-guide/SKILL.md b/i18n/zh/skills/claude-code-guide/SKILL.md similarity index 100% rename from skills/claude-code-guide/SKILL.md rename to i18n/zh/skills/claude-code-guide/SKILL.md diff --git a/skills/claude-code-guide/references/README.md b/i18n/zh/skills/claude-code-guide/references/README.md similarity index 100% rename from skills/claude-code-guide/references/README.md rename to i18n/zh/skills/claude-code-guide/references/README.md diff --git a/skills/claude-code-guide/references/index.md b/i18n/zh/skills/claude-code-guide/references/index.md similarity index 100% rename from skills/claude-code-guide/references/index.md rename to i18n/zh/skills/claude-code-guide/references/index.md diff --git a/skills/claude-cookbooks/SKILL.md b/i18n/zh/skills/claude-cookbooks/SKILL.md similarity index 100% rename from skills/claude-cookbooks/SKILL.md rename to i18n/zh/skills/claude-cookbooks/SKILL.md diff --git a/skills/claude-cookbooks/references/CONTRIBUTING.md b/i18n/zh/skills/claude-cookbooks/references/CONTRIBUTING.md similarity index 100% rename from skills/claude-cookbooks/references/CONTRIBUTING.md rename to i18n/zh/skills/claude-cookbooks/references/CONTRIBUTING.md diff --git a/skills/claude-cookbooks/references/README.md b/i18n/zh/skills/claude-cookbooks/references/README.md similarity index 100% rename from skills/claude-cookbooks/references/README.md rename to i18n/zh/skills/claude-cookbooks/references/README.md diff --git a/skills/claude-cookbooks/references/capabilities.md b/i18n/zh/skills/claude-cookbooks/references/capabilities.md similarity index 100% rename from skills/claude-cookbooks/references/capabilities.md rename to i18n/zh/skills/claude-cookbooks/references/capabilities.md diff --git a/skills/claude-cookbooks/references/index.md b/i18n/zh/skills/claude-cookbooks/references/index.md similarity index 100% rename from skills/claude-cookbooks/references/index.md rename to i18n/zh/skills/claude-cookbooks/references/index.md diff --git a/skills/claude-cookbooks/references/main_readme.md b/i18n/zh/skills/claude-cookbooks/references/main_readme.md similarity index 100% rename from skills/claude-cookbooks/references/main_readme.md rename to i18n/zh/skills/claude-cookbooks/references/main_readme.md diff --git a/skills/claude-cookbooks/references/multimodal.md b/i18n/zh/skills/claude-cookbooks/references/multimodal.md similarity index 100% rename from skills/claude-cookbooks/references/multimodal.md rename to i18n/zh/skills/claude-cookbooks/references/multimodal.md diff --git a/skills/claude-cookbooks/references/patterns.md b/i18n/zh/skills/claude-cookbooks/references/patterns.md similarity index 100% rename from skills/claude-cookbooks/references/patterns.md rename to i18n/zh/skills/claude-cookbooks/references/patterns.md diff --git a/skills/claude-cookbooks/references/third_party.md b/i18n/zh/skills/claude-cookbooks/references/third_party.md similarity index 100% rename from skills/claude-cookbooks/references/third_party.md rename to i18n/zh/skills/claude-cookbooks/references/third_party.md diff --git a/skills/claude-cookbooks/references/tool_use.md b/i18n/zh/skills/claude-cookbooks/references/tool_use.md similarity index 100% rename from skills/claude-cookbooks/references/tool_use.md rename to i18n/zh/skills/claude-cookbooks/references/tool_use.md diff --git a/skills/claude-cookbooks/scripts/memory_tool.py b/i18n/zh/skills/claude-cookbooks/scripts/memory_tool.py similarity index 100% rename from skills/claude-cookbooks/scripts/memory_tool.py rename to i18n/zh/skills/claude-cookbooks/scripts/memory_tool.py diff --git a/skills/claude-skills/AGENTS.md b/i18n/zh/skills/claude-skills/AGENTS.md similarity index 100% rename from skills/claude-skills/AGENTS.md rename to i18n/zh/skills/claude-skills/AGENTS.md diff --git a/skills/claude-skills/SKILL.md b/i18n/zh/skills/claude-skills/SKILL.md similarity index 100% rename from skills/claude-skills/SKILL.md rename to i18n/zh/skills/claude-skills/SKILL.md diff --git a/skills/claude-skills/assets/template-complete.md b/i18n/zh/skills/claude-skills/assets/template-complete.md similarity index 100% rename from skills/claude-skills/assets/template-complete.md rename to i18n/zh/skills/claude-skills/assets/template-complete.md diff --git a/skills/claude-skills/assets/template-minimal.md b/i18n/zh/skills/claude-skills/assets/template-minimal.md similarity index 100% rename from skills/claude-skills/assets/template-minimal.md rename to i18n/zh/skills/claude-skills/assets/template-minimal.md diff --git a/skills/claude-skills/references/README.md b/i18n/zh/skills/claude-skills/references/README.md similarity index 100% rename from skills/claude-skills/references/README.md rename to i18n/zh/skills/claude-skills/references/README.md diff --git a/skills/claude-skills/references/anti-patterns.md b/i18n/zh/skills/claude-skills/references/anti-patterns.md similarity index 100% rename from skills/claude-skills/references/anti-patterns.md rename to i18n/zh/skills/claude-skills/references/anti-patterns.md diff --git a/skills/claude-skills/references/index.md b/i18n/zh/skills/claude-skills/references/index.md similarity index 100% rename from skills/claude-skills/references/index.md rename to i18n/zh/skills/claude-skills/references/index.md diff --git a/skills/claude-skills/references/quality-checklist.md b/i18n/zh/skills/claude-skills/references/quality-checklist.md similarity index 100% rename from skills/claude-skills/references/quality-checklist.md rename to i18n/zh/skills/claude-skills/references/quality-checklist.md diff --git a/skills/claude-skills/references/skill-spec.md b/i18n/zh/skills/claude-skills/references/skill-spec.md similarity index 100% rename from skills/claude-skills/references/skill-spec.md rename to i18n/zh/skills/claude-skills/references/skill-spec.md diff --git a/skills/claude-skills/scripts/create-skill.sh b/i18n/zh/skills/claude-skills/scripts/create-skill.sh similarity index 100% rename from skills/claude-skills/scripts/create-skill.sh rename to i18n/zh/skills/claude-skills/scripts/create-skill.sh diff --git a/skills/claude-skills/scripts/validate-skill.sh b/i18n/zh/skills/claude-skills/scripts/validate-skill.sh similarity index 100% rename from skills/claude-skills/scripts/validate-skill.sh rename to i18n/zh/skills/claude-skills/scripts/validate-skill.sh diff --git a/skills/coingecko/SKILL.md b/i18n/zh/skills/coingecko/SKILL.md similarity index 100% rename from skills/coingecko/SKILL.md rename to i18n/zh/skills/coingecko/SKILL.md diff --git a/skills/coingecko/references/authentication.md b/i18n/zh/skills/coingecko/references/authentication.md similarity index 100% rename from skills/coingecko/references/authentication.md rename to i18n/zh/skills/coingecko/references/authentication.md diff --git a/skills/coingecko/references/coins.md b/i18n/zh/skills/coingecko/references/coins.md similarity index 100% rename from skills/coingecko/references/coins.md rename to i18n/zh/skills/coingecko/references/coins.md diff --git a/skills/coingecko/references/contract.md b/i18n/zh/skills/coingecko/references/contract.md similarity index 100% rename from skills/coingecko/references/contract.md rename to i18n/zh/skills/coingecko/references/contract.md diff --git a/skills/coingecko/references/exchanges.md b/i18n/zh/skills/coingecko/references/exchanges.md similarity index 100% rename from skills/coingecko/references/exchanges.md rename to i18n/zh/skills/coingecko/references/exchanges.md diff --git a/skills/coingecko/references/index.md b/i18n/zh/skills/coingecko/references/index.md similarity index 100% rename from skills/coingecko/references/index.md rename to i18n/zh/skills/coingecko/references/index.md diff --git a/skills/coingecko/references/introduction.md b/i18n/zh/skills/coingecko/references/introduction.md similarity index 100% rename from skills/coingecko/references/introduction.md rename to i18n/zh/skills/coingecko/references/introduction.md diff --git a/skills/coingecko/references/llms-full.md b/i18n/zh/skills/coingecko/references/llms-full.md similarity index 100% rename from skills/coingecko/references/llms-full.md rename to i18n/zh/skills/coingecko/references/llms-full.md diff --git a/skills/coingecko/references/llms.md b/i18n/zh/skills/coingecko/references/llms.md similarity index 100% rename from skills/coingecko/references/llms.md rename to i18n/zh/skills/coingecko/references/llms.md diff --git a/skills/coingecko/references/market_data.md b/i18n/zh/skills/coingecko/references/market_data.md similarity index 100% rename from skills/coingecko/references/market_data.md rename to i18n/zh/skills/coingecko/references/market_data.md diff --git a/skills/coingecko/references/nfts.md b/i18n/zh/skills/coingecko/references/nfts.md similarity index 100% rename from skills/coingecko/references/nfts.md rename to i18n/zh/skills/coingecko/references/nfts.md diff --git a/skills/coingecko/references/other.md b/i18n/zh/skills/coingecko/references/other.md similarity index 100% rename from skills/coingecko/references/other.md rename to i18n/zh/skills/coingecko/references/other.md diff --git a/skills/coingecko/references/pricing.md b/i18n/zh/skills/coingecko/references/pricing.md similarity index 100% rename from skills/coingecko/references/pricing.md rename to i18n/zh/skills/coingecko/references/pricing.md diff --git a/skills/coingecko/references/reference.md b/i18n/zh/skills/coingecko/references/reference.md similarity index 100% rename from skills/coingecko/references/reference.md rename to i18n/zh/skills/coingecko/references/reference.md diff --git a/skills/coingecko/references/trending.md b/i18n/zh/skills/coingecko/references/trending.md similarity index 100% rename from skills/coingecko/references/trending.md rename to i18n/zh/skills/coingecko/references/trending.md diff --git a/skills/cryptofeed/SKILL.md b/i18n/zh/skills/cryptofeed/SKILL.md similarity index 100% rename from skills/cryptofeed/SKILL.md rename to i18n/zh/skills/cryptofeed/SKILL.md diff --git a/skills/cryptofeed/references/README.md b/i18n/zh/skills/cryptofeed/references/README.md similarity index 100% rename from skills/cryptofeed/references/README.md rename to i18n/zh/skills/cryptofeed/references/README.md diff --git a/skills/cryptofeed/references/index.md b/i18n/zh/skills/cryptofeed/references/index.md similarity index 100% rename from skills/cryptofeed/references/index.md rename to i18n/zh/skills/cryptofeed/references/index.md diff --git a/skills/cryptofeed/references/other.md b/i18n/zh/skills/cryptofeed/references/other.md similarity index 100% rename from skills/cryptofeed/references/other.md rename to i18n/zh/skills/cryptofeed/references/other.md diff --git a/skills/hummingbot/SKILL.md b/i18n/zh/skills/hummingbot/SKILL.md similarity index 100% rename from skills/hummingbot/SKILL.md rename to i18n/zh/skills/hummingbot/SKILL.md diff --git a/skills/hummingbot/references/advanced.md b/i18n/zh/skills/hummingbot/references/advanced.md similarity index 100% rename from skills/hummingbot/references/advanced.md rename to i18n/zh/skills/hummingbot/references/advanced.md diff --git a/skills/hummingbot/references/configuration.md b/i18n/zh/skills/hummingbot/references/configuration.md similarity index 100% rename from skills/hummingbot/references/configuration.md rename to i18n/zh/skills/hummingbot/references/configuration.md diff --git a/skills/hummingbot/references/connectors.md b/i18n/zh/skills/hummingbot/references/connectors.md similarity index 100% rename from skills/hummingbot/references/connectors.md rename to i18n/zh/skills/hummingbot/references/connectors.md diff --git a/skills/hummingbot/references/development.md b/i18n/zh/skills/hummingbot/references/development.md similarity index 100% rename from skills/hummingbot/references/development.md rename to i18n/zh/skills/hummingbot/references/development.md diff --git a/skills/hummingbot/references/getting_started.md b/i18n/zh/skills/hummingbot/references/getting_started.md similarity index 100% rename from skills/hummingbot/references/getting_started.md rename to i18n/zh/skills/hummingbot/references/getting_started.md diff --git a/skills/hummingbot/references/index.md b/i18n/zh/skills/hummingbot/references/index.md similarity index 100% rename from skills/hummingbot/references/index.md rename to i18n/zh/skills/hummingbot/references/index.md diff --git a/skills/hummingbot/references/other.md b/i18n/zh/skills/hummingbot/references/other.md similarity index 100% rename from skills/hummingbot/references/other.md rename to i18n/zh/skills/hummingbot/references/other.md diff --git a/skills/hummingbot/references/strategies.md b/i18n/zh/skills/hummingbot/references/strategies.md similarity index 100% rename from skills/hummingbot/references/strategies.md rename to i18n/zh/skills/hummingbot/references/strategies.md diff --git a/skills/hummingbot/references/trading.md b/i18n/zh/skills/hummingbot/references/trading.md similarity index 100% rename from skills/hummingbot/references/trading.md rename to i18n/zh/skills/hummingbot/references/trading.md diff --git a/skills/hummingbot/references/troubleshooting.md b/i18n/zh/skills/hummingbot/references/troubleshooting.md similarity index 100% rename from skills/hummingbot/references/troubleshooting.md rename to i18n/zh/skills/hummingbot/references/troubleshooting.md diff --git a/skills/polymarket/SKILL.md b/i18n/zh/skills/polymarket/SKILL.md similarity index 100% rename from skills/polymarket/SKILL.md rename to i18n/zh/skills/polymarket/SKILL.md diff --git a/skills/polymarket/references/README.md b/i18n/zh/skills/polymarket/references/README.md similarity index 100% rename from skills/polymarket/references/README.md rename to i18n/zh/skills/polymarket/references/README.md diff --git a/skills/polymarket/references/api.md b/i18n/zh/skills/polymarket/references/api.md similarity index 100% rename from skills/polymarket/references/api.md rename to i18n/zh/skills/polymarket/references/api.md diff --git a/skills/polymarket/references/getting_started.md b/i18n/zh/skills/polymarket/references/getting_started.md similarity index 100% rename from skills/polymarket/references/getting_started.md rename to i18n/zh/skills/polymarket/references/getting_started.md diff --git a/skills/polymarket/references/guides.md b/i18n/zh/skills/polymarket/references/guides.md similarity index 100% rename from skills/polymarket/references/guides.md rename to i18n/zh/skills/polymarket/references/guides.md diff --git a/skills/polymarket/references/index.md b/i18n/zh/skills/polymarket/references/index.md similarity index 100% rename from skills/polymarket/references/index.md rename to i18n/zh/skills/polymarket/references/index.md diff --git a/skills/polymarket/references/learn.md b/i18n/zh/skills/polymarket/references/learn.md similarity index 100% rename from skills/polymarket/references/learn.md rename to i18n/zh/skills/polymarket/references/learn.md diff --git a/skills/polymarket/references/llms-full.md b/i18n/zh/skills/polymarket/references/llms-full.md similarity index 100% rename from skills/polymarket/references/llms-full.md rename to i18n/zh/skills/polymarket/references/llms-full.md diff --git a/skills/polymarket/references/llms.md b/i18n/zh/skills/polymarket/references/llms.md similarity index 100% rename from skills/polymarket/references/llms.md rename to i18n/zh/skills/polymarket/references/llms.md diff --git a/skills/polymarket/references/other.md b/i18n/zh/skills/polymarket/references/other.md similarity index 100% rename from skills/polymarket/references/other.md rename to i18n/zh/skills/polymarket/references/other.md diff --git a/skills/polymarket/references/realtime-client.md b/i18n/zh/skills/polymarket/references/realtime-client.md similarity index 100% rename from skills/polymarket/references/realtime-client.md rename to i18n/zh/skills/polymarket/references/realtime-client.md diff --git a/skills/polymarket/references/trading.md b/i18n/zh/skills/polymarket/references/trading.md similarity index 100% rename from skills/polymarket/references/trading.md rename to i18n/zh/skills/polymarket/references/trading.md diff --git a/skills/postgresql/SKILL.md b/i18n/zh/skills/postgresql/SKILL.md similarity index 100% rename from skills/postgresql/SKILL.md rename to i18n/zh/skills/postgresql/SKILL.md diff --git a/skills/postgresql/references/getting_started.md b/i18n/zh/skills/postgresql/references/getting_started.md similarity index 100% rename from skills/postgresql/references/getting_started.md rename to i18n/zh/skills/postgresql/references/getting_started.md diff --git a/skills/postgresql/references/index.md b/i18n/zh/skills/postgresql/references/index.md similarity index 100% rename from skills/postgresql/references/index.md rename to i18n/zh/skills/postgresql/references/index.md diff --git a/skills/postgresql/references/sql.md b/i18n/zh/skills/postgresql/references/sql.md similarity index 100% rename from skills/postgresql/references/sql.md rename to i18n/zh/skills/postgresql/references/sql.md diff --git a/skills/proxychains/SKILL.md b/i18n/zh/skills/proxychains/SKILL.md similarity index 100% rename from skills/proxychains/SKILL.md rename to i18n/zh/skills/proxychains/SKILL.md diff --git a/skills/proxychains/references/index.md b/i18n/zh/skills/proxychains/references/index.md similarity index 100% rename from skills/proxychains/references/index.md rename to i18n/zh/skills/proxychains/references/index.md diff --git a/skills/proxychains/references/proxychains.conf b/i18n/zh/skills/proxychains/references/proxychains.conf similarity index 100% rename from skills/proxychains/references/proxychains.conf rename to i18n/zh/skills/proxychains/references/proxychains.conf diff --git a/skills/proxychains/references/quick-reference.md b/i18n/zh/skills/proxychains/references/quick-reference.md similarity index 100% rename from skills/proxychains/references/quick-reference.md rename to i18n/zh/skills/proxychains/references/quick-reference.md diff --git a/skills/proxychains/references/setup-guide.md b/i18n/zh/skills/proxychains/references/setup-guide.md similarity index 100% rename from skills/proxychains/references/setup-guide.md rename to i18n/zh/skills/proxychains/references/setup-guide.md diff --git a/skills/proxychains/references/troubleshooting.md b/i18n/zh/skills/proxychains/references/troubleshooting.md similarity index 100% rename from skills/proxychains/references/troubleshooting.md rename to i18n/zh/skills/proxychains/references/troubleshooting.md diff --git a/skills/proxychains/scripts/setup-proxy.sh b/i18n/zh/skills/proxychains/scripts/setup-proxy.sh similarity index 100% rename from skills/proxychains/scripts/setup-proxy.sh rename to i18n/zh/skills/proxychains/scripts/setup-proxy.sh diff --git a/skills/snapdom/SKILL.md b/i18n/zh/skills/snapdom/SKILL.md similarity index 100% rename from skills/snapdom/SKILL.md rename to i18n/zh/skills/snapdom/SKILL.md diff --git a/skills/snapdom/references/index.md b/i18n/zh/skills/snapdom/references/index.md similarity index 100% rename from skills/snapdom/references/index.md rename to i18n/zh/skills/snapdom/references/index.md diff --git a/skills/snapdom/references/other.md b/i18n/zh/skills/snapdom/references/other.md similarity index 100% rename from skills/snapdom/references/other.md rename to i18n/zh/skills/snapdom/references/other.md diff --git a/skills/telegram-dev/SKILL.md b/i18n/zh/skills/telegram-dev/SKILL.md similarity index 100% rename from skills/telegram-dev/SKILL.md rename to i18n/zh/skills/telegram-dev/SKILL.md diff --git a/skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md b/i18n/zh/skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md similarity index 100% rename from skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md rename to i18n/zh/skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md diff --git a/skills/telegram-dev/references/index.md b/i18n/zh/skills/telegram-dev/references/index.md similarity index 100% rename from skills/telegram-dev/references/index.md rename to i18n/zh/skills/telegram-dev/references/index.md diff --git a/skills/telegram-dev/references/动态视图对齐实现文档.md b/i18n/zh/skills/telegram-dev/references/动态视图对齐实现文档.md similarity index 100% rename from skills/telegram-dev/references/动态视图对齐实现文档.md rename to i18n/zh/skills/telegram-dev/references/动态视图对齐实现文档.md diff --git a/skills/timescaledb/SKILL.md b/i18n/zh/skills/timescaledb/SKILL.md similarity index 100% rename from skills/timescaledb/SKILL.md rename to i18n/zh/skills/timescaledb/SKILL.md diff --git a/skills/timescaledb/references/api.md b/i18n/zh/skills/timescaledb/references/api.md similarity index 100% rename from skills/timescaledb/references/api.md rename to i18n/zh/skills/timescaledb/references/api.md diff --git a/skills/timescaledb/references/compression.md b/i18n/zh/skills/timescaledb/references/compression.md similarity index 100% rename from skills/timescaledb/references/compression.md rename to i18n/zh/skills/timescaledb/references/compression.md diff --git a/skills/timescaledb/references/continuous_aggregates.md b/i18n/zh/skills/timescaledb/references/continuous_aggregates.md similarity index 100% rename from skills/timescaledb/references/continuous_aggregates.md rename to i18n/zh/skills/timescaledb/references/continuous_aggregates.md diff --git a/skills/timescaledb/references/getting_started.md b/i18n/zh/skills/timescaledb/references/getting_started.md similarity index 100% rename from skills/timescaledb/references/getting_started.md rename to i18n/zh/skills/timescaledb/references/getting_started.md diff --git a/skills/timescaledb/references/hyperfunctions.md b/i18n/zh/skills/timescaledb/references/hyperfunctions.md similarity index 100% rename from skills/timescaledb/references/hyperfunctions.md rename to i18n/zh/skills/timescaledb/references/hyperfunctions.md diff --git a/skills/timescaledb/references/hypertables.md b/i18n/zh/skills/timescaledb/references/hypertables.md similarity index 100% rename from skills/timescaledb/references/hypertables.md rename to i18n/zh/skills/timescaledb/references/hypertables.md diff --git a/skills/timescaledb/references/index.md b/i18n/zh/skills/timescaledb/references/index.md similarity index 100% rename from skills/timescaledb/references/index.md rename to i18n/zh/skills/timescaledb/references/index.md diff --git a/skills/timescaledb/references/installation.md b/i18n/zh/skills/timescaledb/references/installation.md similarity index 100% rename from skills/timescaledb/references/installation.md rename to i18n/zh/skills/timescaledb/references/installation.md diff --git a/skills/timescaledb/references/llms-full.md b/i18n/zh/skills/timescaledb/references/llms-full.md similarity index 100% rename from skills/timescaledb/references/llms-full.md rename to i18n/zh/skills/timescaledb/references/llms-full.md diff --git a/skills/timescaledb/references/llms.md b/i18n/zh/skills/timescaledb/references/llms.md similarity index 100% rename from skills/timescaledb/references/llms.md rename to i18n/zh/skills/timescaledb/references/llms.md diff --git a/skills/timescaledb/references/other.md b/i18n/zh/skills/timescaledb/references/other.md similarity index 100% rename from skills/timescaledb/references/other.md rename to i18n/zh/skills/timescaledb/references/other.md diff --git a/skills/timescaledb/references/performance.md b/i18n/zh/skills/timescaledb/references/performance.md similarity index 100% rename from skills/timescaledb/references/performance.md rename to i18n/zh/skills/timescaledb/references/performance.md diff --git a/skills/timescaledb/references/time_buckets.md b/i18n/zh/skills/timescaledb/references/time_buckets.md similarity index 100% rename from skills/timescaledb/references/time_buckets.md rename to i18n/zh/skills/timescaledb/references/time_buckets.md diff --git a/skills/timescaledb/references/tutorials.md b/i18n/zh/skills/timescaledb/references/tutorials.md similarity index 100% rename from skills/timescaledb/references/tutorials.md rename to i18n/zh/skills/timescaledb/references/tutorials.md diff --git a/skills/twscrape/SKILL.md b/i18n/zh/skills/twscrape/SKILL.md similarity index 100% rename from skills/twscrape/SKILL.md rename to i18n/zh/skills/twscrape/SKILL.md diff --git a/skills/twscrape/references/examples.md b/i18n/zh/skills/twscrape/references/examples.md similarity index 100% rename from skills/twscrape/references/examples.md rename to i18n/zh/skills/twscrape/references/examples.md diff --git a/skills/twscrape/references/index.md b/i18n/zh/skills/twscrape/references/index.md similarity index 100% rename from skills/twscrape/references/index.md rename to i18n/zh/skills/twscrape/references/index.md diff --git a/skills/twscrape/references/installation.md b/i18n/zh/skills/twscrape/references/installation.md similarity index 100% rename from skills/twscrape/references/installation.md rename to i18n/zh/skills/twscrape/references/installation.md