docs: 简化多语言结构，删除 i18n/README.md
This commit is contained in:
tukuaiai
parent
132d3e6902
commit
aa154e687c
|
|
@ -30,9 +30,8 @@
|
|||
|
||||
<!-- 多语言入口 -->
|
||||
<p>
|
||||
<a href="./i18n/zh/README.md"><img src="https://img.shields.io/badge/语言-中文-red?style=for-the-badge" alt="简体中文"></a>
|
||||
<a href="./README.md"><img src="https://img.shields.io/badge/语言-中文-red?style=for-the-badge" alt="简体中文"></a>
|
||||
<a href="./i18n/en/README.md"><img src="https://img.shields.io/badge/语言-English-lightgrey?style=for-the-badge" alt="English"></a>
|
||||
<a href="./i18n/README.md"><img src="https://img.shields.io/badge/🌐_更多语言-25+-blue?style=for-the-badge" alt="更多语言"></a>
|
||||
</p>
|
||||
|
||||
<!-- 资源直达 - 按重要性分组 -->
|
||||
|
|
|
|||
|
|
@ -1,74 +0,0 @@
|
|||
# 🌍 多语言支持 / Internationalization (i18n)
|
||||
|
||||
本项目支持多种语言版本。选择您的语言：
|
||||
|
||||
---
|
||||
|
||||
## 🔴 主要语言 / Primary Languages
|
||||
|
||||
| 语言 | Language | 状态 | 入口 |
|
||||
|:---|:---|:---|:---|
|
||||
| 🇨🇳 简体中文 | Chinese (Simplified) | ✅ 完整 | [进入](./zh/README.md) |
|
||||
| 🇺🇸 English | English | ✅ 完整 | [Enter](./en/README.md) |
|
||||
|
||||
---
|
||||
|
||||
## 🌐 其他语言 / Other Languages
|
||||
|
||||
> ⚠️ 以下语言版本为骨架目录，欢迎社区贡献翻译！
|
||||
|
||||
| 语言 | Language | 代码 | 入口 |
|
||||
|:---|:---|:---|:---|
|
||||
| 🇸🇦 العربية | Arabic | `ar` | [ar/](./ar/) |
|
||||
| 🇧🇩 বাংলা | Bengali | `bn` | [bn/](./bn/) |
|
||||
| 🇩🇪 Deutsch | German | `de` | [de/](./de/) |
|
||||
| 🇪🇸 Español | Spanish | `es` | [es/](./es/) |
|
||||
| 🇮🇷 فارسی | Farsi | `fa` | [fa/](./fa/) |
|
||||
| 🇫🇷 Français | French | `fr` | [fr/](./fr/) |
|
||||
| 🇳🇬 Hausa | Hausa | `ha` | [ha/](./ha/) |
|
||||
| 🇮🇱 עברית | Hebrew | `he` | [he/](./he/) |
|
||||
| 🇮🇳 हिन्दी | Hindi | `hi` | [hi/](./hi/) |
|
||||
| 🇮🇩 Bahasa Indonesia | Indonesian | `id` | [id/](./id/) |
|
||||
| 🇮🇹 Italiano | Italian | `it` | [it/](./it/) |
|
||||
| 🇯🇵 日本語 | Japanese | `ja` | [ja/](./ja/) |
|
||||
| 🇰🇷 한국어 | Korean | `ko` | [ko/](./ko/) |
|
||||
| 🇲🇾 Bahasa Melayu | Malay | `ms` | [ms/](./ms/) |
|
||||
| 🇳🇱 Nederlands | Dutch | `nl` | [nl/](./nl/) |
|
||||
| 🇵🇱 Polski | Polish | `pl` | [pl/](./pl/) |
|
||||
| 🇧🇷 Português | Portuguese | `pt` | [pt/](./pt/) |
|
||||
| 🇷🇺 Русский | Russian | `ru` | [ru/](./ru/) |
|
||||
| 🇰🇪 Kiswahili | Swahili | `sw` | [sw/](./sw/) |
|
||||
| 🇮🇳 தமிழ் | Tamil | `ta` | [ta/](./ta/) |
|
||||
| 🇹🇭 ไทย | Thai | `th` | [th/](./th/) |
|
||||
| 🇹🇷 Türkçe | Turkish | `tr` | [tr/](./tr/) |
|
||||
| 🇺🇦 Українська | Ukrainian | `uk` | [uk/](./uk/) |
|
||||
| 🇵🇰 اردو | Urdu | `ur` | [ur/](./ur/) |
|
||||
| 🇻🇳 Tiếng Việt | Vietnamese | `vi` | [vi/](./vi/) |
|
||||
|
||||
---
|
||||
|
||||
## 📁 目录结构
|
||||
|
||||
每个语言目录遵循统一结构：
|
||||
|
||||
```
|
||||
i18n/<lang>/
|
||||
├── README.md # 语言入口
|
||||
├── documents/ # 文档
|
||||
├── prompts/ # 提示词
|
||||
└── skills/ # 技能
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🤝 贡献翻译
|
||||
|
||||
欢迎为任何语言贡献翻译！请参考 [CONTRIBUTING.md](../CONTRIBUTING.md)。
|
||||
|
||||
1. Fork 本仓库
|
||||
2. 在对应语言目录下添加/修改内容
|
||||
3. 提交 Pull Request
|
||||
|
||||
---
|
||||
|
||||
[← 返回主页](../README.md)
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ar 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# bn 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# de 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -5,7 +5,7 @@
|
|||
-->
|
||||
<p align="center">
|
||||
<!-- Recommended size: 1280x640px. Can be created using tools like Canva, Figma or https://banners.beyondco.de/ -->
|
||||
<img src="https://github.com/tukuaiai.png" alt="Vibe Coding Guide" width="80px">
|
||||
<img src="https://github.com/tukuaiai.png" alt="Vibe Coding Guide" width="50px">
|
||||
</p>
|
||||
|
||||
<div align="center">
|
||||
|
|
@ -21,55 +21,49 @@
|
|||
-->
|
||||
<!-- Project Status Badges -->
|
||||
<p>
|
||||
<a href="../../LICENSE"><img src="https://img.shields.io/github/license/tukuaiai/vibe-coding-cn?label=License&style=for-the-badge" alt="License"></a>
|
||||
<a href="LICENSE"><img src="https://img.shields.io/github/license/tukuaiai/vibe-coding-cn?label=License&style=for-the-badge" alt="License"></a>
|
||||
<a href="https://github.com/tukuaiai/vibe-coding-cn"><img src="https://img.shields.io/github/languages/top/tukuaiai/vibe-coding-cn?label=Language&style=for-the-badge" alt="Main Language"></a>
|
||||
<a href="https://github.com/tukuaiai/vibe-coding-cn"><img src="https://img.shields.io/github/languages/code-size/tukuaiai/vibe-coding-cn?label=Code%20Size&style=for-the-badge" alt="Code Size"></a>
|
||||
<a href="https://github.com/tukuaiai/vibe-coding-cn/graphs/contributors"><img src="https://img.shields.io/github/contributors/tukuaiai/vibe-coding-cn?label=Contributors&style=for-the-badge" alt="Contributors"></a>
|
||||
<a href="https://x.com/123olp"><img src="https://img.shields.io/badge/X-@123olp-black?style=for-the-badge&logo=x" alt="X"></a>
|
||||
<a href="https://t.me/glue_coding"><img src="https://img.shields.io/badge/Chat-Telegram-blue?style=for-the-badge&logo=telegram" alt="Telegram Group"></a>
|
||||
</p>
|
||||
|
||||
<!-- Multilingual Entry -->
|
||||
<p>
|
||||
<a href="../zh/README.md"><img src="https://img.shields.io/badge/Lang-中文-red?style=for-the-badge" alt="Simplified Chinese"></a>
|
||||
<a href="../en/README.md"><img src="https://img.shields.io/badge/Lang-English-lightgrey?style=for-the-badge" alt="English"></a>
|
||||
<a href="../README.md"><img src="https://img.shields.io/badge/🌐_More_Languages-25+-blue?style=for-the-badge" alt="More Languages"></a>
|
||||
<a href="../../README.md"><img src="https://img.shields.io/badge/Lang-中文-red?style=for-the-badge" alt="简体中文"></a>
|
||||
<a href="./README.md"><img src="https://img.shields.io/badge/Lang-English-lightgrey?style=for-the-badge" alt="English"></a>
|
||||
</p>
|
||||
|
||||
<!-- Resource Quick Links - Grouped by Importance -->
|
||||
<!-- 🔴 Core Concepts (Red) -->
|
||||
<p>
|
||||
<a href="./documents/01-getting-started/00-Vibe%20Coding%20Philosophy.md"><img src="https://img.shields.io/badge/🧠_Core_Philosophy-Must_Read-crimson?style=for-the-badge" alt="Core Philosophy"></a>
|
||||
<a href="./documents/00-fundamentals/Glue%20Coding.md"><img src="https://img.shields.io/badge/🧬_Glue_Coding-Silver_Bullet-red?style=for-the-badge" alt="Glue Coding"></a>
|
||||
<a href="./documents/01-getting-started/README.md"><img src="https://img.shields.io/badge/🚀_Getting_Started-Beginners-red?style=for-the-badge" alt="Getting Started"></a>
|
||||
<a href="./documents/00-fundamentals/Language%20Layer%20Elements.md"><img src="https://img.shields.io/badge/📊_Language_Layers-12_Levels-gold?style=for-the-badge" alt="Language Layers"></a>
|
||||
<a href="./documents/00-fundamentals/Common%20Pitfalls.md"><img src="https://img.shields.io/badge/🕳️_Common_Pitfalls-Guide-yellow?style=for-the-badge" alt="Common Pitfalls"></a>
|
||||
<a href="./documents/04-resources/External%20Resource%20Aggregation.md"><img src="https://img.shields.io/badge/📡_Resources-Aggregation-teal?style=for-the-badge" alt="Resource Aggregation"></a>
|
||||
</p>
|
||||
<!-- 🟠 Methodology (Orange) -->
|
||||
<p>
|
||||
<a href="./documents/00-fundamentals/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md"><img src="https://img.shields.io/badge/📐_Meta_Methodology-Recursive-darkorange?style=for-the-badge" alt="Meta Methodology"></a>
|
||||
<a href="./documents/00-fundamentals/The%20Way%20of%20Programming.md"><img src="https://img.shields.io/badge/🧭_Way_of_Programming-Dao_Fa_Shu-orange?style=for-the-badge" alt="Way of Programming"></a>
|
||||
<a href="./documents/03-practice/README.md"><img src="https://img.shields.io/badge/🎬_Practice-Projects-orange?style=for-the-badge" alt="Practice Projects"></a>
|
||||
</p>
|
||||
<!-- 🟡 Practical Tools (Yellow/Green) -->
|
||||
<p>
|
||||
<a href="./documents/04-resources/Tool%20Collection.md"><img src="https://img.shields.io/badge/🛠️_Tools-Quick_Ref-teal?style=for-the-badge" alt="Tools"></a>
|
||||
</p>
|
||||
<!-- 🔵 Resource Library (Blue/Purple) -->
|
||||
<p>
|
||||
<a href="./prompts/"><img src="https://img.shields.io/badge/💬_Prompts-Curated-purple?style=for-the-badge" alt="Curated Prompts"></a>
|
||||
<a href="./skills/"><img src="https://img.shields.io/badge/⚡_Skills-Collection-forestgreen?style=for-the-badge" alt="Skills Collection"></a>
|
||||
<a href="https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1"><img src="https://img.shields.io/badge/📋_Prompts-Online_Sheet-blue?style=for-the-badge" alt="Online Prompt Sheet"></a>
|
||||
<a href="../zh/documents/-01-哲学与方法论/README.md"><img src="https://img.shields.io/badge/🔮_Philosophy_&_Methodology-Protocol-purple?style=for-the-badge" alt="Philosophy & Methodology"></a>
|
||||
<a href="../zh/documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md"><img src="https://img.shields.io/badge/🧠_Core_Philosophy-Must_Read-crimson?style=for-the-badge" alt="Core Philosophy"></a>
|
||||
<a href="../zh/documents/00-基础指南/胶水编程.md"><img src="https://img.shields.io/badge/🧬_Glue_Coding-Silver_Bullet-red?style=for-the-badge" alt="Glue Coding"></a>
|
||||
<a href="../zh/documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md"><img src="https://img.shields.io/badge/🎨_Canvas_Whiteboard-Visual_Driven-orange?style=for-the-badge" alt="Canvas Whiteboard Driven Development"></a>
|
||||
<a href="../zh/documents/01-入门指南/README.md"><img src="https://img.shields.io/badge/🚀_Getting_Started-Beginners-red?style=for-the-badge" alt="Getting Started"></a>
|
||||
<a href="../zh/documents/00-基础指南/血的教训.md"><img src="https://img.shields.io/badge/🩸_Blood_Lessons-Must_See-red?style=for-the-badge" alt="Blood Lessons"></a>
|
||||
<a href="../zh/documents/00-基础指南/语言层要素.md"><img src="https://img.shields.io/badge/📊_Language_Layers-12_Levels-gold?style=for-the-badge" alt="Language Layer Elements"></a>
|
||||
<a href="../zh/documents/00-基础指南/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳️_Common_Pitfalls-Guide-yellow?style=for-the-badge" alt="Common Pitfalls"></a>
|
||||
<a href="../zh/documents/00-基础指南/强前置条件约束.md"><img src="https://img.shields.io/badge/🚫_Hard_Constraints-Iron_Laws-darkred?style=for-the-badge" alt="Hard Constraints"></a>
|
||||
<a href="../zh/documents/04-资源/外部资源聚合.md"><img src="https://img.shields.io/badge/📡_Resources-Aggregation-teal?style=for-the-badge" alt="Resource Aggregation"></a>
|
||||
<a href="../zh/documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md"><img src="https://img.shields.io/badge/📐_Meta_Methodology-Recursive-darkorange?style=for-the-badge" alt="Meta Methodology"></a>
|
||||
<a href="../zh/documents/00-基础指南/编程之道.md"><img src="https://img.shields.io/badge/🧭_Way_of_Programming-Dao_Fa_Shu-orange?style=for-the-badge" alt="Way of Programming"></a>
|
||||
<a href="../zh/documents/03-实战/README.md"><img src="https://img.shields.io/badge/🎬_Practice-Projects-orange?style=for-the-badge" alt="Practice Projects"></a>
|
||||
<a href="../zh/documents/04-资源/工具集.md"><img src="https://img.shields.io/badge/🛠️_Tools-Quick_Ref-teal?style=for-the-badge" alt="Tools"></a>
|
||||
<a href="../zh/prompts/"><img src="https://img.shields.io/badge/💬_Prompts-Curated-purple?style=for-the-badge" alt="Curated Prompts"></a>
|
||||
<a href="../zh/skills/"><img src="https://img.shields.io/badge/⚡_Skills-Collection-forestgreen?style=for-the-badge" alt="Skills Collection"></a>
|
||||
<a href="https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203"><img src="https://img.shields.io/badge/📋_Prompts-Online_Sheet-blue?style=for-the-badge" alt="Online Prompt Sheet"></a>
|
||||
<a href="https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools"><img src="https://img.shields.io/badge/🔧_System_Prompts-Repo-slateblue?style=for-the-badge" alt="System Prompts Repo"></a>
|
||||
<a href="../../libs/external/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI_Sessions-gold?style=for-the-badge" alt="Chat Vault"></a>
|
||||
<a href="../../libs/external/chat-vault/README_CN.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI_Sessions-gold?style=for-the-badge" alt="Chat Vault"></a>
|
||||
</p>
|
||||
|
||||
[📋 Tools & Resources](#-the-tools-qi)
|
||||
[🚀 Getting Started](#-getting-started-beginners)
|
||||
[⚙️ Full Setup](#️-full-setup-process)
|
||||
[📞 Contact](#-contact-information)
|
||||
[✨ Support](#-support-project)
|
||||
[🚀 Getting Started](#-getting-started)
|
||||
[🎯 Original Repository Translation](#-original-repository-translation)
|
||||
[⚙️ Full Setup Process](#️-full-setup-process)
|
||||
[📞 Contact](#-contact)
|
||||
[✨ Support Project](#-support-project)
|
||||
[🤝 Contributing](#-contributing)
|
||||
|
||||
AI interpretation link for this repository: [zread.ai/tukuaiai/vibe-coding-cn](https://zread.ai/tukuaiai/vibe-coding-cn/1-overview)
|
||||
|
|
@ -115,14 +109,14 @@ Requirement: After completing each step, ask me if it was successful before cont
|
|||
|
||||
---
|
||||
|
||||
## 🚀 Getting Started (Beginners)
|
||||
## 🚀 Getting Started
|
||||
|
||||
Complete beginner? Follow these steps in order:
|
||||
|
||||
0. [00-Vibe Coding Philosophy](./documents/01-getting-started/00-Vibe%20Coding%20Philosophy.md) - Understand core concepts
|
||||
1. [01-Network Environment Configuration](./documents/01-getting-started/01-Network%20Environment%20Configuration.md) - Configure network access
|
||||
2. [02-Development Environment Setup](./documents/01-getting-started/02-Development%20Environment%20Setup.md) - Copy prompts to AI, let AI guide you
|
||||
3. [03-IDE Configuration](./documents/01-getting-started/03-IDE%20Configuration.md) - Configure VS Code editor
|
||||
0. [00-Vibe Coding Philosophy](../zh/documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md) - Understand core concepts
|
||||
1. [01-Network Environment Configuration](../zh/documents/01-入门指南/01-网络环境配置.md) - Configure network access
|
||||
2. [02-Development Environment Setup](../zh/documents/01-入门指南/02-开发环境搭建.md) - Copy prompts to AI, let AI guide you through environment setup
|
||||
3. [03-IDE Configuration](../zh/documents/01-入门指南/03-IDE配置.md) - Configure VS Code editor
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -141,7 +135,49 @@ Glue Coding is the ultimate evolution of Vibe Coding, potentially solving three
|
|||
|
||||
**Core Philosophy**: Copy instead of write, connect instead of create, reuse instead of reinvent.
|
||||
|
||||
👉 [Learn more about Glue Coding](./documents/00-fundamentals/Glue%20Coding.md)
|
||||
👉 [Learn more about Glue Coding](../zh/documents/00-基础指南/胶水编程.md)
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>🎨 Canvas Whiteboard-Driven Development</strong></summary>
|
||||
|
||||
> **A New Paradigm for Visual AI Collaboration**
|
||||
|
||||
Traditional development: Code → Verbal communication → Mental architecture → Code out of control
|
||||
|
||||
Canvas approach: **Code ⇄ Whiteboard ⇄ AI ⇄ Human**, whiteboard becomes the single source of truth
|
||||
|
||||
| Pain Point | Solution |
|
||||
|:---|:---|
|
||||
| 🤖 AI can't understand project structure | ✅ AI directly reads whiteboard JSON, instantly understands architecture |
|
||||
| 🧠 Humans can't remember complex dependencies | ✅ Clear connections, one glance shows all impacts |
|
||||
| 💬 Team collaboration relies on verbal communication | ✅ Point at the whiteboard to explain, newcomers understand in 5 minutes |
|
||||
|
||||
**Core Philosophy**: Graphics are first-class citizens, code is the serialized form of the whiteboard.
|
||||
|
||||
👉 [Learn more about Canvas Whiteboard-Driven Development](../zh/documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md)
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>🐝 AI Swarm Collaboration</strong></summary>
|
||||
|
||||
> **Multi-AI Agent Collaboration System Based on tmux**
|
||||
|
||||
Traditional mode: Human ←→ AI₁, Human ←→ AI₂, Human ←→ AI₃ (Human is the bottleneck)
|
||||
|
||||
Swarm mode: **Human → AI₁ ←→ AI₂ ←→ AI₃** (AI autonomous collaboration)
|
||||
|
||||
| Capability | Implementation | Effect |
|
||||
|:---|:---|:---|
|
||||
| 🔍 Perception | `capture-pane` | Read any terminal content |
|
||||
| 🎮 Control | `send-keys` | Send keystrokes to any terminal |
|
||||
| 🤝 Coordination | Shared state files | Task synchronization and division |
|
||||
|
||||
**Core Breakthrough**: AI is no longer isolated, but a cluster that can perceive, communicate, and control each other.
|
||||
|
||||
👉 [Learn more about AI Swarm Collaboration](../zh/documents/02-方法论/AI蜂群协作-tmux多Agent协作系统.md)
|
||||
|
||||
</details>
|
||||
|
||||
|
|
@ -155,11 +191,12 @@ Glue Coding is the ultimate evolution of Vibe Coding, potentially solving three
|
|||
|
||||
**Note**: The following experience sharing is not universally applicable. Please adopt it dialectically in specific practices combined with your scenario.
|
||||
|
||||
## 🔑 Meta-Methodology
|
||||
<details open>
|
||||
<summary><strong>🔑 Meta-Methodology</strong></summary>
|
||||
|
||||
The core of this philosophy is to build an AI system capable of **self-optimization**. Its recursive nature can be broken down into the following steps:
|
||||
|
||||
> Further reading: [A Formalization of Recursive Self-Optimizing Generative Systems](./documents/00-fundamentals/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
|
||||
> Further reading: [A Formalization of Recursive Self-Optimizing Generative Systems](../zh/documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
|
||||
|
||||
#### 1. Define Core Roles:
|
||||
|
||||
|
|
@ -184,41 +221,52 @@ The core of this philosophy is to build an AI system capable of **self-optimizat
|
|||
|
||||
Through this continuous **recursive optimization loop**, the system achieves **self-transcendence** in each iteration, infinitely approaching the preset **expected state**.
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>🧭 Methodology Essence (Dao · Fa · Shu)</strong></summary>
|
||||
|
||||
## 🧭 The Way (Dao)
|
||||
|
||||
* **If AI can do it, don't do it manually.**
|
||||
* **Ask AI everything.**
|
||||
* **Purpose-driven: All actions in the development process revolve around "purpose".**
|
||||
* **Context is the primary element of Vibe Coding; garbage in, garbage out.**
|
||||
* **Systemic thinking: entities, links, functions/purposes, three dimensions.**
|
||||
* **Data and functions are everything in programming.**
|
||||
* **Input, process, output describe the entire process.**
|
||||
* **Frequently ask AI: What is it? Why? How to do it?**
|
||||
* **Structure first, then code; always plan the framework well, otherwise, technical debt will be endless.**
|
||||
* **Occam's Razor: Do not add code if unnecessary.**
|
||||
* **Pareto Principle: Focus on the important 20%.**
|
||||
* **Reverse thinking: First clarify your requirements, then build code reversely from requirements.**
|
||||
* **Repeat, try multiple times, if it really doesn't work, open a new window.**
|
||||
* **Focus, extreme focus can penetrate code; do one thing at a time (except for divine beings).**
|
||||
* **If AI can do it, don't do it manually**
|
||||
* **Ask AI everything**
|
||||
* **Purpose-driven: All actions in the development process revolve around "purpose"**
|
||||
* **Context is the primary element of Vibe Coding; garbage in, garbage out**
|
||||
* **Systemic thinking: entities, links, functions/purposes, three dimensions**
|
||||
* **Data and functions are everything in programming**
|
||||
* **Input, process, output describe the entire process**
|
||||
* **Frequently ask AI: What is it? Why? How to do it? (Golden Circle Rule)**
|
||||
* **Structure first, then code; always plan the framework well, otherwise technical debt will be endless**
|
||||
* **Occam's Razor: Do not add code if unnecessary**
|
||||
* **Pareto Principle: Focus on the important 20%**
|
||||
* **Reverse thinking: First clarify your requirements, then build code reversely from requirements**
|
||||
* **Repeat, try multiple times, if it really doesn't work, open a new window**
|
||||
* **Focus, extreme focus can penetrate code; do one thing at a time (except for divine beings)**
|
||||
|
||||
|
||||
## 🧩 The Method (Fa)
|
||||
|
||||
* **One-sentence goal + non-goals.**
|
||||
* **Orthogonality: functionality should not be too repetitive (this depends on the scenario).**
|
||||
* **Copy, don't write: don't reinvent the wheel, first ask AI if there's a suitable repository, download and modify it.**
|
||||
* **Always read the official documentation; first, feed the official documentation to AI.**
|
||||
* **Split modules by responsibility.**
|
||||
* **Interfaces first, implementation later.**
|
||||
* **Change only one module at a time.**
|
||||
* **Documentation is context, not an afterthought.**
|
||||
* **One-sentence goal + non-goals**
|
||||
* **Orthogonality (scenario-dependent)**
|
||||
* **Copy, don't write: don't reinvent the wheel, first ask AI if there's a suitable repository, download and modify it (glue coding new paradigm)**
|
||||
* **Always read the official documentation; first crawl the official documentation and feed it to AI (let AI find tools to download locally)**
|
||||
* **Split modules by responsibility**
|
||||
* **Interfaces first, implementation later**
|
||||
* **Change only one module at a time**
|
||||
* **Documentation is context, not an afterthought**
|
||||
|
||||
## 🛠️ The Techniques (Shu)
|
||||
|
||||
* Clearly state: **What can be changed, what cannot be changed.**
|
||||
* Debug only provide: **Expected vs. Actual + Minimum Reproduction.**
|
||||
* Testing can be handed over to AI, **assertions human-reviewed.**
|
||||
* Too much code, **switch sessions.**
|
||||
* Clearly state: **What can be changed, what cannot be changed**
|
||||
* Debug only provide: **Expected vs. Actual + Minimum Reproduction**
|
||||
* Testing can be handed over to AI, **assertions human-reviewed**
|
||||
* Too much code, **switch sessions**
|
||||
* **AI mistakes should be organized into experience using prompts for persistent storage; when encountering unsolvable problems, let AI search this collected issues and find solutions**
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>📋 The Tools (Qi)</strong></summary>
|
||||
|
||||
## 📋 The Tools (Qi)
|
||||
|
||||
|
|
@ -259,54 +307,58 @@ Through this continuous **recursive optimization loop**, the system achieves **s
|
|||
|
||||
### Resources and Templates
|
||||
|
||||
* [**Prompt Library (Online Table)**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): An online table containing a large number of ready-to-use prompts for various categories.
|
||||
* [**Prompt Library (Online Table)**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): An online table containing a large number of ready-to-use prompts for various categories.
|
||||
* [**Third-party System Prompt Learning Library**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): For learning and referencing system prompts of other AI tools.
|
||||
* [**Skills Maker**](https://github.com/yusufkaraaslan/Skill_Seekers): A tool for generating customized skills based on requirements.
|
||||
* [**Meta-Prompts**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): Advanced prompts for generating prompts.
|
||||
* [**General Project Architecture Template**](./documents/00-fundamentals/General%20Project%20Architecture%20Template.md): Can be used to quickly set up standardized project directory structures.
|
||||
* [**Meta-Skill: Skills of Skills**](./skills/claude-skills/SKILL.md): A meta-skill for generating skills.
|
||||
* [**tmux Shortcut Cheatsheet**](./documents/02-methodology/tmux%20Shortcut%20Cheatsheet.md): Reference documentation for tmux shortcuts.
|
||||
* [**LazyVim Shortcut Cheatsheet**](./documents/02-methodology/LazyVim%20Shortcut%20Cheatsheet.md): Reference documentation for LazyVim shortcuts.
|
||||
* [**Meta-Prompts**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): Advanced prompts for generating prompts.
|
||||
* [**General Project Architecture Template**](../zh/documents/00-基础指南/通用项目架构模板.md): Can be used to quickly set up standardized project directory structures.
|
||||
* [**Meta-Skill: Skills of Skills**](../zh/skills/00-元技能/claude-skills/SKILL.md): A meta-skill for generating skills.
|
||||
* [**tmux Shortcut Cheatsheet**](../zh/documents/02-方法论/tmux快捷键大全.md): Reference documentation for tmux shortcuts.
|
||||
* [**LazyVim Shortcut Cheatsheet**](../zh/documents/02-方法论/LazyVim快捷键大全.md): Reference documentation for LazyVim shortcuts.
|
||||
* [**Mobile Remote Vibe Coding**](../zh/documents/02-方法论/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): SSH remote control of local computer via mobile phone for Vibe Coding based on frp.
|
||||
|
||||
### External Tutorials and Resources
|
||||
|
||||
* [**Erge's Java Advanced Path**](https://javabetter.cn/): Contains detailed configuration tutorials for various development tools.
|
||||
* [**Virtual Card**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): Can be used for registering cloud services and other scenarios requiring international payments.
|
||||
|
||||
### Community
|
||||
|
||||
* [**Telegram Group**](https://t.me/glue_coding): Vibe Coding Chinese exchange group
|
||||
* [**Telegram Channel**](https://t.me/tradecat_ai_channel): Project updates and news
|
||||
|
||||
### Internal Project Documentation
|
||||
|
||||
* [**Glue Coding**](../zh/documents/00-基础指南/): The Holy Grail and Silver Bullet of software engineering, the ultimate evolution of Vibe Coding.
|
||||
* [**Chat Vault**](../../libs/external/chat-vault/): AI chat record saving tool, supporting Codex/Kiro/Gemini/Claude CLI.
|
||||
* [**prompts-library Tool Description**](../../libs/external/prompts-library/): Supports mutual conversion between Excel and Markdown formats, contains hundreds of curated prompts.
|
||||
* [**Coding Prompts Collection**](../zh/prompts/02-编程提示词/): Dedicated prompts for the Vibe Coding process.
|
||||
* [**System Prompt Construction Principles**](../zh/documents/00-基础指南/系统提示词构建原则.md): A comprehensive guide on building efficient AI system prompts.
|
||||
* [**Development Experience Summary**](../zh/documents/00-基础指南/开发经验.md): Variable naming, file structure, coding standards, architectural principles, etc.
|
||||
* [**General Project Architecture Template**](../zh/documents/00-基础指南/通用项目架构模板.md): Standard directory structures for various project types.
|
||||
* [**Augment MCP Configuration Document**](../zh/documents/02-方法论/auggie-mcp配置文档.md): Augment context engine configuration instructions.
|
||||
* [**System Prompts Collection**](../zh/prompts/01-系统提示词/): System prompts for AI development, including multiple versions of development specifications.
|
||||
* [**External Resource Aggregation**](../zh/documents/04-资源/外部资源聚合.md): GitHub curated repositories, AI tool platforms, prompt resources, quality bloggers compilation.
|
||||
|
||||
---
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>Coding Model Performance Tier Reference</strong></summary>
|
||||
|
||||
## Coding Model Performance Tier Reference
|
||||
|
||||
It is recommended to only choose models from the first tier for complex tasks to ensure optimal results and efficiency.
|
||||
|
||||
* **Tier 1**: `codex-5.1-max-xhigh`, `claude-opus-4.5-xhigh`, `gpt-5.2-xhigh`
|
||||
* **Tier 2**: `claude-sonnet-4.5`, `kimi-k2-thinking`, `minimax-m2`, `glm-4.6`, `gemini-3.0-pro`, `gemini-2.5-pro`
|
||||
* **Tier 3**: `qwen3`, `SWE`, `grok4`
|
||||
|
||||
---
|
||||
|
||||
## 📚 Related Documents and Resources
|
||||
</details>
|
||||
|
||||
* **Community**:
|
||||
* [Telegram Group](https://t.me/glue_coding)
|
||||
* [Telegram Channel](https://t.me/tradecat_ai_channel)
|
||||
* **Personal Sharing**:
|
||||
* [My Learning Experience](./documents/02-methodology/Learning%20Experience.md)
|
||||
* [Recommended Programming Books](./documents/04-resources/Recommended%20Programming%20Books.md)
|
||||
* **Core Resources**:
|
||||
* [**Meta-Prompt Library**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): A collection of advanced prompts for generating prompts.
|
||||
* [**Meta-Skill**](./skills/claude-skills/SKILL.md): A skill for generating skills.
|
||||
* [**Skills Library**](./skills): A modular skill repository that can be directly integrated.
|
||||
* [**Skill Generator**](https://github.com/yusufkaraaslan/Skill_Seekers): A tool to convert any material into agent-usable skills.
|
||||
* [**Online Prompt Database**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1): An online table containing hundreds of user and system prompts for various scenarios.
|
||||
* [**Third-party System Prompt Repository**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): Gathers system prompts from various AI tools.
|
||||
* **Internal Project Documentation**:
|
||||
* [**prompts-library Tool Description**](../../libs/external/prompts-library/): This tool supports converting prompts between Excel and Markdown formats, and includes hundreds of selected prompts.
|
||||
* [**coding_prompts Collection**](./prompts/02-coding-prompts/): Dedicated prompts for the Vibe Coding process.
|
||||
* [**System Prompt Construction Principles**](./documents/00-fundamentals/System%20Prompt%20Construction%20Principles.md): A comprehensive guide on how to build efficient and reliable AI system prompts.
|
||||
* [**Development Experience Summary**](./documents/00-fundamentals/Development%20Experience.md): Includes practical experience on variable naming, file structure, coding standards, and architectural principles.
|
||||
* [**General Project Architecture Template**](./documents/00-fundamentals/General%20Project%20Architecture%20Template.md): Provides standard directory structures and best practices for various project types.
|
||||
* [**Augment MCP Configuration Document**](./documents/02-methodology/auggie-mcp%20Configuration%20Document.md): Detailed configuration instructions for the Augment context engine.
|
||||
* [**system_prompts Collection**](./prompts/01-system-prompts/): System prompts used to guide AI development, including multiple versions of development specifications and thinking frameworks.
|
||||
|
||||
---
|
||||
<details>
|
||||
<summary><strong>Project Directory Structure Overview</strong></summary>
|
||||
|
||||
### Project Directory Structure Overview
|
||||
|
||||
|
|
@ -314,97 +366,99 @@ The core structure of this `vibe-coding-cn` project primarily revolves around kn
|
|||
|
||||
```
|
||||
.
|
||||
├── CODE_OF_CONDUCT.md # Community code of conduct, regulating contributor behavior.
|
||||
├── CONTRIBUTING.md # Contribution guide, explaining how to contribute to this project.
|
||||
├── GEMINI.md # AI assistant context document, including project overview, tech stack, and file structure.
|
||||
├── LICENSE # Open-source license file.
|
||||
├── Makefile # Project automation scripts for code checking, building, etc.
|
||||
├── README.md # Main project documentation, including project overview, usage guide, resource links, etc.
|
||||
├── .gitignore # Git ignore file.
|
||||
├── AGENTS.md # AI agent related documentation or configuration.
|
||||
├── CLAUDE.md # Core behavioral guidelines or configuration for the AI assistant.
|
||||
├── README.md # Main project documentation
|
||||
├── AGENTS.md # AI Agent behavioral guidelines
|
||||
├── GEMINI.md # Gemini model context
|
||||
├── Makefile # Automation scripts
|
||||
├── LICENSE # MIT License
|
||||
├── CODE_OF_CONDUCT.md # Code of Conduct
|
||||
├── CONTRIBUTING.md # Contribution Guide
|
||||
├── .gitignore # Git ignore rules
|
||||
│
|
||||
├── i18n/en/documents/ # Stores various explanatory documents, experience summaries, and detailed configuration instructions.
|
||||
│ ├── 00-fundamentals/ # Core concepts and methodology
|
||||
│ ├── 01-getting-started/ # Getting started guides
|
||||
│ ├── 02-methodology/ # Tools and tutorials
|
||||
│ ├── 03-practice/ # Practice projects
|
||||
│ └── 04-resources/ # Templates and resources
|
||||
├── .github/ # GitHub configuration
|
||||
│ ├── workflows/ # CI/CD workflows
|
||||
│ │ ├── ci.yml # Markdown lint + link checker
|
||||
│ │ ├── labeler.yml # Auto labeler
|
||||
│ │ └── welcome.yml # Welcome new contributors
|
||||
│ ├── ISSUE_TEMPLATE/ # Issue templates
|
||||
│ ├── PULL_REQUEST_TEMPLATE.md # PR template
|
||||
│ ├── SECURITY.md # Security policy
|
||||
│ ├── FUNDING.yml # Sponsorship configuration
|
||||
│ └── wiki/ # GitHub Wiki content
|
||||
│
|
||||
├── libs/ # General library code for internal project modularization.
|
||||
│ ├── common/ # Common functional modules.
|
||||
│ │ ├── models/ # Model definitions.
|
||||
│ │ │ └── __init__.py
|
||||
│ │ └── utils/ # Utility functions.
|
||||
│ │ └── backups/ # Internal backup tools.
|
||||
│ ├── database/ # Database related modules.
|
||||
│ │ └── .gitkeep # Placeholder file, ensuring the directory is tracked by Git.
|
||||
│ └── external/ # External integration modules.
|
||||
│ ├── my-nvim/ # User's Neovim configuration.
|
||||
│ ├── prompts-library/ # Prompt library management tool (Excel-Markdown conversion).
|
||||
│ │ ├── main.py # Main entry for the prompt library management tool.
|
||||
│ │ ├── scripts/ # Contains Excel and Markdown conversion scripts and configurations.
|
||||
│ │ ├── prompt_excel/ # Stores raw prompt data in Excel format.
|
||||
│ │ ├── prompt_docs/ # Stores Markdown prompt documents converted from Excel.
|
||||
│ │ └── ... (other prompts-library internal files)
|
||||
│ └── XHS-image-to-PDF-conversion/ # Xiaohongshu image to PDF conversion tool.
|
||||
├── i18n/ # Multilingual assets (27 languages)
|
||||
│ ├── README.md # Multilingual index
|
||||
│ ├── zh/ # Chinese main corpus
|
||||
│ │ ├── documents/ # Document library
|
||||
│ │ │ ├── -01-哲学与方法论/ # Supreme ideology and methodology
|
||||
│ │ │ ├── 00-基础指南/ # Core principles and underlying logic
|
||||
│ │ │ ├── 01-入门指南/ # Getting started tutorials
|
||||
│ │ │ ├── 02-方法论/ # Specific tools and techniques
|
||||
│ │ │ ├── 03-实战/ # Project practice cases
|
||||
│ │ │ └── 04-资源/ # External resource aggregation
|
||||
│ │ ├── prompts/ # Prompt library
|
||||
│ │ │ ├── 00-元提示词/ # Meta prompts (prompts that generate prompts)
|
||||
│ │ │ ├── 01-系统提示词/ # AI system-level prompts
|
||||
│ │ │ ├── 02-编程提示词/ # Programming-related prompts
|
||||
│ │ │ └── 03-用户提示词/ # User-defined prompts
|
||||
│ │ └── skills/ # Skills library
|
||||
│ │ ├── 00-元技能/ # Meta skills (skills that generate skills)
|
||||
│ │ ├── 01-AI工具/ # AI CLI and tools
|
||||
│ │ ├── 02-数据库/ # Database skills
|
||||
│ │ ├── 03-加密货币/ # Cryptocurrency/quantitative trading
|
||||
│ │ └── 04-开发工具/ # General development tools
|
||||
│ ├── en/ # English version (same structure as zh/)
|
||||
│ └── ... # Other language skeletons
|
||||
│
|
||||
├── i18n/en/prompts/ # Centralized storage for all types of AI prompts.
|
||||
│ ├── 00-meta-prompts/ # Meta prompts (prompts that generate prompts)
|
||||
│ ├── 01-system-prompts/ # AI system-level prompts for behavior and framework
|
||||
│ │ └── ... (system prompts)
|
||||
│ │
|
||||
│ ├── 02-coding-prompts/ # Prompts for programming and code generation
|
||||
│ │ └── ... (coding prompt files)
|
||||
│ │
|
||||
│ └── 03-user-prompts/ # User-defined or commonly used prompts
|
||||
│ └── ... (user prompts)
|
||||
├── libs/ # Core library code
|
||||
│ ├── common/ # Common modules
|
||||
│ │ ├── models/ # Model definitions
|
||||
│ │ └── utils/ # Utility functions
|
||||
│ ├── database/ # Database module (reserved)
|
||||
│ └── external/ # External tools
|
||||
│ ├── prompts-library/ # Excel ↔ Markdown conversion tool
|
||||
│ ├── chat-vault/ # AI chat record saving tool
|
||||
│ ├── Skill_Seekers-development/ # Skills maker
|
||||
│ ├── l10n-tool/ # Multilingual translation script
|
||||
│ ├── my-nvim/ # Neovim configuration
|
||||
│ ├── MCPlayerTransfer/ # MC player migration tool
|
||||
│ └── XHS-image-to-PDF-conversion/ # Xiaohongshu image to PDF
|
||||
│
|
||||
├── i18n/en/skills/ # Centralized storage for all types of skills.
|
||||
├── 00-meta-skills/ # Meta skills
|
||||
│ └── claude-skills/ # Skills generator
|
||||
├── 01-ai-tools/ # AI CLI tools
|
||||
│ ├── claude-code-guide/
|
||||
│ └── claude-cookbooks/
|
||||
├── 02-databases/ # Database skills
|
||||
│ ├── postgresql/
|
||||
│ └── timescaledb/
|
||||
├── 03-crypto/ # Cryptocurrency/quantitative
|
||||
│ ├── ccxt/
|
||||
│ ├── coingecko/
|
||||
│ ├── cryptofeed/
|
||||
│ ├── hummingbot/
|
||||
│ └── polymarket/
|
||||
└── 04-dev-tools/ # Development tools
|
||||
├── telegram-dev/
|
||||
├── twscrape/
|
||||
├── snapdom/
|
||||
└── proxychains/
|
||||
└── backups/ # Backup scripts and archives
|
||||
├── 一键备份.sh # Shell backup script
|
||||
├── 快速备份.py # Python backup script
|
||||
├── README.md # Backup instructions
|
||||
└── gz/ # Compressed archive directory
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🖼️ Overview and Demo
|
||||
</details>
|
||||
|
||||
## 📺 Demo and Output
|
||||
|
||||
In one sentence: Vibe Coding = **Planning-driven + Context-fixed + AI Pair Execution**, transforming "idea to maintainable code" into an auditable pipeline, rather than an uniteratable monolith.
|
||||
|
||||
**What you will get:**
|
||||
- A systematic prompt toolchain: `i18n/en/prompts/01-system-prompts/` defines AI behavioral boundaries, `i18n/en/prompts/02-coding-prompts/` provides full-link scripts for demand clarification, planning, and execution.
|
||||
**What you will get**
|
||||
- A systematic prompt toolchain: `i18n/zh/prompts/01-系统提示词/` defines AI behavioral boundaries, `i18n/zh/prompts/02-编程提示词/` provides full-link scripts for demand clarification, planning, and execution.
|
||||
- Closed-loop delivery path: Requirement → Context document → Implementation plan → Step-by-step implementation → Self-testing → Progress recording, fully reviewable and transferable.
|
||||
|
||||
<details>
|
||||
<summary><strong>⚙️ Architecture and Workflow</strong></summary>
|
||||
|
||||
## ⚙️ Architecture and Workflow
|
||||
|
||||
Core Asset Mapping:
|
||||
```
|
||||
i18n/en/prompts/
|
||||
00-meta-prompts/ # Meta prompts for generating prompts
|
||||
01-system-prompts/ # System-level prompts constraining AI behavior
|
||||
02-coding-prompts/ # Core prompts for demand clarification, planning, and execution
|
||||
03-user-prompts/ # Reusable user-side prompts
|
||||
i18n/en/documents/
|
||||
Templates and Resources/Code Organization.md, Templates and Resources/General Project Architecture Template.md, Methodology and Principles/Development Experience.md, Methodology and Principles/System Prompt Construction Principles.md, and other knowledge bases.
|
||||
i18n/zh/prompts/
|
||||
00-元提示词/ # Advanced prompts for generating prompts
|
||||
01-系统提示词/ # System-level prompts constraining AI behavior
|
||||
02-编程提示词/ # Core prompts for demand clarification, planning, and execution
|
||||
03-用户提示词/ # Reusable user-side prompts
|
||||
i18n/zh/documents/
|
||||
04-资源/代码组织.md, 04-资源/通用项目架构模板.md, 00-基础指南/开发经验.md, 00-基础指南/系统提示词构建原则.md and other knowledge bases
|
||||
backups/
|
||||
one-click-backup.sh, fast-backup.py # Local/remote snapshot scripts.
|
||||
一键备份.sh, 快速备份.py # Local/remote snapshot scripts
|
||||
```
|
||||
|
||||
```mermaid
|
||||
|
|
@ -445,11 +499,11 @@ graph TB
|
|||
end
|
||||
|
||||
subgraph consume_layer[Execution and Consumption Layer]
|
||||
artifacts_md --> catalog_coding[i18n/en/prompts/02-coding-prompts]
|
||||
artifacts_md --> catalog_system[i18n/en/prompts/01-system-prompts]
|
||||
artifacts_md --> catalog_meta[i18n/en/prompts/00-meta-prompts]
|
||||
artifacts_md --> catalog_user[i18n/en/prompts/03-user-prompts]
|
||||
artifacts_md --> docs_repo[i18n/en/documents/*]
|
||||
artifacts_md --> catalog_coding[i18n/zh/prompts/02-编程提示词]
|
||||
artifacts_md --> catalog_system[i18n/zh/prompts/01-系统提示词]
|
||||
artifacts_md --> catalog_meta[i18n/zh/prompts/00-元提示词]
|
||||
artifacts_md --> catalog_user[i18n/zh/prompts/03-用户提示词]
|
||||
artifacts_md --> docs_repo[i18n/zh/documents/*]
|
||||
artifacts_md --> new_consumer[Reserved: Other Downstream Channels]
|
||||
catalog_coding --> ai_flow[AI Pair Programming Workflow]
|
||||
ai_flow --> deliverables[Project Context / Plan / Code Output]
|
||||
|
|
@ -463,7 +517,7 @@ graph TB
|
|||
|
||||
subgraph infra_layer[Infrastructure and Cross-cutting Capabilities Layer]
|
||||
git[Git Version Control] --> orchestrator
|
||||
backups[backups/one-click-backup.sh · backups/fast-backup.py] --> artifacts_md
|
||||
backups[backups/一键备份.sh · backups/快速备份.py] --> artifacts_md
|
||||
deps[requirements.txt · scripts/requirements.txt] --> orchestrator
|
||||
config[prompts-library/scripts/config.yaml] --> orchestrator
|
||||
monitor[Reserved: Logging and Monitoring] --> orchestrator
|
||||
|
|
@ -472,6 +526,8 @@ graph TB
|
|||
|
||||
---
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>📈 Performance Benchmarks (Optional)</summary>
|
||||
|
||||
|
|
@ -494,28 +550,23 @@ This repository is positioned as a "workflow and prompts" library rather than a
|
|||
gantt
|
||||
title Project Development Roadmap
|
||||
dateFormat YYYY-MM
|
||||
section Near Term (2025)
|
||||
Complete demo GIFs and example projects: active, 2025-12, 15d
|
||||
Prompt index auto-generation script: 2025-12, 10d
|
||||
section Mid Term (2026 Q1)
|
||||
section In Progress (2025 Q4)
|
||||
Complete demo GIFs and example projects: active, 2025-12, 30d
|
||||
External resource aggregation completion: active, 2025-12, 20d
|
||||
section Near Term (2026 Q1)
|
||||
Prompt index auto-generation script: 2026-01, 15d
|
||||
One-click demo/verification CLI workflow: 2026-01, 15d
|
||||
Backup script adds snapshot and validation: 2026-01, 10d
|
||||
section Long Term (2026 Q1-Q2)
|
||||
Templated example project set: 2026-02, 20d
|
||||
Multi-model comparison and evaluation baseline: 2026-02, 20d
|
||||
Backup script adds snapshot and validation: 2026-02, 10d
|
||||
section Mid Term (2026 Q2)
|
||||
Templated example project set: 2026-03, 30d
|
||||
Multi-model comparison and evaluation baseline: 2026-04, 30d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Getting Started
|
||||
## 🎯 Original Repository Translation
|
||||
|
||||
### 🆕 Absolute Beginner? Start Here!
|
||||
|
||||
1. [01-Network Environment Configuration](./documents/01-getting-started/01-Network%20Environment%20Configuration.md) - Configure network access
|
||||
2. [02-Development Environment Setup](./documents/01-getting-started/02-Development%20Environment%20Setup.md) - Copy prompts to AI, let AI guide you through environment setup
|
||||
3. [03-IDE Configuration](./documents/01-getting-started/03-IDE%20Configuration.md) - Configure VS Code editor
|
||||
|
||||
### Already have a development environment?
|
||||
> The following content is translated from the original repository [EnzeD/vibe-coding](https://github.com/EnzeD/vibe-coding)
|
||||
|
||||
To start Vibe Coding, you only need one of the following two tools:
|
||||
- **Claude Opus 4.5**, used in Claude Code
|
||||
|
|
@ -701,7 +752,7 @@ Congratulations! You've built a basic game! It might still be rough and lack fea
|
|||
|
||||
---
|
||||
|
||||
## 📞 Contact Information
|
||||
## 📞 Contact
|
||||
|
||||
- **GitHub**: [tukuaiai](https://github.com/tukuaiai)
|
||||
- **Twitter / X**: [123olp](https://x.com/123olp)
|
||||
|
|
@ -714,15 +765,15 @@ Congratulations! You've built a basic game! It might still be rough and lack fea
|
|||
|
||||
## ✨ Support Project
|
||||
|
||||
Please help us, thank you, good people will live long and peaceful lives 🙏🙏🙏
|
||||
Please help us, thank you, good people will have a peaceful life 🙏🙏🙏
|
||||
|
||||
- **Binance UID**: `572155580`
|
||||
- **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey`
|
||||
- **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau`
|
||||
- **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`
|
||||
- **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`
|
||||
- **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm`
|
||||
- **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e`
|
||||
- **Binance UID**: `572155580`
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -740,8 +791,10 @@ Thanks to all developers who contributed to this project!
|
|||
<a href="https://x.com/0XBard_thomas">@0XBard_thomas</a> |
|
||||
<a href="https://x.com/Pluvio9yte">@Pluvio9yte</a> |
|
||||
<a href="https://x.com/xDinoDeer">@xDinoDeer</a> |
|
||||
<a href="https://x.com/geekbb">@geekbb</a>
|
||||
<a href="https://x.com/GitHub_Daily">@GitHub_Daily</a>
|
||||
<a href="https://x.com/geekbb">@geekbb</a> |
|
||||
<a href="https://x.com/GitHub_Daily">@GitHub_Daily</a> |
|
||||
<a href="https://x.com/BiteyeCN">@BiteyeCN</a> |
|
||||
<a href="https://x.com/CryptoJHK">@CryptoJHK</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
|
@ -779,4 +832,4 @@ This project is licensed under the [MIT](LICENSE) license.
|
|||
**Crafted with dedication by [tukuaiai](https://github.com/tukuaiai), [Nicolas Zullo](https://x.com/NicolasZu), and [123olp](https://x.com/123olp)**
|
||||
|
||||
[⬆ Back to Top](#vibe-coding-guide)
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -1,5 +0,0 @@
|
|||
# es 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# fa 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# fr 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ha 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# he 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# hi 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,79 +0,0 @@
|
|||
# 📖 दस्तावेज़
|
||||
|
||||
`i18n/zh/documents/` निर्देशिका प्रक्रिया दस्तावेजों, वास्तुकला विवरण, विकास अनुभवों और परियोजना की सर्वोत्तम प्रथाओं का सारांश प्रस्तुत करती है। कार्यप्रणाली और सहयोग नियमों को समझने के लिए यह पहली पसंद है।
|
||||
|
||||
## निर्देशिका संरचना
|
||||
|
||||
```
|
||||
i18n/zh/documents/
|
||||
├── README.md
|
||||
│
|
||||
├── Methodology and Principles/
|
||||
│ ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
|
||||
│ ├── gluecoding.md
|
||||
│ ├── vibe-coding-经验收集.md
|
||||
│ ├── 学习经验.md
|
||||
│ ├── 开发经验.md
|
||||
│ ├── 编程之道.md
|
||||
│ ├── 胶水编程.md
|
||||
│ └── 系统提示词构建原则.md
|
||||
│
|
||||
├── Tutorials and Guides/
|
||||
│ ├── auggie-mcp配置文档.md
|
||||
│ ├── LazyVim快捷键大全.md
|
||||
│ ├── tmux快捷键大全.md
|
||||
│ ├── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
|
||||
│ └── telegram-dev/
|
||||
│
|
||||
└── Templates and Resources/
|
||||
├── 代码组织.md
|
||||
├── 工具集.md
|
||||
├── 编程书籍推荐.md
|
||||
└── 通用项目架构模板.md
|
||||
```
|
||||
|
||||
## दस्तावेज़ वर्गीकरण
|
||||
|
||||
### कार्यप्रणाली एवं सिद्धांत
|
||||
|
||||
यह श्रेणी प्रोग्रामिंग विचारों, विकास दर्शन और परियोजना के मूल सिद्धांतों के बारे में दस्तावेज़ संग्रहीत करती है।
|
||||
|
||||
* `पुनरावर्ती स्व-अनुकूलन जनरेटिव सिस्टम का एक औपचारिकीकरण.md`
|
||||
* `ग्लूकोडिंग.एमडी`
|
||||
* `वाइब-कोडिंग-अनुभव संग्रह.एमडी`
|
||||
* `सीखने का अनुभव.md`
|
||||
* `विकास अनुभव.एमडी`
|
||||
* `प्रोग्रामिंग का तरीका.md`
|
||||
* `ग्लू प्रोग्रामिंग.एमडी`
|
||||
* `सिस्टम प्रॉम्प्ट शब्द निर्माण सिद्धांत.एमडी`
|
||||
|
||||
### ट्यूटोरियल और मार्गदर्शिकाएँ
|
||||
|
||||
यह श्रेणी विशिष्ट उपकरणों के लिए कॉन्फ़िगरेशन, उपयोग मार्गदर्शिकाएँ और ऑपरेटिंग ट्यूटोरियल संग्रहीत करती है।
|
||||
|
||||
* `ऑग्गी-एमसीपी कॉन्फ़िगरेशन document.md`
|
||||
* `LazyVim शॉर्टकट कुंजी list.md`
|
||||
* `tmux शॉर्टकट कुंजी list.md`
|
||||
* `मोबाइल फोन एसएसएच को कहीं भी स्थानीय कंप्यूटर से जोड़ने के बारे में, frp.md पर आधारित विधि`
|
||||
* `टेलीग्राम-देव/`
|
||||
|
||||
### टेम्पलेट्स और संसाधन
|
||||
|
||||
यह श्रेणी पुन: प्रयोज्य परियोजना टेम्पलेट, कोड संरचना विनिर्देश और संसाधन सूचियाँ संग्रहीत करती है।
|
||||
|
||||
* `कोड संगठन.एमडी`
|
||||
* `टूलसेट.एमडी`
|
||||
* `प्रोग्रामिंग पुस्तक अनुशंसाएँ.md`
|
||||
* `यूनिवर्सल प्रोजेक्ट आर्किटेक्चर टेम्पलेट.एमडी`
|
||||
|
||||
## नए दस्तावेज़ का योगदान करें
|
||||
|
||||
1. दस्तावेज़ को सबसे उपयुक्त श्रेणी में रखें।
|
||||
2. यदि आवश्यक हो, तो एक नई श्रेणी निर्देशिका बनाएँ।
|
||||
3. परिवर्तनों को प्रतिबिंबित करने के लिए इस README फ़ाइल को अपडेट करें।
|
||||
|
||||
## संबंधित संसाधन
|
||||
|
||||
- [प्रॉम्प्ट वर्ड लाइब्रेरी](../प्रॉम्प्ट्स/) - एआई प्रॉम्प्ट वर्ड संग्रह
|
||||
- [कौशल पुस्तकालय](../कौशल/) - एआई कौशल कौशल
|
||||
- [सामान्य पुस्तकालय](../libs/) - उपकरण और बाहरी एकीकरण
|
||||
|
|
@ -1,83 +0,0 @@
|
|||
# 💡एआई संकेत (संकेत)
|
||||
|
||||
`i18n/zh/prompts/` इस वेयरहाउस की त्वरित शब्द संपत्तियों को संग्रहीत करता है: एआई की सीमाओं और स्वाद को सीमित करने के लिए **सिस्टम प्रॉम्प्ट शब्दों** का उपयोग करें, और "आवश्यकताओं के स्पष्टीकरण → योजना → निष्पादन → समीक्षा" की विकास पाइपलाइन को चलाने के लिए **कार्य शीघ्र शब्दों** का उपयोग करें।
|
||||
|
||||
## अनुशंसित पथ (0 से नियंत्रणीय तक)
|
||||
|
||||
1. **पहले सीमा निर्धारित करें**: एक सिस्टम प्रॉम्प्ट शब्द संस्करण चुनें (`v8` या `v10` अनुशंसित है)।
|
||||
2. **पुनः चलाने की प्रक्रिया**: चरण के अनुसार विशिष्ट कार्यों में `coding_prompts/` (स्पष्टीकरण/योजना/निष्पादन/समीक्षा) का चयन करें।
|
||||
3. **अंतिम उत्पादीकरण**: जब आप किसी निश्चित क्षेत्र में समान कार्य बार-बार करते हैं, तो "कौशल/" (अधिक पुन: प्रयोज्य और अधिक स्थिर) में "संकेत शब्द + जानकारी" को कौशल में अपग्रेड करें।
|
||||
|
||||
## निर्देशिका संरचना (गोदाम की वास्तविक निर्देशिका के अधीन)
|
||||
|
||||
```
|
||||
i18n/zh/prompts/
|
||||
├── README.md
|
||||
├── coding_prompts/ # 编程/研发提示词（当前 41 个 .md）
|
||||
│ ├── index.md # 自动生成的索引与版本矩阵（请勿手改）
|
||||
│ ├── 标准化流程.md
|
||||
│ ├── 项目上下文文档生成.md
|
||||
│ ├── 智能需求理解与研发导航引擎.md
|
||||
│ └── ...
|
||||
├── system_prompts/ # 系统提示词（CLAUDE 多版本 + 其他收集）
|
||||
│ ├── CLAUDE.md/ # 1~10 版本目录（v9 目前仅占位）
|
||||
│ │ ├── 1/CLAUDE.md
|
||||
│ │ ├── 2/CLAUDE.md
|
||||
│ │ ├── ...
|
||||
│ │ ├── 9/AGENTS.md # v9 当前没有 CLAUDE.md
|
||||
│ │ └── 10/CLAUDE.md
|
||||
│ └── ...
|
||||
└── user_prompts/ # 用户自用/一次性提示词
|
||||
├── ASCII图生成.md
|
||||
├── 数据管道.md
|
||||
└── 项目变量与工具统一维护.md
|
||||
```
|
||||
|
||||
## `system_prompts/`: सिस्टम-स्तरीय त्वरित शब्द (पहले AI को "नियंत्रण योग्य बनाएं")
|
||||
|
||||
सिस्टम प्रॉम्प्ट शब्दों का उपयोग **कार्य मोड, कोड स्वाद, आउटपुट स्वरूप और सुरक्षा सीमाओं** को परिभाषित करने के लिए किया जाता है। निर्देशिका में एक संस्करणीकृत संरचना है:
|
||||
|
||||
- पथ परिपाटी: `i18n/zh/prompts/system_prompts/CLAUDE.md/<संस्करण संख्या>/CLAUDE.md`
|
||||
- अनुशंसित संस्करण:
|
||||
- `v8`: व्यापक संस्करण, सामान्य वाइब कोडिंग के लिए उपयुक्त
|
||||
- `v10`: आंशिक ऑगमेंट/संदर्भ इंजन की सामान्यीकरण बाधाएँ
|
||||
- नोट: `v9` निर्देशिका वर्तमान में केवल एक प्लेसहोल्डर है (कोई `CLAUDE.md` नहीं)
|
||||
|
||||
## `कोडिंग_प्रॉम्प्ट्स/`: कार्य-स्तरीय संकेत शब्द (प्रक्रिया के माध्यम से चलाएँ)
|
||||
|
||||
`coding_prompts/` "एक कार्य" की ओर उन्मुख है: आवश्यकता स्पष्टीकरण, योजना निराकरण से लेकर वितरण और समीक्षा तक। इसे वर्कफ़्लो स्क्रिप्ट लाइब्रेरी के रूप में उपयोग करने की अनुशंसा की जाती है:
|
||||
|
||||
- **प्रवेश स्तर** (नए सत्र/नई परियोजनाओं के लिए आवश्यक)
|
||||
- `प्रोजेक्ट संदर्भ दस्तावेज़ पीढ़ी.एमडी`: संदर्भ को मजबूत करें और क्रॉस-सेशन बहाव को कम करें
|
||||
- `बुद्धिमान आवश्यकताओं की समझ और आर एंड डी नेविगेशन इंजन.एमडी`: अस्पष्ट आवश्यकताओं को निष्पादन योग्य कार्यों में विभाजित करें
|
||||
- **डिलीवरी स्तर** (गारंटी आउटपुट ऑडिट योग्य है)
|
||||
- `मानकीकृत प्रक्रिया.एमडी`: नियंत्रण के नुकसान को कम करने के लिए "पहले क्या करें और आगे क्या करें" लिखें
|
||||
- `सिस्टम आर्किटेक्चर की विज़ुअल पीढ़ी Mermaid.md`: आर्किटेक्चर को विज़ुअलाइज़ेशन में आउटपुट करें (चित्र एक हज़ार शब्दों के बराबर हैं)
|
||||
|
||||
### `index.md` के बारे में (महत्वपूर्ण)
|
||||
|
||||
[`coding_prompts/index.md`](./coding_prompts/index.md) एक स्वचालित रूप से उत्पन्न सूचकांक है (संस्करण मैट्रिक्स और जंप लिंक सहित), **इसे मैन्युअल रूप से संपादित न करें**। यदि आप बैचों में संस्करण जोड़ते हैं, हटाते/समायोजित करते हैं, तो टूल श्रृंखला के माध्यम से इंडेक्स उत्पन्न करने और फिर उन्हें सिंक्रनाइज़ करने की अनुशंसा की जाती है।
|
||||
|
||||
## `user_prompts/`: व्यक्तिगत कार्यक्षेत्र (व्यवस्थितीकरण का अनुसरण नहीं करना)
|
||||
|
||||
कुछ व्यक्तिगत आदतें और अस्थायी मचान शीघ्र शब्द डालें। सिद्धांत यह है कि **उपयोग किया जा सकता है, तोड़ें नहीं, मुख्य पुस्तकालय को प्रदूषित न करें**।
|
||||
|
||||
## त्वरित उपयोग (कॉपी करें और उपयोग करें)
|
||||
|
||||
```bash
|
||||
# 查看一个任务提示词
|
||||
sed -n '1,160p' i18n/zh/prompts/coding_prompts/标准化流程.md
|
||||
|
||||
# 选定系统提示词版本（建议先备份你当前的 CLAUDE.md）
|
||||
cp i18n/zh/prompts/system_prompts/CLAUDE.md/10/CLAUDE.md ./CLAUDE.md
|
||||
```
|
||||
|
||||
## रखरखाव और बैच प्रबंधन (वैकल्पिक)
|
||||
|
||||
यदि आपको एक्सेल ↔ मार्कडाउन की बैच रखरखाव क्षमताओं की आवश्यकता है, तो वेयरहाउस में अंतर्निहित तृतीय-पक्ष टूल हैं: `लिब्स/एक्सटर्नल/प्रॉम्प्ट्स-लाइब्रेरी/`। इसे "त्वरित शब्द संपत्तियों के लिए उत्पादन उपकरण" और `i18n/zh/prompts/` को "दैनिक विकास के लिए क्यूरेटेड संग्रह" के रूप में सोचने की अनुशंसा की जाती है।
|
||||
|
||||
## संबंधित संसाधन
|
||||
|
||||
- [`../skills/`](../skills/): उच्च-आवृत्ति डोमेन क्षमताओं को कौशल में परिवर्तित करें (अधिक पुन: प्रयोज्य)
|
||||
- [`../documents/`](../documents/): कार्यप्रणाली और सर्वोत्तम प्रथाएं (त्वरित शब्द डिजाइन और वर्कफ़्लो सिद्धांत)
|
||||
- [`../libs/बाहरी/प्रॉम्पट्स-लाइब्रेरी/`](../libs/बाहरी/प्रॉम्पट्स-लाइब्रेरी/): शीघ्र शब्द एक्सेल ↔ मार्कडाउन प्रबंधन उपकरण
|
||||
|
|
@ -1,241 +0,0 @@
|
|||
# 🎯एआई कौशल कौशल पुस्तकालय
|
||||
|
||||
`i18n/zh/skills/` निर्देशिका AI कौशल (कौशल) को संग्रहीत करती है, जो त्वरित शब्दों की तुलना में उच्च-स्तरीय क्षमता पैकेज हैं और AI को विशिष्ट क्षेत्रों में विशेषज्ञ स्तर पर प्रदर्शन करने की अनुमति देते हैं। वर्तमान में **14** पेशेवर कौशल शामिल हैं।
|
||||
|
||||
## निर्देशिका संरचना
|
||||
|
||||
```
|
||||
i18n/zh/skills/
|
||||
├── README.md # 本文件
|
||||
│
|
||||
├── # === 元技能（核心） ===
|
||||
├── claude-skills/ # ⭐ 元技能：生成 Skills 的 Skills（11KB）
|
||||
│
|
||||
├── # === Claude 工具 ===
|
||||
├── claude-code-guide/ # Claude Code 使用指南（9KB）
|
||||
├── claude-cookbooks/ # Claude API 最佳实践（9KB）
|
||||
│
|
||||
├── # === 数据库 ===
|
||||
├── postgresql/ # ⭐ PostgreSQL 专家技能（76KB，最详细）
|
||||
├── timescaledb/ # 时序数据库扩展（3KB）
|
||||
│
|
||||
├── # === 加密货币/量化 ===
|
||||
├── ccxt/ # 加密货币交易所统一 API（18KB）
|
||||
├── coingecko/ # CoinGecko 行情 API（3KB）
|
||||
├── cryptofeed/ # 加密货币实时数据流（6KB）
|
||||
├── hummingbot/ # 量化交易机器人框架（4KB）
|
||||
├── polymarket/ # 预测市场 API（6KB）
|
||||
│
|
||||
├── # === 开发工具 ===
|
||||
├── telegram-dev/ # Telegram Bot 开发（18KB）
|
||||
├── twscrape/ # Twitter/X 数据抓取（11KB）
|
||||
├── snapdom/ # DOM 快照工具（8KB）
|
||||
└── proxychains/ # 代理链配置（6KB）
|
||||
```
|
||||
|
||||
## कौशल सूची
|
||||
|
||||
### फ़ाइल आकार के अनुसार क्रमबद्ध करें (शब्दशः)
|
||||
|
||||
| कौशल | आकार | डोमेन | विवरण |
|
||||
|------|------|------|------|
|
||||
| **पोस्टग्रेस्क्ल** | 76KB | डेटाबेस | ⭐ सबसे विस्तृत, संपूर्ण PostgreSQL विशेषज्ञ कौशल |
|
||||
| **टेलीग्राम-देव** | 18केबी | बॉट विकास | टेलीग्राम बॉट विकास के लिए संपूर्ण गाइड |
|
||||
| **ccxt** | 18केबी | ट्रेडिंग | क्रिप्टोकरेंसी एक्सचेंज यूनिफाइड एपीआई |
|
||||
| **ट्वस्क्रेप** | 11केबी | डेटा संग्रह | ट्विटर/एक्स डेटा स्क्रैपिंग |
|
||||
| **क्लाउड-कौशल** | 11केबी | मेटा-कौशल | ⭐ कौशल जो कौशल उत्पन्न करते हैं |
|
||||
| **क्लाउड-कोड-गाइड** | 9केबी | उपकरण | क्लाउड कोड का उपयोग करने के लिए सर्वोत्तम अभ्यास |
|
||||
| **क्लाउड-कुकबुक** | 9केबी | उपकरण | क्लाउड एपीआई उपयोग के उदाहरण |
|
||||
| **स्नैपडोम** | 8केबी | फ्रंट-एंड | DOM स्नैपशॉट और परीक्षण |
|
||||
| **क्रिप्टोफीड** | 6KB | डेटा स्ट्रीम | क्रिप्टोकरेंसी रीयल-टाइम डेटा स्ट्रीम |
|
||||
| **पॉलीमार्केट** | 6KB | भविष्यवाणी बाजार | पॉलीमार्केट एपीआई एकीकरण |
|
||||
| **प्रॉक्सीचेन्स** | 6KB | नेटवर्क | प्रॉक्सी श्रृंखला विन्यास और उपयोग |
|
||||
| **हमिंगबॉट** | 4KB | परिमाणीकरण | मात्रात्मक ट्रेडिंग रोबोट ढांचा |
|
||||
| **टाइमस्केल्डबी** | 3केबी | डेटाबेस | PostgreSQL समय श्रृंखला विस्तार |
|
||||
| **कोइंजेको** | 3केबी | उद्धरण | कॉइनगेको कोट्स एपीआई |
|
||||
|
||||
### फ़ील्ड द्वारा वर्गीकृत
|
||||
|
||||
#### 🔧 मेटा-कौशल और उपकरण
|
||||
|
||||
| कौशल | विवरण | अनुशंसित परिदृश्य |
|
||||
|------|------|----------|
|
||||
| `क्लाउड-कौशल` | कौशल जो कौशल उत्पन्न करते हैं | नए कौशल बनाते समय उपयोग किया जाना चाहिए |
|
||||
| `क्लाउड-कोड-गाइड` | क्लाउड कोड सीएलआई उपयोग गाइड | दैनिक विकास |
|
||||
| `क्लाउड-कुकबुक` | क्लाउड एपीआई सर्वोत्तम अभ्यास | एपीआई एकीकरण |
|
||||
|
||||
#### 🗄️ डेटाबेस
|
||||
|
||||
| कौशल | विवरण | अनुशंसित परिदृश्य |
|
||||
|------|------|----------|
|
||||
| `पोस्टग्रेस्क्ल` | PostgreSQL की संपूर्ण मार्गदर्शिका (76KB) | संबंधपरक डेटाबेस विकास |
|
||||
| `timescaledb` | समय श्रृंखला डेटाबेस एक्सटेंशन | समय श्रृंखला डेटा |
|
||||
|
||||
#### 💰 क्रिप्टोकरेंसी/मात्राकरण
|
||||
|
||||
| कौशल | विवरण | अनुशंसित परिदृश्य |
|
||||
|------|------|----------|
|
||||
| `सीसीएक्सटी` | एक्सचेंज एकीकृत एपीआई | मल्टी-एक्सचेंज डॉकिंग |
|
||||
| `कोइंजेको` | बाज़ार डेटा एपीआई | मूल्य प्रश्न |
|
||||
| `क्रिप्टोफीड` | वास्तविक समय डेटा स्ट्रीमिंग | वेबसॉकेट उद्धरण |
|
||||
| 'हमिंगबॉट' | मात्रात्मक व्यापार ढांचा | स्वचालित ट्रेडिंग |
|
||||
| `पॉलीमार्केट` | पूर्वानुमान बाज़ार एपीआई | भविष्यवाणी बाजार ट्रेडिंग |
|
||||
|
||||
#### 🛠️ विकास उपकरण
|
||||
|
||||
| कौशल | विवरण | अनुशंसित परिदृश्य |
|
||||
|------|------|----------|
|
||||
| `टेलीग्राम-देव` | टेलीग्राम बॉट विकास | बॉट विकास |
|
||||
| `twscrap` | ट्विटर डेटा स्क्रैपिंग | सोशल मीडिया डेटा |
|
||||
| 'स्नैपडोम' | डोम स्नैपशॉट | फ्रंट-एंड परीक्षण |
|
||||
| `प्रॉक्सीचेन्स` | प्रॉक्सी श्रृंखला विन्यास | नेटवर्क प्रॉक्सी |
|
||||
|
||||
## कौशल बनाम संकेतों के बीच अंतर
|
||||
|
||||
| आयाम | संकेत | कौशल |
|
||||
|------|------------------|----------------|
|
||||
| ग्रैन्युलैरिटी | एकल कार्य निर्देश | पूर्ण क्षमता एनकैप्सुलेशन |
|
||||
| पुन: प्रयोज्यता | कॉपी और पेस्ट करें | कॉन्फ़िगरेशन के बाद स्वचालित रूप से प्रभावी हो जाता है |
|
||||
| प्रसंग | मैन्युअल रूप से उपलब्ध कराने की आवश्यकता है | अंतर्निहित डोमेन ज्ञान |
|
||||
| लागू परिदृश्य | अस्थायी कार्य | दीर्घकालिक परियोजनाएँ |
|
||||
| संरचना | एकल फ़ाइल | निर्देशिका (संपत्ति/स्क्रिप्ट/संदर्भ सहित) |
|
||||
|
||||
## कौशल निर्देशिका संरचना
|
||||
|
||||
प्रत्येक कौशल एक एकीकृत संरचना का अनुसरण करता है:
|
||||
|
||||
```
|
||||
skill-name/
|
||||
├── SKILL.md # 技能主文件，包含领域知识和规则
|
||||
├── assets/ # 静态资源（图片、配置模板等）
|
||||
├── scripts/ # 辅助脚本
|
||||
└── references/ # 参考文档
|
||||
```
|
||||
|
||||
## त्वरित उपयोग
|
||||
|
||||
### 1. कौशल देखें
|
||||
|
||||
```bash
|
||||
# 查看元技能
|
||||
cat i18n/zh/skills/claude-skills/SKILL.md
|
||||
|
||||
# 查看 PostgreSQL 技能（最详细）
|
||||
cat i18n/zh/skills/postgresql/SKILL.md
|
||||
|
||||
# 查看 Telegram Bot 开发技能
|
||||
cat i18n/zh/skills/telegram-dev/SKILL.md
|
||||
```
|
||||
|
||||
### 2. प्रोजेक्ट और उपयोग के लिए कॉपी करें
|
||||
|
||||
```bash
|
||||
# 复制整个技能目录
|
||||
cp -r i18n/zh/skills/postgresql/ ./my-project/
|
||||
|
||||
# 或只复制主文件到 CLAUDE.md
|
||||
cp i18n/zh/skills/postgresql/SKILL.md ./CLAUDE.md
|
||||
```
|
||||
|
||||
### 3. क्लाउड कोड के साथ प्रयोग करें
|
||||
|
||||
प्रोजेक्ट रूट डायरेक्टरी में `CLAUDE.md` बनाएं और कौशल का संदर्भ लें:
|
||||
|
||||
```markdown
|
||||
# 项目规则
|
||||
|
||||
请参考以下技能文件：
|
||||
@i18n/zh/skills/postgresql/SKILL.md
|
||||
@i18n/zh/skills/telegram-dev/SKILL.md
|
||||
```
|
||||
|
||||
## एक कस्टम कौशल बनाएं
|
||||
|
||||
### विधि 1: मेटा-कौशल पीढ़ी का उपयोग करें (अनुशंसित)
|
||||
|
||||
1. डोमेन सामग्री तैयार करें (दस्तावेज़, कोड, विनिर्देश)
|
||||
2. `i18n/zh/skills/claude-skills/SKILL.md` के साथ AI को डेटा प्रदान करें
|
||||
3. एआई इस क्षेत्र के लिए विशेष कौशल उत्पन्न करेगा
|
||||
|
||||
```bash
|
||||
# 示例：让 AI 读取元技能后生成新技能
|
||||
cat i18n/zh/skills/claude-skills/SKILL.md
|
||||
# 然后告诉 AI：请根据这个元技能，为 [你的领域] 生成一个新的 SKILL.md
|
||||
```
|
||||
|
||||
### विधि 2: मैन्युअल निर्माण
|
||||
|
||||
```bash
|
||||
# 创建技能目录
|
||||
mkdir -p i18n/zh/skills/my-skill/{assets,scripts,references}
|
||||
|
||||
# 创建主文件
|
||||
cat > i18n/zh/skills/my-skill/SKILL.md << 'EOF'
|
||||
# My Skill
|
||||
|
||||
## 概述
|
||||
简要说明技能用途和适用场景
|
||||
|
||||
## 领域知识
|
||||
- 核心概念
|
||||
- 最佳实践
|
||||
- 常见模式
|
||||
|
||||
## 规则与约束
|
||||
- 必须遵守的规则
|
||||
- 禁止的操作
|
||||
- 边界条件
|
||||
|
||||
## 示例
|
||||
具体的使用示例和代码片段
|
||||
|
||||
## 常见问题
|
||||
FAQ 和解决方案
|
||||
EOF
|
||||
```
|
||||
|
||||
## मूल कौशल की विस्तृत व्याख्या
|
||||
|
||||
### `क्लाउड-कौशल/SKILL.md` - मेटा-कौशल ⭐
|
||||
|
||||
**कौशल जो कौशल उत्पन्न करते हैं** नए कौशल बनाने के लिए मुख्य उपकरण हैं।
|
||||
|
||||
कैसे उपयोग करें:
|
||||
1. अपनी डोमेन सामग्री (दस्तावेज़, कोड, विशिष्टताएँ, आदि) तैयार करें
|
||||
2. SKILL.md के साथ AI को डेटा प्रदान करें
|
||||
3. एआई इस क्षेत्र के लिए विशेष कौशल उत्पन्न करेगा
|
||||
|
||||
### `postgresql/SKILL.md` - PostgreSQL विशेषज्ञ ⭐
|
||||
|
||||
सबसे विस्तृत कौशल (76KB) में शामिल हैं:
|
||||
- डेटाबेस डिज़ाइन सर्वोत्तम अभ्यास
|
||||
- क्वेरी अनुकूलन तकनीक
|
||||
- सूचकांक रणनीति
|
||||
- प्रदर्शन ट्यूनिंग
|
||||
- सामान्य समस्याओं का समाधान
|
||||
- SQL कोड उदाहरण
|
||||
|
||||
### `telegram-dev/SKILL.md` - टेलीग्राम बॉट डेवलपमेंट
|
||||
|
||||
संपूर्ण टेलीग्राम बॉट डेवलपमेंट गाइड (18KB):
|
||||
- बॉट एपीआई उपयोग
|
||||
- संदेश प्रसंस्करण
|
||||
- कीबोर्ड और कॉलबैक
|
||||
- वेबहुक कॉन्फ़िगरेशन
|
||||
- त्रुटि प्रबंधन
|
||||
|
||||
### `ccxt/SKILL.md` - क्रिप्टोकरेंसी एक्सचेंज एपीआई
|
||||
|
||||
एकीकृत एक्सचेंज एपीआई पैकेज (18KB):
|
||||
- 100+ एक्सचेंजों का समर्थन करता है
|
||||
- एकीकृत डेटा प्रारूप
|
||||
- आदेश प्रबंधन
|
||||
- उद्धरण अधिग्रहण
|
||||
|
||||
## संबंधित संसाधन
|
||||
|
||||
- [कौशल जेनरेटर](https://github.com/yusufkaraaslan/Skill_Seekers) - किसी भी डेटा को एआई स्किल्स में बदलें
|
||||
- [मेटा-कौशल फ़ाइल](./claude-skills/SKILL.md) - कौशल जो कौशल उत्पन्न करते हैं
|
||||
- [प्रॉम्प्ट्स डेटाबेस](../प्रॉम्प्ट्स/) - संकेतों का एक अधिक सुक्ष्म संग्रह
|
||||
- [क्लाउड कोड गाइड](./क्लाउड-कोड-गाइड/SKILL.md) - क्लाउड कोड का उपयोग करने के लिए सर्वोत्तम अभ्यास
|
||||
- [दस्तावेज़ पुस्तकालय](../दस्तावेज़/) - कार्यप्रणाली और विकास का अनुभव
|
||||
|
|
@ -1,243 +0,0 @@
|
|||
---
|
||||
नाम: क्लाउड-कौशल
|
||||
विवरण: "क्लाउड कौशल मेटा-कौशल: डोमेन सामग्री (दस्तावेज़/एपीआई/कोड/स्पेस) को एक पुन: प्रयोज्य कौशल (SKILL.md + संदर्भ/स्क्रिप्ट/संपत्ति) में निकालें, और स्पष्टता, सक्रियण विश्वसनीयता और गुणवत्ता द्वार के लिए मौजूदा कौशल को दोबारा तैयार करें।"
|
||||
---
|
||||
|
||||
#क्लाउडस्किल्स मेटा-स्किल
|
||||
|
||||
बिखरी हुई डोमेन सामग्री को एक ऐसे कौशल में बदलें जो पुन: प्रयोज्य, रखरखाव योग्य और विश्वसनीय रूप से सक्रिय हो:
|
||||
- `SKILL.md` प्रवेश बिंदु के रूप में (ट्रिगर, बाधाएं, पैटर्न, उदाहरण)
|
||||
- दीर्घकालिक साक्ष्य और नेविगेशन के लिए `संदर्भ/`
|
||||
- मचान और टेम्पलेट्स के लिए वैकल्पिक `स्क्रिप्ट/` और `संपत्तियाँ/`
|
||||
|
||||
## इस कौशल का उपयोग कब करना है
|
||||
|
||||
जब आपको आवश्यकता हो तो इस मेटा-कौशल को ट्रिगर करें:
|
||||
- डॉक्स/स्पेक्स/रिपोज़ से शुरू से ही एक नया कौशल बनाएं
|
||||
- मौजूदा कौशल को पुनः सक्रिय करें (बहुत लंबा, अस्पष्ट, असंगत, मिसफायर)
|
||||
- डिज़ाइन विश्वसनीय सक्रियण (फ्रंटमैटर + ट्रिगर्स + सीमाएँ)
|
||||
- बड़ी सामग्री से एक साफ़ त्वरित संदर्भ निकालें
|
||||
- लंबी सामग्री को नेविगेशन योग्य `संदर्भ/` में विभाजित करें
|
||||
- एक गुणवत्ता गेट और एक सत्यापनकर्ता जोड़ें
|
||||
|
||||
## सीमाओं के लिए नहीं
|
||||
|
||||
यह मेटा-कौशल नहीं है:
|
||||
- अपने आप में एक डोमेन कौशल (यह डोमेन कौशल बनाता है)
|
||||
- बाहरी तथ्यों का आविष्कार करने का लाइसेंस (यदि सामग्री इसे साबित नहीं करती है, तो ऐसा कहें और सत्यापन पथ जोड़ें)
|
||||
- आवश्यक इनपुट के लिए एक विकल्प (यदि इनपुट गायब हैं, तो आगे बढ़ने से पहले 1-3 प्रश्न पूछें)
|
||||
|
||||
## त्वरित संदर्भ
|
||||
|
||||
### डिलिवरेबल्स (आपको क्या उत्पादन करना चाहिए)
|
||||
|
||||
आपके आउटपुट में शामिल होना चाहिए:
|
||||
1. एक ठोस निर्देशिका लेआउट (आमतौर पर `skills/<skill-name>/`)
|
||||
2. निर्णय लेने योग्य ट्रिगर्स, सीमाओं और प्रतिलिपि प्रस्तुत करने योग्य उदाहरणों के साथ एक कार्रवाई योग्य `SKILL.md`
|
||||
3. लंबे प्रारूप वाले दस्तावेज़ों को `references/index.md` के साथ `references/` में ले जाया गया
|
||||
4. प्री-डिलीवरी चेकलिस्ट (क्वालिटी गेट)
|
||||
|
||||
### अनुशंसित लेआउट (न्यूनतम -> पूर्ण)
|
||||
|
||||
```
|
||||
skill-name/
|
||||
|-- SKILL.md # Required: entrypoint with YAML frontmatter
|
||||
|-- references/ # Optional: long-form docs/evidence/index
|
||||
| `-- index.md # Recommended: navigation index
|
||||
|-- scripts/ # Optional: helpers/automation
|
||||
`-- assets/ # Optional: templates/configs/static assets
|
||||
```
|
||||
|
||||
वास्तव में न्यूनतम संस्करण सिर्फ `SKILL.md` है (आप बाद में `संदर्भ/` जोड़ सकते हैं)।
|
||||
|
||||
### YAML फ्रंटमैटर (आवश्यक)
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: skill-name
|
||||
description: "What it does + when to use (activation triggers)."
|
||||
---
|
||||
```
|
||||
|
||||
फ्रंटमैटर नियम:
|
||||
- `नाम` `^[a-z][a-z0-9-]*$` से मेल खाना चाहिए और निर्देशिका नाम से मेल खाना चाहिए
|
||||
- `विवरण` निर्णय लेने योग्य होना चाहिए ("एक्स के साथ मदद नहीं") और इसमें ठोस ट्रिगर कीवर्ड शामिल होने चाहिए
|
||||
|
||||
### न्यूनतम `SKILL.md` कंकाल (कॉपी/पेस्ट)
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill
|
||||
description: "[Domain] capability: includes [capability 1], [capability 2]. Use when [decidable triggers]."
|
||||
---
|
||||
|
||||
# my-skill Skill
|
||||
|
||||
One sentence that states the boundary and the deliverable.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
Trigger when any of these applies:
|
||||
- [Trigger 1: concrete task/keyword]
|
||||
- [Trigger 2]
|
||||
- [Trigger 3]
|
||||
|
||||
## Not For / Boundaries
|
||||
|
||||
- What this skill will not do (prevents misfires and over-promising)
|
||||
- Required inputs; ask 1-3 questions if missing
|
||||
|
||||
## Quick Reference
|
||||
|
||||
### Common Patterns
|
||||
|
||||
**Pattern 1:** one-line explanation
|
||||
```text
|
||||
[कमांड/स्निपेट आप पेस्ट कर सकते हैं और चला सकते हैं]
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1
|
||||
- Input:
|
||||
- Steps:
|
||||
- Expected output / acceptance:
|
||||
|
||||
### Example 2
|
||||
|
||||
### Example 3
|
||||
|
||||
## References
|
||||
|
||||
- `references/index.md`: navigation
|
||||
- `references/...`: long-form docs split by topic
|
||||
|
||||
## Maintenance
|
||||
|
||||
- Sources: docs/repos/specs (do not invent)
|
||||
- Last updated: YYYY-MM-DD
|
||||
- Known limits: what is explicitly out of scope
|
||||
```
|
||||
|
||||
### संलेखन नियम (परक्राम्य नहीं)
|
||||
|
||||
1. त्वरित संदर्भ संक्षिप्त, सीधे प्रयोग करने योग्य पैटर्न के लिए है
|
||||
- जब संभव हो तो इसे <= 20 पैटर्न रखें।
|
||||
- जिस किसी भी चीज़ को स्पष्टीकरण के पैराग्राफ की आवश्यकता होती है वह `संदर्भ/` में जाती है।
|
||||
2. सक्रियण निर्णय योग्य होना चाहिए
|
||||
- फ्रंटमैटर 'विवरण' में ठोस कीवर्ड के साथ "क्या + कब" लिखा होना चाहिए।
|
||||
- "कब उपयोग करें" में विशिष्ट कार्यों/इनपुट/लक्ष्यों की सूची होनी चाहिए, अस्पष्ट सहायता पाठ की नहीं।
|
||||
- विश्वसनीयता के लिए "नॉट फॉर/बाउंड्रीज़" अनिवार्य है।
|
||||
3. बाहरी विवरणों पर कोई दिखावा नहीं
|
||||
- यदि सामग्री इसे साबित नहीं करती है, तो ऐसा कहें और एक सत्यापन पथ शामिल करें।
|
||||
|
||||
### वर्कफ़्लो (सामग्री -> कौशल)
|
||||
|
||||
चरण न छोड़ें:
|
||||
1. दायरा: लिखना चाहिए/चाहिए/कभी नहीं (कुल तीन वाक्य ठीक हैं)
|
||||
2. पैटर्न निकालें: 10-20 उच्च-आवृत्ति पैटर्न चुनें (कमांड/स्निपेट/प्रवाह)
|
||||
3. उदाहरण जोड़ें: >= 3 आरंभ से अंत तक उदाहरण (इनपुट -> चरण -> स्वीकृति)
|
||||
4. सीमाएं परिभाषित करें: दायरे से बाहर क्या है + आवश्यक इनपुट
|
||||
5. संदर्भों को विभाजित करें: लंबे टेक्स्ट को `references/` में ले जाएं + `references/index.md` लिखें
|
||||
6. गेट लागू करें: चेकलिस्ट और सत्यापनकर्ता चलाएँ
|
||||
|
||||
### गुणवत्ता गेट (प्री-डिलीवरी चेकलिस्ट)
|
||||
|
||||
न्यूनतम जाँच (पूर्ण संस्करण के लिए `references/quality-checklist.md` देखें):
|
||||
1. `नाम` `^[a-z][a-z0-9-]*$` से मेल खाता है और निर्देशिका नाम से मेल खाता है
|
||||
2. `विवरण` ठोस ट्रिगर कीवर्ड के साथ "क्या + कब" बताता है
|
||||
3. निर्णायक ट्रिगर्स के साथ "इस कौशल का उपयोग कब करें" है
|
||||
4. मिसफायर को कम करने के लिए "नॉट फ़ॉर / बाउंड्रीज़" है
|
||||
5. त्वरित संदर्भ <= 20 पैटर्न है और प्रत्येक सीधे प्रयोग योग्य है
|
||||
6. >=3 प्रतिलिपि प्रस्तुत करने योग्य उदाहरण हैं
|
||||
7. लंबी सामग्री `references/` में है और `references/index.md` नेविगेट करने योग्य है
|
||||
8. अनिश्चित दावों में एक सत्यापन पथ शामिल है (कोई झांसा नहीं)
|
||||
9. एक ऑपरेटर के मैनुअल की तरह पढ़ता है, दस्तावेज़ीकरण डंप की तरह नहीं
|
||||
|
||||
स्थानीय रूप से मान्य करें:
|
||||
|
||||
```bash
|
||||
# From repo root (basic validation)
|
||||
./skills/claude-skills/scripts/validate-skill.sh skills/<skill-name>
|
||||
|
||||
# From repo root (strict validation)
|
||||
./skills/claude-skills/scripts/validate-skill.sh skills/<skill-name> --strict
|
||||
|
||||
# From skills/claude-skills/ (basic validation)
|
||||
./scripts/validate-skill.sh ../<skill-name>
|
||||
|
||||
# From skills/claude-skills/ (strict validation)
|
||||
./scripts/validate-skill.sh ../<skill-name> --strict
|
||||
```
|
||||
|
||||
### उपकरण और टेम्पलेट
|
||||
|
||||
एक नया कौशल ढांचा तैयार करें:
|
||||
|
||||
```bash
|
||||
# From repo root (generate into ./skills/)
|
||||
./skills/claude-skills/scripts/create-skill.sh my-skill --full --output skills
|
||||
|
||||
# From skills/claude-skills/ (generate into ../ i.e. ./skills/)
|
||||
./scripts/create-skill.sh my-skill --full --output ..
|
||||
|
||||
# Minimal skeleton
|
||||
./skills/claude-skills/scripts/create-skill.sh my-skill --minimal --output skills
|
||||
```
|
||||
|
||||
टेम्पलेट्स:
|
||||
- `assets/template-minimal.md`
|
||||
- `assets/template-complete.md`
|
||||
|
||||
## उदाहरण
|
||||
|
||||
### उदाहरण 1: डॉक्स से एक कौशल बनाएं
|
||||
|
||||
- इनपुट: एक आधिकारिक दस्तावेज़/विशेषता + 2-3 वास्तविक कोड नमूने + सामान्य विफलता मोड
|
||||
- कदम:
|
||||
1. `create-skill.sh` को `skills/<skill-name>/` को जोड़ने के लिए चलाएँ
|
||||
2. फ्रंटमैटर `विवरण` को "क्या + कब" के रूप में लिखें
|
||||
3. त्वरित संदर्भ में 10-20 उच्च-आवृत्ति पैटर्न निकालें
|
||||
4. स्वीकृति मानदंड के साथ >=3 शुरू से अंत तक उदाहरण जोड़ें
|
||||
5. लंबी सामग्री को `references/` में डालें और `references/index.md` तार करें
|
||||
6. `validate-skill.sh --strict` चलाएँ और पुनरावृत्त करें
|
||||
|
||||
### उदाहरण 2: "डॉक्टर डंप" कौशल को दोबारा तैयार करें
|
||||
|
||||
- इनपुट: लंबे समय से चिपकाए गए दस्तावेज़ के साथ एक मौजूदा `SKILL.md`
|
||||
- कदम:
|
||||
1. पहचानें कि कौन से भाग पैटर्न बनाम दीर्घ-रूप स्पष्टीकरण हैं
|
||||
2. लंबे प्रारूप वाले टेक्स्ट को `संदर्भ/` में ले जाएं (विषय के आधार पर विभाजित)
|
||||
3. त्वरित संदर्भ को संक्षिप्त कॉपी/पेस्ट पैटर्न के रूप में फिर से लिखें
|
||||
4. उदाहरण जोड़ें या ठीक करें जब तक कि वे प्रतिलिपि प्रस्तुत करने योग्य न हो जाएं
|
||||
5. मिसफायर को कम करने के लिए "नॉट फॉर / बाउंड्रीज़" जोड़ें
|
||||
|
||||
### उदाहरण 3: एक कौशल को मान्य करें और प्राप्त करें
|
||||
|
||||
- इनपुट: `कौशल/<कौशल-नाम>/`
|
||||
- कदम:
|
||||
1. चेतावनियाँ प्राप्त करने के लिए `validate-skill.sh` (नॉन-स्ट्रिक्ट) चलाएँ
|
||||
2. फ्रंटमैटर/नाम बेमेल और गायब अनुभागों को ठीक करें
|
||||
3. विशिष्टता लागू करने के लिए `validate-skill.sh --strict` चलाएँ
|
||||
4. शिपिंग से पहले स्कोरिंग रूब्रिक को `references/quality-checklist.md` में चलाएँ
|
||||
|
||||
## सन्दर्भ
|
||||
|
||||
स्थानीय दस्तावेज़:
|
||||
- `संदर्भ/index.md`
|
||||
- `संदर्भ/कौशल-spec.md`
|
||||
- `संदर्भ/गुणवत्ता-चेकलिस्ट.एमडी`
|
||||
- `संदर्भ/एंटी-पैटर्न.एमडी`
|
||||
- `संदर्भ/README.md` (अपस्ट्रीम आधिकारिक संदर्भ)
|
||||
|
||||
बाहरी (आधिकारिक):
|
||||
- https://support.claude.com/en/articles/12512176-what-are-skills
|
||||
- https://support.claude.com/en/articles/12512180-using-skills-in-claude
|
||||
- https://support.claude.com/en/articles/12512198-creating-custom-skills
|
||||
- https://docs.claude.com/en/api/skills-guide
|
||||
|
||||
## रखरखाव
|
||||
|
||||
- स्रोत: `skills/claude-skills/references/` में स्थानीय विशिष्ट फ़ाइलें + `references/README.md` में अपस्ट्रीम आधिकारिक दस्तावेज़
|
||||
- अंतिम अद्यतन: 2025-12-14
|
||||
- ज्ञात सीमाएँ: `validate-skill.sh` अनुमानवादी है; सख्त मोड अनुशंसित अनुभाग शीर्षकों को मानता है
|
||||
|
|
@ -1,274 +0,0 @@
|
|||
---
|
||||
नाम: स्नैपडोम
|
||||
विवरण: स्नैपडॉम एक तेज़, सटीक डोम-टू-इमेज कैप्चर टूल है जो HTML तत्वों को स्केलेबल एसवीजी छवियों में परिवर्तित करता है। HTML तत्वों को कैप्चर करने, DOM को छवियों (SVG, PNG, JPG, WebP) में परिवर्तित करने, शैलियों, फ़ॉन्ट और छद्म तत्वों को संरक्षित करने के लिए उपयोग करें।
|
||||
---
|
||||
|
||||
#SnapDOMSkill
|
||||
|
||||
HTML तत्वों को स्केलेबल एसवीजी या रैस्टर छवि प्रारूपों में परिवर्तित करने के लिए तेज़, निर्भरता-मुक्त DOM-टू-इमेज कैप्चर लाइब्रेरी।
|
||||
|
||||
## इस कौशल का उपयोग कब करना है
|
||||
|
||||
जब आपको आवश्यकता हो तब SnapDOM का उपयोग करें:
|
||||
- HTML तत्वों को छवियों में बदलें (एसवीजी, पीएनजी, जेपीजी, वेबपी)
|
||||
- छद्म तत्वों और छायाओं के साथ स्टाइल वाले DOM को कैप्चर करें
|
||||
- एम्बेडेड फ़ॉन्ट और आइकन के साथ तत्वों को निर्यात करें
|
||||
- कस्टम आयाम या स्केलिंग के साथ स्क्रीनशॉट बनाएं
|
||||
- प्रॉक्सी फ़ॉलबैक का उपयोग करके CORS-अवरुद्ध संसाधनों को संभालें
|
||||
- प्लगइन्स के साथ कस्टम रेंडरिंग पाइपलाइन लागू करें
|
||||
- बड़े या जटिल तत्वों पर प्रदर्शन का अनुकूलन करें
|
||||
|
||||
## प्रमुख विशेषताऐं
|
||||
|
||||
### सार्वभौमिक निर्यात विकल्प
|
||||
- **एसवीजी** - स्केलेबल वेक्टर प्रारूप, सभी शैलियों को एम्बेड करता है
|
||||
- **पीएनजी, जेपीजी, वेबपी** - विन्यास योग्य गुणवत्ता के साथ रेखापुंज प्रारूप
|
||||
- **कैनवास** - आगे की प्रक्रिया के लिए कच्चा कैनवास तत्व प्राप्त करें
|
||||
- **ब्लॉब** - कस्टम हैंडलिंग के लिए कच्चा बाइनरी डेटा
|
||||
|
||||
###प्रदर्शन
|
||||
- अल्ट्रा-फास्ट कैप्चर (छोटे तत्वों के लिए 1.6 एमएस, 4000×2000 के लिए ~171 एमएस)
|
||||
- **कोई निर्भरता नहीं** - केवल मानक वेब एपीआई का उपयोग करता है
|
||||
- जटिल तत्वों पर html2canvas से 10-40 गुना बेहतर प्रदर्शन करता है
|
||||
|
||||
### शैली समर्थन
|
||||
- एंबेडेड फ़ॉन्ट (आइकन फ़ॉन्ट सहित)
|
||||
- सीएसएस छद्म तत्व (::पहले, ::बाद)
|
||||
- सीएसएस काउंटर
|
||||
- सीएसएस लाइन-क्लैंप
|
||||
- परिवर्तन और छाया प्रभाव
|
||||
- छाया डोम सामग्री
|
||||
|
||||
### उन्नत क्षमताएँ
|
||||
-समान मूल आईफ्रेम समर्थन
|
||||
- अवरुद्ध परिसंपत्तियों के लिए CORS प्रॉक्सी फ़ॉलबैक
|
||||
- कस्टम परिवर्तनों के लिए प्लगइन प्रणाली
|
||||
- परिवर्तनों को सीधा करें (घुमाएँ/अनुवाद हटाएँ)
|
||||
-चयनात्मक तत्व बहिष्करण
|
||||
- चुस्त बाउंडिंग बॉक्स गणना
|
||||
|
||||
## स्थापना
|
||||
|
||||
### एनपीएम/यार्न
|
||||
```bash
|
||||
npm install @zumer/snapdom
|
||||
# or
|
||||
yarn add @zumer/snapdom
|
||||
```
|
||||
|
||||
### सीडीएन (ईएस मॉड्यूल)
|
||||
```html
|
||||
<script type="module">
|
||||
import { snapdom } from "https://unpkg.com/@zumer/snapdom/dist/snapdom.mjs";
|
||||
</script>
|
||||
```
|
||||
|
||||
### सीडीएन (यूएमडी)
|
||||
```html
|
||||
<script src="https://unpkg.com/@zumer/snapdom/dist/snapdom.umd.js"></script>
|
||||
```
|
||||
|
||||
## त्वरित प्रारंभ उदाहरण
|
||||
|
||||
### बुनियादी पुन: प्रयोज्य कैप्चर
|
||||
```javascript
|
||||
// Create reusable capture object
|
||||
const result = await snapdom(document.querySelector('#target'));
|
||||
|
||||
// Export to different formats
|
||||
const png = await result.toPng();
|
||||
const jpg = await result.toJpg();
|
||||
const svg = await result.toSvg();
|
||||
const canvas = await result.toCanvas();
|
||||
const blob = await result.toBlob();
|
||||
|
||||
// Use the result
|
||||
document.body.appendChild(png);
|
||||
```
|
||||
|
||||
### एक-चरणीय निर्यात
|
||||
```javascript
|
||||
// Direct export without intermediate object
|
||||
const png = await snapdom.toPng(document.querySelector('#target'));
|
||||
const svg = await snapdom.toSvg(element);
|
||||
```
|
||||
|
||||
### तत्व डाउनलोड करें
|
||||
```javascript
|
||||
// Automatically download as file
|
||||
await snapdom.download(element, 'screenshot.png');
|
||||
await snapdom.download(element, 'image.svg');
|
||||
```
|
||||
|
||||
### विकल्पों के साथ
|
||||
```javascript
|
||||
const result = await snapdom(element, {
|
||||
scale: 2, // 2x resolution
|
||||
width: 800, // Custom width
|
||||
height: 600, // Custom height
|
||||
embedFonts: true, // Include @font-face
|
||||
exclude: '.no-capture', // Hide elements
|
||||
useProxy: true, // Enable CORS proxy
|
||||
straighten: true, // Remove transforms
|
||||
noShadows: false // Keep shadows
|
||||
});
|
||||
|
||||
const png = await result.toPng({ quality: 0.95 });
|
||||
```
|
||||
|
||||
## आवश्यक विकल्प संदर्भ
|
||||
|
||||
| विकल्प | प्रकार | उद्देश्य |
|
||||
|------|------|------|
|
||||
| 'स्केल' | संख्या | स्केल आउटपुट (जैसे, 2x रिज़ॉल्यूशन के लिए 2) |
|
||||
| 'चौड़ाई' | संख्या | पिक्सेल में कस्टम आउटपुट चौड़ाई |
|
||||
| 'ऊंचाई' | संख्या | पिक्सेल में कस्टम आउटपुट ऊंचाई |
|
||||
| `एम्बेडफ़ॉन्ट्स` | बूलियन | गैर-आइकन @ फ़ॉन्ट-फेस नियम शामिल करें |
|
||||
| `प्रॉक्सी का प्रयोग करें` | स्ट्रिंग\|बूलियन | CORS प्रॉक्सी सक्षम करें (डिफ़ॉल्ट के लिए URL या सत्य) |
|
||||
| 'बहिष्कृत' | स्ट्रिंग | तत्वों को छिपाने के लिए सीएसएस चयनकर्ता |
|
||||
| 'सीधा करो' | बूलियन | ट्रांसलेशन/रोटेट ट्रांसफॉर्म हटाएं |
|
||||
| `नोशैडोज़` | बूलियन | पट्टी छाया प्रभाव |
|
||||
|
||||
## सामान्य पैटर्न
|
||||
|
||||
### प्रतिक्रियाशील स्क्रीनशॉट
|
||||
```javascript
|
||||
// Capture at different scales
|
||||
const mobile = await snapdom.toPng(element, { scale: 1 });
|
||||
const tablet = await snapdom.toPng(element, { scale: 1.5 });
|
||||
const desktop = await snapdom.toPng(element, { scale: 2 });
|
||||
```
|
||||
|
||||
### तत्वों को बाहर निकालें
|
||||
```javascript
|
||||
// Hide specific elements from capture
|
||||
const png = await snapdom.toPng(element, {
|
||||
exclude: '.controls, .watermark, [data-no-capture]'
|
||||
});
|
||||
```
|
||||
|
||||
### निश्चित आयाम
|
||||
```javascript
|
||||
// Capture with specific size
|
||||
const result = await snapdom(element, {
|
||||
width: 1200,
|
||||
height: 630 // Standard social media size
|
||||
});
|
||||
```
|
||||
|
||||
### सीओआरएस हैंडलिंग
|
||||
```javascript
|
||||
// Fallback for CORS-blocked resources
|
||||
const png = await snapdom.toPng(element, {
|
||||
useProxy: 'https://cors.example.com/?' // Custom proxy
|
||||
});
|
||||
```
|
||||
|
||||
### प्लगइन सिस्टम (बीटा)
|
||||
```javascript
|
||||
// Extend with custom exporters
|
||||
snapdom.plugins([pluginFactory, { colorOverlay: true }]);
|
||||
|
||||
// Hook into lifecycle
|
||||
defineExports(context) {
|
||||
return {
|
||||
pdf: async (ctx, opts) => { /* generate PDF */ }
|
||||
};
|
||||
}
|
||||
|
||||
// Lifecycle hooks available:
|
||||
// beforeSnap → beforeClone → afterClone →
|
||||
// beforeRender → beforeExport → afterExport
|
||||
```
|
||||
|
||||
## प्रदर्शन तुलना
|
||||
|
||||
SnapDOM html2canvas से काफी बेहतर प्रदर्शन करता है:
|
||||
|
||||
| परिदृश्य | स्नैपडॉम | html2कैनवास | सुधार |
|
||||
|---|---|---|---|
|
||||
| छोटा (200×100) | 1.6ms | 68ms | 42x तेज |
|
||||
| मध्यम (800×600) | 12 एमएस | 280 एमएस | 23 गुना तेज |
|
||||
| बड़ा (4000×2000) | 171 एमएस | 1,800 एमएस | 10 गुना तेज |
|
||||
|
||||
## विकास
|
||||
|
||||
### स्थापित करना
|
||||
```bash
|
||||
git clone https://github.com/zumerlab/snapdom.git
|
||||
cd snapdom
|
||||
npm install
|
||||
```
|
||||
|
||||
### निर्माण
|
||||
```bash
|
||||
npm run compile
|
||||
```
|
||||
|
||||
### परीक्षण
|
||||
```bash
|
||||
npm test
|
||||
```
|
||||
|
||||
## ब्राउज़र समर्थन
|
||||
|
||||
- क्रोम/एज 90+
|
||||
- फ़ायरफ़ॉक्स 88+
|
||||
-सफारी 14+
|
||||
- मोबाइल ब्राउज़र (iOS Safari 14+, Chrome मोबाइल)
|
||||
|
||||
## संसाधन
|
||||
|
||||
### दस्तावेज़ीकरण
|
||||
- **आधिकारिक वेबसाइट:** https://snapdom.dev/
|
||||
- **गिटहब रिपॉजिटरी:** https://github.com/zumerlab/snapdom
|
||||
- **एनपीएम पैकेज:** https://www.npmjs.com/package/@zumer/snapdom
|
||||
- **लाइसेंस:** एमआईटी
|
||||
|
||||
### स्क्रिप्ट/
|
||||
स्वचालन के लिए यहां सहायक स्क्रिप्ट जोड़ें, उदाहरण:
|
||||
- `बैच-स्क्रीनशॉट.जेएस` - एकाधिक तत्वों को कैप्चर करें
|
||||
- `pdf-export.js` - स्नैपशॉट को पीडीएफ में बदलें
|
||||
- `तुलना-आउटपुट.जेएस` - एसवीजी बनाम पीएनजी गुणवत्ता की तुलना करें
|
||||
|
||||
### संपत्ति/
|
||||
टेम्पलेट और उदाहरण जोड़ें:
|
||||
- सामान्य कैप्चर परिदृश्यों के लिए HTML टेम्पलेट
|
||||
- सीएसएस फ्रेमवर्क स्नैपडोम के साथ पूर्व-कॉन्फ़िगर किया गया
|
||||
- स्नैपडोम को एकीकृत करने वाली बॉयलरप्लेट परियोजनाएं
|
||||
|
||||
## संबंधित उपकरण
|
||||
|
||||
- **html2canvas** - वैकल्पिक DOM कैप्चर (धीमा लेकिन अधिक संगत)
|
||||
- **ऑर्बिट सीएसएस टूलकिट** - ज़ुमेरलैब द्वारा सहयोगी टूलकिट (https://github.com/zumerlab/orbit)
|
||||
|
||||
## युक्तियाँ एवं सर्वोत्तम प्रथाएँ
|
||||
|
||||
1. **प्रदर्शन**: बेहतर प्रदर्शन के लिए `चौड़ाई`/`ऊंचाई` के बजाय `स्केल` का उपयोग करें
|
||||
2. **फ़ॉन्ट**: यह सुनिश्चित करने के लिए कि कस्टम फ़ॉन्ट सही ढंग से दिखाई दें, `एम्बेडफ़ॉन्ट: सत्य` सेट करें
|
||||
3. **सीओआरएस मुद्दे**: यदि छवियां लोड होने में विफल रहती हैं तो `useProxy: true` का उपयोग करें
|
||||
4. **बड़े तत्व**: जटिल पृष्ठों के लिए छोटे भागों में तोड़ें
|
||||
5. **गुणवत्ता**: पीएनजी/जेपीजी के लिए, सर्वोत्तम गुणवत्ता के लिए `गुणवत्ता: 0.95` का उपयोग करें
|
||||
6. **एसवीजी वेक्टर**: चार्ट और ग्राफिक्स के लिए एसवीजी निर्यात को प्राथमिकता दें
|
||||
|
||||
## समस्या निवारण
|
||||
|
||||
### तत्वों का प्रतिपादन नहीं हो रहा है
|
||||
- जांचें कि क्या तत्व की ऊंचाई/चौड़ाई पर्याप्त है
|
||||
- कैप्चर करने से पहले सत्यापित करें कि सीएसएस पूरी तरह से लोड है
|
||||
- यदि परिवर्तन समस्याएँ पैदा कर रहा है तो `सीधा करें: गलत` आज़माएँ
|
||||
|
||||
### गुम फ़ॉन्ट्स
|
||||
- `एम्बेडफ़ॉन्ट: सत्य` सेट करें
|
||||
- स्नैपडॉम को कॉल करने से पहले सुनिश्चित करें कि फ़ॉन्ट लोड किए गए हैं
|
||||
- फ़ॉन्ट लोडिंग त्रुटियों के लिए ब्राउज़र कंसोल की जाँच करें
|
||||
|
||||
### सीओआरएस मुद्दे
|
||||
- `useProxy: true` सक्षम करें
|
||||
- डिफ़ॉल्ट विफल होने पर कस्टम प्रॉक्सी यूआरएल का उपयोग करें
|
||||
- जांचें कि क्या संसाधन एक ही मूल से हैं
|
||||
|
||||
### प्रदर्शन संबंधी मुद्दे
|
||||
- `स्केल' मान कम करें
|
||||
- छाया प्रतिपादन को छोड़ने के लिए `noShadows: true` का उपयोग करें
|
||||
- बड़े कैप्चर को छोटे खंडों में विभाजित करने पर विचार करें
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# id 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# it 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ja 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ko 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ms 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# nl 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# pl 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# pt 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ru 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# sw 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# ta 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# th 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
# tr 语言包
|
||||
|
||||
- documents/: 该语言的文档与方法论
|
||||
- prompts/: 该语言的提示词资产
|
||||
- skills/: 该语言的技能与参考
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue