docs: 更新 AI 上下文文档 (GEMINI, CLAUDE)

CLAUDE.md

@@ -1,84 +1,52 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+This file provides guidance to Claude series models when working with code in this repository.
 
 ## Repository Overview
 
-This is the **Vibe Coding CN** repository - a comprehensive guide and toolset for AI-assisted programming workflows. The project focuses on:
-- Systematic prompt engineering for AI coding assistants
-- Excel ↔ Markdown conversion tools for prompt management
-- Documentation and best practices for vibe coding methodology
+This is the **Vibe Coding CN** repository, a workflow, toolset, and knowledge base for advanced AI-assisted programming. The project's core assets are its extensive `prompts` and `skills` libraries.
 
 ## Key Commands
 
 ### Prompt Library Management
 ```bash
-# Convert Excel prompts to Markdown documentation
+# Enter the library directory
 cd prompts/prompts-library
-python3 main.py
 
-# Non-interactive conversion
-python3 main.py --select "prompt_excel/prompt.xlsx"
-python3 main.py --select "prompt_docs/prompt_docs_2025_1213_080256"
+# Run the interactive conversion tool
+python3 main.py
 ```
 
 ### Development & Maintenance
 ```bash
-# Lint markdown files
+# Lint all markdown files in the repository
 make lint
 
-# Backup project (respects .gitignore)
+# Create a full project backup (respects .gitignore)
 bash backups/一键备份.sh
-# or directly
-python3 backups/快速备份.py
-
-# Install dependencies for prompt library
-cd prompts/prompts-library
-pip install -r requirements.txt
 ```
 
 ## Architecture & Structure
 
 ### Core Directories
-- **`prompts/`** - All AI prompts organized by type
-  - `coding_prompts/` - Development workflow prompts
-  - `system_prompts/` - AI behavior configuration (CLAUDE.md variants 1-10)
-  - `prompts-library/` - Excel↔Markdown conversion tool
-  - `user_prompts/` - User-contributed prompts
-
-- **`documents/`** - Knowledge base and methodology docs
-  - Contains development principles, architecture templates, and experience summaries
-
-- **`libs/`** - Modular code libraries (Python-based)
-  - `common/` - Shared utilities and models
-  - `database/` - Database integration modules
-  - `external/` - Third-party integrations
-
-- **`backups/`** - Project backup utilities
-  - Automated backup with .gitignore compliance
+- **`prompts/`**: The core asset. A massive, well-organized library of prompts.
+  - `coding_prompts/`, `system_prompts/`, `user_prompts/`
+- **`skills/`**: A modular library of skills for the AI, providing domain-specific knowledge for various tools like `ccxt`, `postgresql`, `telegram-dev`, etc.
+- **`documents/`**: The project's knowledge base, containing methodology, principles, and guides.
+- **`prompts/prompts-library/`**: A Python-based tool for converting prompts between Excel and Markdown formats.
+- **`backups/`**: Scripts for project backups.
+- **`libs/`**: Skeleton for shared Python library code.
 
 ### Key Technical Details
-
-1. **Prompt Organization**: Prompts use `(r,c)_` prefix notation for categorization (row,column matrix system)
-
-2. **Conversion Tool**: The prompts-library uses pandas + openpyxl for Excel operations, supports bidirectional conversion with rich CLI interface
-
-3. **System Prompts**: Multiple CLAUDE.md variants (1-10) represent different AI behavior configurations, with version 10 being the latest comprehensive version incorporating augment context engine requirements
-
-4. **Documentation Standards**: All user-facing documentation in Chinese, code/structure in English
+1.  **Prompt Organization**: Prompts use a `(row,col)_` prefix for categorization.
+2.  **Conversion Tool**: The `prompts-library` uses Python with `pandas` and `openpyxl`.
+3.  **Documentation Standard**: User-facing documentation is in Chinese. Code, file names, and structure are in English.
+4.  **Skills**: The `skills` directory provides context and knowledge for specific tools and domains, each with its own `SKILL.md`.
 
 ## Development Workflow
 
 When modifying this repository:
-1. Follow the existing prompt categorization system
-2. Update both Excel and Markdown versions when modifying prompts
-3. Use the conversion tool to maintain consistency
-4. Run backups before major changes
-5. Follow the Chinese(文档)/English(代码) language separation
-
-## Important Notes
-
-- This is a documentation and tooling repository, not a runtime application
-- The Makefile commands are mostly placeholders - actual functionality is in Python scripts
-- Prompt management is the core functionality - always use the conversion tools to maintain consistency
-- The repository serves as a knowledge base for vibe coding best practices
+1.  Follow the existing prompt and skill categorization systems.
+2.  Use the `prompts-library` tool to maintain consistency when updating prompts.
+3.  Run `make lint` after changing any Markdown files.
+4.  Run a backup with `bash backups/一键备份.sh` before any major refactoring.

GEMINI.md

@@ -2,7 +2,7 @@
 
 ## 项目概述 (Project Overview)
 
-`vibe-coding-cn` 项目旨在提供一个通过与 AI 结对编程实现“将想法变为现实”的终极工作流程。它强调“规划驱动”和“模块化”的核心理念，旨在避免 AI 失控导致的项目混乱。该项目不仅仅是一个代码库，更是一个全面的 AI 结对编程指南和工具集，涵盖了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程。
+`vibe-coding-cn` 项目旨在提供一个通过与 AI 结对编程实现“将想法变为现实”的终极工作流程。它强调“规划驱动”和“模块化”的核心理念，旨在避免 AI 失控导致的项目混乱。该项目不仅仅是一个代码库，更是一个全面的 AI 结对编程指南、庞大的提示词库和模块化的技能工具集，涵盖了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程。
 
 **核心理念:** 规划是核心，通过结构化、模块化的方式引导 AI，确保项目可控、可维护。
 
@@ -13,89 +13,69 @@
 *   **核心语言:** Python (用于 `prompts-library` 工具和备份脚本)
 *   **CLI 交互:** `rich`, `InquirerPy` (用于 `prompts-library` 提供友好的命令行界面)
 *   **数据处理:** `pandas`, `openpyxl` (用于 `prompts-library` 处理 Excel 文件)
-*   **配置管理:** `PyYAML`, `python-dotenv` (用于配置和环境变量)
-*   **文档规范:** `markdownlint-cli` (用于 `Makefile` 中的 `lint` 任务，确保 Markdown 文档质量)
-*   **AI 辅助工具集成:** `auggie-mcp` (用于增强 AI 在代码库中的检索和分析能力，支持 Claude Code 和 Codex)
+*   **配置管理:** `PyYAML` (用于 `prompts-library` 的配置)
+*   **文档规范:** `markdownlint-cli` (用于 `Makefile` 中的 `lint` 任务)
 *   **版本控制:** Git
-*   **自动化:** Makefile (用于定义项目自动化任务，如 lint)
-*   **操作系统:** 兼容 Linux (备份脚本中的路径处理)
+*   **自动化:** Makefile
+*   **操作系统:** 兼容 Linux
 
 ## 主要功能与工作流程 (Key Features & Workflow)
 
-1.  **AI 提示词管理 (`prompts-library`):**
-    *   提供 Python 工具 (`main.py`, `scripts/start_convert.py`)，用于在 Excel 工作簿 (`prompt_excel/`) 和 Markdown 文档 (`prompt_docs/`) 之间进行提示词的相互转换。
-    *   支持交互式选择和非交互式命令行操作，方便自动化处理。
-    *   输出文件会带有时间戳，便于管理和回溯。
+1.  **AI 提示词库 (`prompts/`):**
+    *   一个极其庞大和精细分类的提示词集合，是项目的核心资产。
+    *   `coding_prompts/`: 专注于编程和代码生成的提示词。
+    *   `system_prompts/`: 用于设定 AI 行为和思维框架的系统级提示词。
+    *   `user_prompts/`: 用户自定义或常用的提示词。
 
-2.  **丰富的 AI 提示词库 (`prompts/`):**
-    *   `coding_prompts/`: 专注于编程和代码生成的提示词，包含用于项目上下文文档生成等工程化提示词。
-    *   `system_prompts/`: 包含用于设定 AI 行为和思维框架的系统级提示词，如 `CLAUDE.md` 系列。
-    *   `user_prompts/`: 存放用户自定义或常用的提示词。
-    *   `assistant_prompts/`: 辅助类提示词 (虽然目录存在但未在 `README.md` 中详细说明)。
+2.  **提示词库管理工具 (`prompts/prompts-library/`):**
+    *   提供 Python 工具 (`main.py`)，用于在 Excel 工作簿 (`prompt_excel/`) 和 Markdown 文档 (`prompt_docs/`) 之间进行提示词的相互转换。
+    *   支持交互式和非交互式操作。
 
-3.  **项目备份工具 (`backups/`):**
-    *   `快速备份.py` 是一个 Python 脚本，能根据 `.gitignore` 规则智能地打包项目文件为 `.tar.gz` 格式。
-    *   通过 `一键备份.sh` 脚本可快速执行备份操作。
+3.  **技能库 (`skills/`):**
+    *   一个模块化的技能集合，为 AI 提供了特定工具和领域的知识。
+    *   每个技能（如 `ccxt`, `postgresql`, `telegram-dev`）都包含独立的 `SKILL.md` 描述、参考资料和脚本。
 
-4.  **AI 结对编程工作流指南:**
-    *   `README.md` 详细阐述了“规划驱动 + 上下文固定 + AI 结对执行”的核心工作流。
-    *   提供了 3 分钟 CLI 演示剧本，指导用户如何利用项目中的提示词进行需求理解、计划生成和代码实现。
-    *   强调了 AI 工具（如 Claude Code, Codex CLI）的使用技巧和最佳实践。
+4.  **项目备份工具 (`backups/`):**
+    *   `快速备份.py` 脚本能根据 `.gitignore` 规则智能地打包项目文件为 `.tar.gz` 格式。
 
 5.  **知识库与文档 (`documents/`):**
     *   包含代码组织、开发经验、系统提示词构建原则、项目架构模板等各类文档。
-    *   `auggie-mcp配置文档.md` 提供了配置 `auggie-mcp` 的详细指引，以提升 AI 的代码理解能力。
-
-## 开发与自动化 (Development & Automation)
-
-*   **linting:** 使用 `Makefile` 中的 `lint` 任务，通过 `markdownlint-cli` 确保 Markdown 文档的格式和规范。
-*   **构建/测试:** `Makefile` 中包含 `build` 和 `test` 的占位符，表明未来可能集成更完善的自动化构建和测试流程。目前这些可能依赖于具体的 Python 脚本或其他外部工具。
-*   **依赖管理:** Python 依赖通过 `prompts/prompts-library/requirements.txt` 进行管理。
-
-## 贡献与规范 (Contribution & Conventions)
-
-*   项目欢迎各种形式的贡献，并提供了 `CONTRIBUTING.md` 和 `CODE_OF_CONDUCT.md` 作为贡献者指南和行为准则。
-*   文档质量和规范性受到重视，通过 `markdownlint` 进行检查。
 
 ## 文件结构 (File Structure)
 
 ```
 .
-├── CODE_OF_CONDUCT.md           # 社区行为准则，规范贡献者行为。
-├── CONTRIBUTING.md              # 贡献指南，说明如何为本项目做出贡献。
-├── LICENSE                      # 开源许可证文件。
-├── Makefile                     # 项目自动化脚本，用于代码检查、构建等。
-├── README.md                    # 项目主文档，包含项目概览、使用指南、资源链接等。
-├── .gitignore                   # Git 忽略文件。
+├── AGENTS.md                    # 面向 AI Agent 的贡献与行为准则。
+├── CLAUDE.md                    # 面向 Claude 模型的上下文与指令。
+├── GEMINI.md                    # 面向 Gemini 模型的上下文与指令 (本文档)。
+├── README.md                    # 项目主文档，包含项目概览、使用指南等。
+├── Makefile                     # 项目自动化脚本 (lint, backup 等)。
 │
-├── documents/                   # 存放各类说明文档、经验总结和配置详细说明。
-│   ├── auggie-mcp配置文档.md      # Augment 上下文引擎配置文档。
-│   ├── 代码组织.md                # 代码组织与结构相关文档。
-│   └── ... (其他文档)
+├── backups/                     # 项目备份脚本。
+│   ├── 一键备份.sh
+│   └── 快速备份.py
 │
-├── prompts/                     # 集中存放所有类型的 AI 提示词。
-│   ├── coding_prompts/          # 专门用于编程和代码生成相关的提示词集合。
-│   │   ├── (1,1)_#_📘_项目上下文文档生成_·_工程化_Prompt（专业优化版）.md # 具体编程提示词示例。
-│   │   └── ... (其他具体编程提示词文件)
-│   │
-│   ├── prompts-library/         # 提示词库管理工具。
-│   │   ├── main.py              # 提示词库管理工具主入口，处理 Excel 与 Markdown 转换。
-│   │   ├── requirements.txt     # Python 依赖列表。
-│   │   ├── scripts/             # 包含 Excel 与 Markdown 互转脚本和配置。
-│   │   └── ... (其他 prompts-library 内部文件)
-│   │
-│   ├── system_prompts/          # AI 系统级提示词，用于设定 AI 行为和框架。
-│   │   └── CLAUDE.md/           # 包含多版本 AI 系统提示词。
-│   │   └── ... (其他系统提示词)
-│   │
-│   └── user_prompts/            # 用户自定义或常用提示词。
-│       └── ... (具体用户提示词文件)
+├── documents/                   # 存放各类说明文档、经验总结和配置。
 │
-├── backups/                     # 项目备份脚本。
-│   ├── 一键备份.sh                # 一键执行备份的 Shell 脚本。
-│   └── 快速备份.py                # 实际执行逻辑的 Python 脚本，支持 .gitignore 规则。
+├── libs/                        # 通用库代码 (当前为骨架)。
+│   ├── common/
+│   ├── database/
+│   └── external/
+│
+├── prompts/                     # 核心资产：AI 提示词库。
+│   ├── coding_prompts/          # 编程与代码生成相关提示词。
+│   ├── prompts-library/         # 提示词库管理工具 (Excel-Markdown 互转)。
+│   │   ├── main.py
+│   │   ├── requirements.txt
+│   │   ├── prompt_excel/
+│   │   └── prompt_docs/
+│   ├── system_prompts/          # AI 系统级提示词。
+│   └── user_prompts/            # 用户自定义提示词。
 │
-└── libs/                        # 通用库代码，用于项目内部模块化。
-    ├── common/                  # 通用功能模块。
-    │   └── __init__.py          # Python 包初始化文件。
-    └── ... (其他 libs 模块)
+└── skills/                      # 模块化技能库。
+    ├── ccxt/                    # CCXT 加密货币交易库技能。
+    ├── claude-code-guide/       # Claude Code 使用指南技能。
+    ├── postgresql/              # PostgreSQL 数据库技能。
+    ├── telegram-dev/            # Telegram Bot 开发技能。
+    └── ... (其他 10+ 个技能)
+```