diff --git a/README.md b/README.md index f354d41..21eedbe 100644 --- a/README.md +++ b/README.md @@ -30,9 +30,8 @@

- 简体中文 + 简体中文 English - 更多语言

diff --git a/i18n/README.md b/i18n/README.md deleted file mode 100644 index cbb180e..0000000 --- a/i18n/README.md +++ /dev/null @@ -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// -├── README.md # 语言入口 -├── documents/ # 文档 -├── prompts/ # 提示词 -└── skills/ # 技能 -``` - ---- - -## 🤝 贡献翻译 - -欢迎为任何语言贡献翻译!请参考 [CONTRIBUTING.md](../CONTRIBUTING.md)。 - -1. Fork 本仓库 -2. 在对应语言目录下添加/修改内容 -3. 提交 Pull Request - ---- - -[← 返回主页](../README.md) diff --git a/i18n/ar/README.md b/i18n/ar/README.md deleted file mode 100644 index 7926cbf..0000000 --- a/i18n/ar/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ar 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ar/documents/.gitkeep b/i18n/ar/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ar/prompts/.gitkeep b/i18n/ar/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ar/skills/.gitkeep b/i18n/ar/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/bn/README.md b/i18n/bn/README.md deleted file mode 100644 index f0ab48f..0000000 --- a/i18n/bn/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# bn 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/bn/documents/.gitkeep b/i18n/bn/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/bn/prompts/.gitkeep b/i18n/bn/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/bn/skills/.gitkeep b/i18n/bn/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/de/README.md b/i18n/de/README.md deleted file mode 100644 index eae4b65..0000000 --- a/i18n/de/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# de 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/de/documents/.gitkeep b/i18n/de/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/de/prompts/.gitkeep b/i18n/de/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/de/skills/.gitkeep b/i18n/de/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/en/README.md b/i18n/en/README.md index e12e5c9..b836671 100644 --- a/i18n/en/README.md +++ b/i18n/en/README.md @@ -5,7 +5,7 @@ -->

- Vibe Coding Guide + Vibe Coding Guide

@@ -21,55 +21,49 @@ -->

- License + License Main Language Code Size - Contributors X Telegram Group

- Simplified Chinese - English - More Languages + 简体中文 + English

- Core Philosophy - Glue Coding - Getting Started - Language Layers - Common Pitfalls - Resource Aggregation -

- -

- Meta Methodology - Way of Programming - Practice Projects -

- -

- Tools -

- -

- Curated Prompts - Skills Collection - Online Prompt Sheet + Philosophy & Methodology + Core Philosophy + Glue Coding + Canvas Whiteboard Driven Development + Getting Started + Blood Lessons + Language Layer Elements + Common Pitfalls + Hard Constraints + Resource Aggregation + Meta Methodology + Way of Programming + Practice Projects + Tools + Curated Prompts + Skills Collection + Online Prompt Sheet System Prompts Repo - Chat Vault + Chat Vault

[📋 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) + + + +
+🎨 Canvas Whiteboard-Driven Development + +> **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) + +
+ +
+🐝 AI Swarm Collaboration + +> **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)
@@ -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 +
+🔑 Meta-Methodology 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**. +
+ +
+🧭 Methodology Essence (Dao · Fa · Shu) + ## 🧭 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** + +
+ +
+📋 The Tools (Qi) ## 📋 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. + --- +
+ +
+Coding Model Performance Tier Reference + ## 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 +
-* **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. - ---- +
+Project Directory Structure Overview ### 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 +
+ +## 📺 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. +
+⚙️ Architecture and Workflow + ## ⚙️ 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 --- +
+
📈 Performance Benchmarks (Optional) @@ -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! @0XBard_thomas | @Pluvio9yte | @xDinoDeer | -@geekbb -@GitHub_Daily +@geekbb | +@GitHub_Daily | +@BiteyeCN | +@CryptoJHK

--- @@ -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) -
\ No newline at end of file + diff --git a/i18n/es/README.md b/i18n/es/README.md deleted file mode 100644 index 5977dda..0000000 --- a/i18n/es/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# es 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/es/documents/.gitkeep b/i18n/es/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/es/prompts/.gitkeep b/i18n/es/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/es/skills/.gitkeep b/i18n/es/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/fa/README.md b/i18n/fa/README.md deleted file mode 100644 index 1357717..0000000 --- a/i18n/fa/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# fa 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/fa/documents/.gitkeep b/i18n/fa/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/fa/prompts/.gitkeep b/i18n/fa/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/fa/skills/.gitkeep b/i18n/fa/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/fr/README.md b/i18n/fr/README.md deleted file mode 100644 index db8d1dd..0000000 --- a/i18n/fr/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# fr 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/fr/documents/.gitkeep b/i18n/fr/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/fr/prompts/.gitkeep b/i18n/fr/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/fr/skills/.gitkeep b/i18n/fr/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ha/README.md b/i18n/ha/README.md deleted file mode 100644 index e14c8a5..0000000 --- a/i18n/ha/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ha 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ha/documents/.gitkeep b/i18n/ha/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ha/prompts/.gitkeep b/i18n/ha/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ha/skills/.gitkeep b/i18n/ha/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/he/README.md b/i18n/he/README.md deleted file mode 100644 index f3eebee..0000000 --- a/i18n/he/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# he 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/he/documents/.gitkeep b/i18n/he/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/he/prompts/.gitkeep b/i18n/he/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/he/skills/.gitkeep b/i18n/he/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/README.md b/i18n/hi/README.md deleted file mode 100644 index b3fc6fc..0000000 --- a/i18n/hi/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# hi 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/hi/documents/.gitkeep b/i18n/hi/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/documents/README.md b/i18n/hi/documents/README.md deleted file mode 100644 index 5569d71..0000000 --- a/i18n/hi/documents/README.md +++ /dev/null @@ -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/) - उपकरण और बाहरी एकीकरण diff --git a/i18n/hi/prompts/.gitkeep b/i18n/hi/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/prompts/README.md b/i18n/hi/prompts/README.md deleted file mode 100644 index 38936a8..0000000 --- a/i18n/hi/prompts/README.md +++ /dev/null @@ -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/बाहरी/प्रॉम्पट्स-लाइब्रेरी/): शीघ्र शब्द एक्सेल ↔ मार्कडाउन प्रबंधन उपकरण diff --git a/i18n/hi/skills/.gitkeep b/i18n/hi/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/skills/README.md b/i18n/hi/skills/README.md deleted file mode 100644 index 1facc99..0000000 --- a/i18n/hi/skills/README.md +++ /dev/null @@ -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) - क्लाउड कोड का उपयोग करने के लिए सर्वोत्तम अभ्यास -- [दस्तावेज़ पुस्तकालय](../दस्तावेज़/) - कार्यप्रणाली और विकास का अनुभव diff --git a/i18n/hi/skills/claude-skills/SKILL.md b/i18n/hi/skills/claude-skills/SKILL.md deleted file mode 100644 index 8b65553..0000000 --- a/i18n/hi/skills/claude-skills/SKILL.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -नाम: क्लाउड-कौशल -विवरण: "क्लाउड कौशल मेटा-कौशल: डोमेन सामग्री (दस्तावेज़/एपीआई/कोड/स्पेस) को एक पुन: प्रयोज्य कौशल (SKILL.md + संदर्भ/स्क्रिप्ट/संपत्ति) में निकालें, और स्पष्टता, सक्रियण विश्वसनीयता और गुणवत्ता द्वार के लिए मौजूदा कौशल को दोबारा तैयार करें।" ---- - -#क्लाउडस्किल्स मेटा-स्किल - -बिखरी हुई डोमेन सामग्री को एक ऐसे कौशल में बदलें जो पुन: प्रयोज्य, रखरखाव योग्य और विश्वसनीय रूप से सक्रिय हो: -- `SKILL.md` प्रवेश बिंदु के रूप में (ट्रिगर, बाधाएं, पैटर्न, उदाहरण) -- दीर्घकालिक साक्ष्य और नेविगेशन के लिए `संदर्भ/` -- मचान और टेम्पलेट्स के लिए वैकल्पिक `स्क्रिप्ट/` और `संपत्तियाँ/` - -## इस कौशल का उपयोग कब करना है - -जब आपको आवश्यकता हो तो इस मेटा-कौशल को ट्रिगर करें: -- डॉक्स/स्पेक्स/रिपोज़ से शुरू से ही एक नया कौशल बनाएं -- मौजूदा कौशल को पुनः सक्रिय करें (बहुत लंबा, अस्पष्ट, असंगत, मिसफायर) -- डिज़ाइन विश्वसनीय सक्रियण (फ्रंटमैटर + ट्रिगर्स + सीमाएँ) -- बड़ी सामग्री से एक साफ़ त्वरित संदर्भ निकालें -- लंबी सामग्री को नेविगेशन योग्य `संदर्भ/` में विभाजित करें -- एक गुणवत्ता गेट और एक सत्यापनकर्ता जोड़ें - -## सीमाओं के लिए नहीं - -यह मेटा-कौशल नहीं है: -- अपने आप में एक डोमेन कौशल (यह डोमेन कौशल बनाता है) -- बाहरी तथ्यों का आविष्कार करने का लाइसेंस (यदि सामग्री इसे साबित नहीं करती है, तो ऐसा कहें और सत्यापन पथ जोड़ें) -- आवश्यक इनपुट के लिए एक विकल्प (यदि इनपुट गायब हैं, तो आगे बढ़ने से पहले 1-3 प्रश्न पूछें) - -## त्वरित संदर्भ - -### डिलिवरेबल्स (आपको क्या उत्पादन करना चाहिए) - -आपके आउटपुट में शामिल होना चाहिए: -1. एक ठोस निर्देशिका लेआउट (आमतौर पर `skills//`) -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/ - -# From repo root (strict validation) -./skills/claude-skills/scripts/validate-skill.sh skills/ --strict - -# From skills/claude-skills/ (basic validation) -./scripts/validate-skill.sh ../ - -# From skills/claude-skills/ (strict validation) -./scripts/validate-skill.sh ../ --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//` को जोड़ने के लिए चलाएँ - 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` अनुमानवादी है; सख्त मोड अनुशंसित अनुभाग शीर्षकों को मानता है diff --git a/i18n/hi/skills/coingecko/.gitkeep b/i18n/hi/skills/coingecko/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/skills/cryptofeed/.gitkeep b/i18n/hi/skills/cryptofeed/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/skills/snapdom/SKILL.md b/i18n/hi/skills/snapdom/SKILL.md deleted file mode 100644 index b1f7aad..0000000 --- a/i18n/hi/skills/snapdom/SKILL.md +++ /dev/null @@ -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 - -``` - -### सीडीएन (यूएमडी) -```html - -``` - -## त्वरित प्रारंभ उदाहरण - -### बुनियादी पुन: प्रयोज्य कैप्चर -```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` का उपयोग करें -- बड़े कैप्चर को छोटे खंडों में विभाजित करने पर विचार करें diff --git a/i18n/hi/skills/telegram-dev/.gitkeep b/i18n/hi/skills/telegram-dev/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/hi/skills/timescaledb/.gitkeep b/i18n/hi/skills/timescaledb/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/id/README.md b/i18n/id/README.md deleted file mode 100644 index 60faad9..0000000 --- a/i18n/id/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# id 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/id/documents/.gitkeep b/i18n/id/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/id/prompts/.gitkeep b/i18n/id/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/id/skills/.gitkeep b/i18n/id/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/it/README.md b/i18n/it/README.md deleted file mode 100644 index c9c487c..0000000 --- a/i18n/it/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# it 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/it/documents/.gitkeep b/i18n/it/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/it/prompts/.gitkeep b/i18n/it/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/it/skills/.gitkeep b/i18n/it/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ja/README.md b/i18n/ja/README.md deleted file mode 100644 index 8b95276..0000000 --- a/i18n/ja/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ja 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ja/documents/.gitkeep b/i18n/ja/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ja/prompts/.gitkeep b/i18n/ja/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ja/skills/.gitkeep b/i18n/ja/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ko/README.md b/i18n/ko/README.md deleted file mode 100644 index 83c336b..0000000 --- a/i18n/ko/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ko 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ko/documents/.gitkeep b/i18n/ko/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ko/prompts/.gitkeep b/i18n/ko/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ko/skills/.gitkeep b/i18n/ko/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ms/README.md b/i18n/ms/README.md deleted file mode 100644 index fb0169b..0000000 --- a/i18n/ms/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ms 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ms/documents/.gitkeep b/i18n/ms/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ms/prompts/.gitkeep b/i18n/ms/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ms/skills/.gitkeep b/i18n/ms/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/nl/README.md b/i18n/nl/README.md deleted file mode 100644 index 05939ba..0000000 --- a/i18n/nl/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# nl 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/nl/documents/.gitkeep b/i18n/nl/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/nl/prompts/.gitkeep b/i18n/nl/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/nl/skills/.gitkeep b/i18n/nl/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/pl/README.md b/i18n/pl/README.md deleted file mode 100644 index d35a055..0000000 --- a/i18n/pl/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# pl 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/pl/documents/.gitkeep b/i18n/pl/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/pl/prompts/.gitkeep b/i18n/pl/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/pl/skills/.gitkeep b/i18n/pl/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/pt/README.md b/i18n/pt/README.md deleted file mode 100644 index 0ce8f0e..0000000 --- a/i18n/pt/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# pt 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/pt/documents/.gitkeep b/i18n/pt/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/pt/prompts/.gitkeep b/i18n/pt/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/pt/skills/.gitkeep b/i18n/pt/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ru/README.md b/i18n/ru/README.md deleted file mode 100644 index 6f409ce..0000000 --- a/i18n/ru/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ru 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ru/documents/.gitkeep b/i18n/ru/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ru/prompts/.gitkeep b/i18n/ru/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ru/skills/.gitkeep b/i18n/ru/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/sw/README.md b/i18n/sw/README.md deleted file mode 100644 index d1ba41a..0000000 --- a/i18n/sw/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# sw 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/sw/documents/.gitkeep b/i18n/sw/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/sw/prompts/.gitkeep b/i18n/sw/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/sw/skills/.gitkeep b/i18n/sw/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ta/README.md b/i18n/ta/README.md deleted file mode 100644 index 4db2f02..0000000 --- a/i18n/ta/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ta 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ta/documents/.gitkeep b/i18n/ta/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ta/prompts/.gitkeep b/i18n/ta/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ta/skills/.gitkeep b/i18n/ta/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/th/README.md b/i18n/th/README.md deleted file mode 100644 index af854dc..0000000 --- a/i18n/th/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# th 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/th/documents/.gitkeep b/i18n/th/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/th/prompts/.gitkeep b/i18n/th/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/th/skills/.gitkeep b/i18n/th/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/tr/README.md b/i18n/tr/README.md deleted file mode 100644 index 4a1e9fb..0000000 --- a/i18n/tr/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# tr 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/tr/documents/.gitkeep b/i18n/tr/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/tr/prompts/.gitkeep b/i18n/tr/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/tr/skills/.gitkeep b/i18n/tr/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/uk/README.md b/i18n/uk/README.md deleted file mode 100644 index b1b12cc..0000000 --- a/i18n/uk/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# uk 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/uk/documents/.gitkeep b/i18n/uk/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/uk/prompts/.gitkeep b/i18n/uk/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/uk/skills/.gitkeep b/i18n/uk/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ur/README.md b/i18n/ur/README.md deleted file mode 100644 index 5664f15..0000000 --- a/i18n/ur/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# ur 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/ur/documents/.gitkeep b/i18n/ur/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ur/prompts/.gitkeep b/i18n/ur/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/ur/skills/.gitkeep b/i18n/ur/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/vi/README.md b/i18n/vi/README.md deleted file mode 100644 index 7219b93..0000000 --- a/i18n/vi/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# vi 语言包 - -- documents/: 该语言的文档与方法论 -- prompts/: 该语言的提示词资产 -- skills/: 该语言的技能与参考 diff --git a/i18n/vi/documents/.gitkeep b/i18n/vi/documents/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/vi/prompts/.gitkeep b/i18n/vi/prompts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/vi/skills/.gitkeep b/i18n/vi/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/zh/documents/-01-哲学与方法论/README.md b/i18n/zh/documents/-01-哲学与方法论/README.md index 1cdac3b..eee5650 100644 --- a/i18n/zh/documents/-01-哲学与方法论/README.md +++ b/i18n/zh/documents/-01-哲学与方法论/README.md @@ -1,99 +1,541 @@ -# -01- 哲学与方法论:Vibe Coding 的底层协议 +# Vibe Coding 哲学方法论提效工具箱(Python) -> **“代码是思维的投影,哲学是思维的操作系统。”** +> 目标:把"vibe(探索)"系统化为"可验证、可迭代、可收敛"的工程产出。 +> 每个方法给出:用途 / 落地动作 / Python工具 / 可复制提示词。 -在 Vibe Coding 的范式中,我们不再仅仅是“打字员”,而是“意图的架构师”。本模块将跨学科的哲学工具转化为可执行的工程指令,旨在消除人机协作中的认知摩擦,提升意图传递的精确度。 +## 目录 + +- [总体作业流](#总体作业流) +- [推荐底座](#推荐底座python) +- [方法论](#方法论) + - [1. 现象学还原](#1-现象学还原悬置假设) + - [2. 正反合](#2-正反合三段迭代) + - [3. 可证伪主义](#3-可证伪主义波普尔) + - [4. 形式化方法](#4-形式化方法轻量形式化) + - [5. 奥卡姆剃刀](#5-奥卡姆剃刀最小复杂度) + - [6. 实用主义](#6-实用主义以指标为准) + - [7. 系统论/整体论](#7-系统论整体论边界与反馈回路) + - [8. 诠释学](#8-诠释学语境澄清) + - [9. 钢人化原则](#9-钢人化原则最强版本理解) + - [10. 决策论/机会成本](#10-决策论机会成本可逆优先) + - [11. 反事实推理](#11-反事实推理counterfactuals) + - [12. 溯因推理](#12-溯因推理abduction最佳解释) + - [13. 贝叶斯式信念更新](#13-贝叶斯式信念更新与溯因配合) + - [14. 反思平衡](#14-反思平衡reflective-equilibrium) + - [15. 概念分析/概念工程](#15-概念分析--概念工程) + - [16. 方法论怀疑](#16-方法论怀疑笛卡尔式) + - [17. 视角三角测量](#17-视角三角测量triangulation) + - [18. 机制解释](#18-机制解释mechanistic-explanation) + - [19. 错误认识论](#19-错误认识论error-epistemology) + - [20. 实验哲学](#20-实验哲学x-phi) + - [21. 计算哲学](#21-计算哲学computational-philosophy) + - [22. 自然化认识论](#22-自然化认识论naturalized-epistemology) + - [23. 贝叶斯认识论](#23-贝叶斯认识论bayesian-epistemology) +- [附录](#附录) +- [使用指南](#使用指南) --- -## 目录索引 +## 总体作业流 -1. [感知与定义:如何看清真相](#1-感知与定义如何看清真相) -2. [逻辑与精炼:如何深度推理](#2-逻辑与精炼如何深度推理) -3. [验证与纠偏:如何对抗幻觉](#3-验证与纠偏如何对抗幻觉) -4. [系统与演进:如何全局决策](#4-系统与演进如何全局决策) -5. [前沿认知工具:形式化与计算化](#5-前沿认知工具形式化与计算化) +建议默认流程: + +1. **现象卡片**(现象/意图/情境/边界)→ 清零脑补 +2. **规格化**(类型+schema+错误语义+不变式)→ 可机器检查 +3. **检查器**(单测+性质测试+lint+类型检查+关键断言)→ 可证伪 +4. **最小实现**(main path)→ 快速跑通 +5. **反例驱动**(Hypothesis/边界/差分/基准)→ 找到失败模式 +6. **收敛重构**(删复杂度、固化概念、稳定接口、补文档)→ 可维护 --- -## 1. 感知与定义:如何看清真相 -*目标:在输入 prompt 之前,消除主观偏见与语境歧义。* +## 推荐底座(Python) -### 现象学还原 (Phenomenological Reduction) -* **方法**:**悬置假设**。不讨论“应该怎么做”,只记录“实际发生了什么”。 -* **Vibe 应用**:在描述 Bug 时,只提供原始日志、输入数据和观察到的输出,严禁带入“我觉得是某个函数坏了”的预设。 - -### 诠释学 (Hermeneutics) -* **方法**:**语境循环**。理解局部必须基于整体,理解整体必须基于局部。 -* **Vibe 应用**:让模型先复述需求并列出所有歧义点(术语定义、隐含前提),在达成语境一致后再编写代码。 - -### “钢人化”原则 (Steelmanning) -* **方法**:以最强版本的理解去反驳或改进。 -* **Vibe 应用**:在重构讨论时,要求模型:“先证明我现有方案的合理性,再提出一个能全面超越它的新方案。” +```text +ruff + black + pyright(或 mypy) + pytest + hypothesis + pydantic(msgspec可替代) +``` --- -## 2. 逻辑与精炼:如何深度推理 -*目标:提升模型的思考深度,追求最优解而非可行解。* +## 方法论 -### 苏格拉底式诘问 (Socratic Questioning) -* **方法**:连续追问。你凭什么?证据是什么?反例是什么? -* **Vibe 应用**:对模型的方案进行 5 层追问,特别是关于“性能开销”、“边界安全”和“失败降级”的底层逻辑。 +### 1. 现象学还原(悬置假设) -### 奥卡姆剃刀 (Occam's Razor) -* **方法**:若无必要,勿增实体。 -* **Vibe 应用**:让模型给出方案后,强制执行指令:“删掉 30% 复杂度,保持核心需求不变,优先选择无状态设计。” +**用途**:需求含糊、模型脑补、Bug难复现时,先把"解释/偏好"清零,回到可观察事实与可复现结构。 -### 贝叶斯认识论 (Bayesian Epistemology) -* **方法**:根据新证据动态更新信念。 -* **Vibe 应用**:将报错信息视为“新证据”,通过条件化更新(Conditionalization)修正 Prompt 策略,而非在错误的路径上死磕。 +**落地动作**: + +- 先写四件套:现象(实际) / 意图(期望) / 情境(环境约束) / 边界(明确不做) +- 输出最小可复现体 MRE:最小输入 + 最小脚本 + 复现步骤 + 预期vs实际 +- 把抽象词降维:快/稳/好用 → 指标&验收用例 + +**Python工具**:`pytest`(MRE脚本)、日志、最小数据样例 + +**提示词**: + +```text +先做现象学还原:不要推测原因。输出:现象/意图/情境/边界/未确定项/MRE;然后再给最小修复与测试。 +``` --- -## 3. 验证与纠偏:如何对抗幻觉 -*目标:建立科学的反馈回路,确保代码的确定性。* +### 2. 正反合(三段迭代) -### 波普尔式可证伪性 (Falsifiability) -* **方法**:不能被证伪的理论不是科学。 -* **Vibe 应用**:任何“看起来对”的代码都必须配一个能把它证明为错的测试用例。从“我认为正确”转变为“我暂时没能证伪”。 +**用途**:把一次性"写到完美"替换为可控三轮:快速可用 → 反例打脸 → 收敛为工程版本。 -### 反事实推理 (Counterfactual Thinking) -* **方法**:问“如果 X 不成立会怎样?” -* **Vibe 应用**:构建测试矩阵:如果网络超时?如果磁盘写满?如果 API 返回乱序?将反事实场景转化为容错分支。 +**落地动作**: -### 实验哲学 (Experimental Philosophy / x-phi) -* **方法**:用数据检验直觉。 -* **Vibe 应用**:不争论哪个 API 更好用,直接让模型生成 A/B 测试脚本,用 Benchmark 的客观数据做决策。 +- **正**:只做 main path,让它跑通 +- **反**:列失败模式(边界/空值/并发/权限/超时/性能),用测试与基准逼出反例 +- **合**:重构接口/收敛依赖/补文档与回归,形成下一轮稳定起点 + +**Python工具**:`pytest` + `hypothesis` + `ruff/black` + profiling/benchmark + +**提示词**: + +```text +按正反合输出:1)最小可运行实现 2)反例与失败模式+测试 3)综合后的重构方案与最终代码。 +``` --- -## 4. 系统与演进:如何全局决策 -*目标:在复杂工程中保持优雅,平衡速度与质量。* +### 3. 可证伪主义(波普尔) -### 系统论/整体论 (Systems Thinking) -* **方法**:关注边界、反馈与耦合。 -* **Vibe 应用**:让模型可视化数据流与依赖图,优先解耦高风险点,通过缩短反馈回路(如本地 Mock 环境)来加速 Vibe。 +**用途**:把"看起来对"变成"暂时无法证伪";显著降低隐藏 bug。 -### 辩证法的矛盾分析 -* **方法**:定位并解决主要矛盾。 -* **Vibe 应用**:当卡住时,分析是“需求不清”、“接口不稳”还是“反馈太慢”?先冻结次要矛盾,集中火力解决核心瓶颈。 +**落地动作**: -### 实用主义 (Pragmatism) -* **方法**:以效果为真理标准。 -* **Vibe 应用**:定义量化指标(P95 延迟、成本、交付时间)。每轮迭代只优化一个指标,避免过度工程。 +- 每个关键断言都要配一个能让它失败的测试(边界/随机/反例) +- 优先性质测试而非只写示例测试 -### 决策论 (Decision Theory) -* **方法**:区分可逆与不可逆决策。 -* **Vibe 应用**:要求模型标注:哪些修改是“易碎”的?哪些是“地基”?优先执行高价值且可逆的动作(MVP)。 +**Python工具**:`hypothesis`(性质/模糊)、`pytest` + +**提示词**: + +```text +为该实现列出 5 个可证伪点,并为每个点写一个最小测试(优先 Hypothesis 性质测试)。 +``` --- -## 5. 前沿认知工具:形式化与计算化 +### 4. 形式化方法(轻量形式化) -* **形式化方法 (Formal Methods)**:使用数学与模态逻辑精确化论证,使认识论问题可推演、可对比、可累积。 -* **计算哲学 (Computational Philosophy)**:用仿真与代理模型实例化哲学研究,将思维模型转化为可运行的代码实验。 -* **反思平衡 (Reflective Equilibrium)**:在具体判断、通用原则与背景理论之间反复校正,追求系统的一致性。 -* **概念工程 (Conceptual Engineering)**:不仅是澄清概念,更是主动改造和优化概念工具以服务于 Vibe Coding 实践。 +**用途**:减少非法状态、约束模型输出、让行为可检查可累积。 + +**落地动作**: + +- **先规格**:类型 + schema + 不变式 + 错误集合(异常或 error object)+ 复杂度约束(可选) +- **再检查器**:类型检查 + 运行时校验 + 断言/契约 + 性质测试 +- **最后实现**:逐条映射规格(谁保证哪条约束) + +**Python工具**: + +- `typing`(Literal/NewType/Protocol/TypedDict/Annotated) +- `pyright/mypy` +- `pydantic/msgspec`(输入输出校验) +- `assert` / `icontract` / `deal` +- `pytest` + `hypothesis` + +**提示词**: + +```text +先输出形式化规格(类型/schema/不变式/错误语义),再给至少 3 条 Hypothesis 性质测试,最后写实现并逐条说明满足关系。 +``` --- -*注:本模块内容将持续演进,作为 Vibe Coding CN 项目的最高思想纲领。* + +### 5. 奥卡姆剃刀(最小复杂度) + +**用途**:避免模型引入不必要框架/抽象;提升可维护性与迭代速度。 + +**落地动作**: + +- 要求两套方案:常规版 vs 简化版;以测试为准删复杂度 +- 优先标准库、减少依赖、减少可变状态、减少层级 + +**Python工具**:`ruff`(复杂度/风格)、依赖审计(requirements最小化) + +**提示词**: + +```text +在满足全部测试与验收的前提下,把实现复杂度删掉 30%:减少依赖、状态和抽象层,并解释删减理由。 +``` + +--- + +### 6. 实用主义(以指标为准) + +**用途**:避免"优化方向漂移";每轮明确一个可量化目标。 + +**落地动作**: + +- 先定义成功指标(P95延迟/错误率/成本/内存/可维护性) +- 每轮只优化一个指标;其余保持不退化(用基准/回归锁住) + +**Python工具**:`pytest-benchmark` 或简单计时;日志与指标;回归测试 + +**提示词**: + +```text +把需求转成指标与验收阈值,并给出测量方法;本轮只优化 X 指标,保证其它指标不退化。 +``` + +--- + +### 7. 系统论/整体论(边界与反馈回路) + +**用途**:复杂系统容易在耦合点失控;缩短反馈回路提效最大。 + +**落地动作**: + +- 先画数据流/依赖边界:I/O 放边缘,核心逻辑保持纯函数 +- 优先解耦高耦合点;把慢依赖换成桩/模拟以加速测试 + +**Python工具**:依赖注入(轻量)、`pytest fixtures`、纯函数设计 + +**提示词**: + +```text +画出数据流与依赖边界,指出最高耦合点与最短反馈回路改造方案;给出可测试的纯函数核心与 I/O 适配层。 +``` + +--- + +### 8. 诠释学(语境澄清) + +**用途**:需求文本有歧义,模型与人对同一词理解不同。 + +**落地动作**: + +- 先复述需求 + 歧义清单 + 默认选择(必须显式) +- 默认选择写入 docstring/README/类型定义 + +**Python工具**:docstring、类型与 schema 固化默认 + +**提示词**: + +```text +先复述需求并列出所有歧义点;对每个歧义给默认策略与理由;确认后再写实现与测试。 +``` + +--- + +### 9. "钢人化"原则(最强版本理解) + +**用途**:减少无效争论/误解;让重构建议更贴近原意图。 + +**落地动作**: + +- 先把现有方案表达成最强版本(目标、约束、权衡) +- 再提出改进(保留其优势,指出代价) + +**Python工具**:PR描述结构化(优点/风险/替代方案) + +**提示词**: + +```text +先钢人化现有实现:列出它的最佳解释与优点;再给改进方案并明确代价与风险。 +``` + +--- + +### 10. 决策论/机会成本(可逆优先) + +**用途**:避免过早做不可逆技术决策(换框架/改数据模型)。 + +**落地动作**: + +- 标注决策:可逆 vs 不可逆;优先做可逆高价值项 +- 先写接口+测试桩+适配层,延后绑定外部系统 + +**Python工具**:抽象边界、adapter、in-memory 实现 + +**提示词**: + +```text +把方案拆成可逆/不可逆决策;先给可逆路径的 MVP,实现通过测试;不可逆部分只给接口与占位实现。 +``` + +--- + +### 11. 反事实推理(Counterfactuals) + +**用途**:系统性覆盖异常路径,降低线上事故。 + +**落地动作**: + +- 问"如果 X 不成立会怎样":超时、乱序、重复、空值、弱网、权限缺失、时钟漂移 +- 把反事实转成测试矩阵与降级策略 + +**Python工具**:`pytest` 参数化、`hypothesis` 生成器、超时与重试控制 + +**提示词**: + +```text +列出 15 个反事实场景并按风险排序;为 Top5 写测试与降级/错误语义。 +``` + +--- + +### 12. 溯因推理(Abduction,最佳解释) + +**用途**:debug/性能退化时,比穷举更快定位"最可能原因"。 + +**落地动作**: + +- 列候选原因 → 为每个原因写最便宜的区分性实验(日志点/开关/最小基准) +- 用证据淘汰而不是凭感觉改代码 + +**Python工具**:结构化日志、trace、最小 benchmark、feature flag + +**提示词**: + +```text +给出候选原因列表,并为每个原因提供一个最低成本、最高区分度的验证实验与预期观察。 +``` + +--- + +### 13. 贝叶斯式信念更新(与溯因配合) + +**用途**:在不确定下理性分配排查时间。 + +**落地动作**: + +- 给假设先验(高/中/低)→ 实验后更新后验排序 +- 只对后验最高的 1-2 个假设投入修改成本 + +**Python工具**:同 12;加一张"假设-证据"表 + +**提示词**: + +```text +按先验排序原因;给最信息增益实验;根据可能结果更新排序并给下一步。 +``` + +--- + +### 14. 反思平衡(Reflective equilibrium) + +**用途**:当用例、原则、约束冲突时收敛规范(尤其 API 语义、错误处理、兼容性)。 + +**落地动作**: + +- 三层对齐:具体用例 ↔ 一般原则 ↔ 系统约束 +- 用测试固化:回归用例(具体判断)+ 性质测试(原则) + +**Python工具**:`pytest` + `hypothesis`;规范文档(错误模型/幂等语义) + +**提示词**: + +```text +列出用例/原则/约束三集,指出冲突点;给两轮调整方案,每轮说明要改哪些用例、原则或实现以达成一致。 +``` + +--- + +### 15. 概念分析 / 概念工程 + +**用途**:防止术语漂移导致返工;把领域概念固化进代码。 + +**落地动作**: + +- 概念表:术语/定义/边界/不变量/转换关系 +- 概念工程:用 Enum/Literal/NewType/dataclass(frozen) 与 schema 固化边界;禁止混用 + +**Python工具**:`Enum`、`Literal`、`NewType`、`pydantic` 校验 + +**提示词**: + +```text +先产出概念表;再映射成 Python 类型与 schema;给 5 个应被拒绝的反例输入,并写对应测试。 +``` + +--- + +### 16. 方法论怀疑(笛卡尔式) + +**用途**:把不可靠前提当事实是 vibe coding 常见事故源。 + +**落地动作**: + +- 对关键前提标注:是否可验证 +- 不可验证 → 必须加运行时校验/超时/重试/降级;并写会失败的测试 + +**Python工具**:`assert`/校验器、超时、重试、容错分支测试 + +**提示词**: + +```text +列出该方案依赖的所有前提,并标注可验证性;对不可验证前提添加防线(校验/超时/降级)与对应测试。 +``` + +--- + +### 17. 视角三角测量(Triangulation) + +**用途**:减少单一证据的误判;提升结论可靠性。 + +**落地动作**: + +- 同一结论至少两种证据:单测/性质测试 + 日志/指标;或差分测试 + fuzz + +**Python工具**:`pytest`/`hypothesis` + metrics/logging;差分对照 + +**提示词**: + +```text +对关键行为给出至少两种独立验证方式,并说明各自盲区与如何互补。 +``` + +--- + +### 18. 机制解释(Mechanistic explanation) + +**用途**:把"能跑"变成"可解释可维护";降低未来修改风险。 + +**落地动作**: + +- 要求输出数据流:输入 → 中间状态 → 输出 +- 对中间状态写不变式/断言;把解释与代码结构对齐 + +**Python工具**:`assert`、类型收窄、分层函数、docstring + +**提示词**: + +```text +给出机制解释:数据在系统中如何流动;列出每个中间状态的不变式,并在代码中用断言或类型保证。 +``` + +--- + +### 19. 错误认识论(Error epistemology) + +**用途**:系统化"我们会如何错",比事后补洞更省。 + +**落地动作**: + +- 先做失败模式清单(空值/乱序/重复/并发/权限/超时/编码/浮点等) +- 每类至少一个测试;明确错误语义(raise / error object / log+metric) + +**Python工具**:`pytest` 参数化 + `hypothesis`;统一 error 模型 + +**提示词**: + +```text +生成失败模式清单并按风险排序;为 Top N 写测试;统一错误模型并给出示例响应/异常层级。 +``` + +--- + +### 20. 实验哲学(x-phi) + +**用途**:交互与默认策略别靠直觉,用数据决定。 + +**落地动作**: + +- 把争议点改成可测实验(A/B 默认值、错误文案、重试策略) +- 指标:误用率、重试率、成功率、工单率、完成时间 + +**Python工具**:埋点/日志、简单 A/B 分组、配置开关 + +**提示词**: + +```text +把该设计争议转成实验:分组、指标、样本、持续时间、判定阈值;给出埋点字段与分析方法。 +``` + +--- + +### 21. 计算哲学(Computational philosophy) + +**用途**:复杂状态与规则用"可运行模型/仿真/搜索"代替纯讨论。 + +**落地动作**: + +- reference 实现(慢但清晰)作为 oracle +- optimized 实现(快/工程化)用差分测试锁死行为 +- 用仿真/生成器自动探索边界 + +**Python工具**:`hypothesis`、差分测试、状态机测试(Hypothesis stateful) + +**提示词**: + +```text +先写 reference(清晰)+ optimized(高效);写差分测试与状态机/性质测试自动找反例并修复。 +``` + +--- + +### 22. 自然化认识论(Naturalized epistemology) + +**用途**:承认人类/模型都有系统性偏误,用流程与工具把偏误外包给检查器。 + +**落地动作**: + +- 默认自动化:lint+format+类型检查+测试 +- 高风险路径:必须性质测试/模糊测试/运行时校验 +- 结论至少双证据(测试+指标) + +**Python工具**:`ruff`/`black`/`pyright`/`pytest`/`hypothesis`/`pydantic` + +**提示词**: + +```text +列出该任务最常见的误判点,并为每个误判点给一个自动化防线(检查器/测试/断言/埋点)。 +``` + +--- + +### 23. 贝叶斯认识论(Bayesian epistemology) + +**用途**:在多个方案/原因间理性分配注意力与试错预算。 + +**落地动作**: + +- 先验 → 实验 → 后验 → 下一步;把排查变成序列决策问题 + +**Python工具**:同 12/13;记录表 + +**提示词**: + +```text +用贝叶斯式流程组织排查:先验排序、信息增益最高的实验、更新后的行动计划。 +``` + +--- + +## 附录 + +### 通用"性质测试"提示(可复用) + +| 性质 | 说明 | +|:---|:---| +| 非负性/有界性 | 结果不越界 | +| 幂等性 | `f(f(x)) == f(x)` | +| 单调性 | 输入增大输出不违反预期 | +| 守恒性 | 长度/集合元素/总和按规则变化 | +| 互逆性 | `decode(encode(x)) == x`(或近似) | +| 稳定性 | 排序/去重等操作满足稳定条件 | +| 交换/结合 | 满足代数性质的操作应通过 | + +### 建议的项目骨架(最小) + +```text +src/ # 纯逻辑与 I/O 分离 +tests/ # 示例+性质+差分 +pyproject.toml # ruff/pytest/pyright +README.md # 概念表/错误语义/验收指标 +``` + +--- + +## 使用指南 + +| 场景 | 推荐方法组合 | +|:---|:---| +| 需求不清 | 1(现象学)+ 8(诠释学)+ 15(概念工程) | +| 质量不稳 | 3(可证伪)+ 4(形式化)+ 19(错误认识论) | +| 排错提效 | 12(溯因)+ 13/23(贝叶斯更新)+ 17(三角测量) | +| 复杂系统 | 7(系统论)+ 21(计算哲学)+ 14(反思平衡) | +| 交互默认争议 | 20(x-phi)+ 6(实用主义指标) |