docs: 更新文档和技能

2026-08-21 06:48:04 +00:00 · 2025-12-17 20:39:02 +08:00
parent 5b3bddb974
commit fedc55f74c
23 changed files with 956 additions and 346 deletions
@@ -14,6 +14,9 @@ i18n/zh/documents/
 │   ├── 02-开发环境搭建.md
 │   └── 03-IDE配置.md
 │
+├── 胶水编程/                    # 🧬 Glue Coding 革命性范式
+│   └── README.md
+│
 ├── 方法论与原则/
 │   ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
 │   ├── gluecoding.md
@@ -21,24 +24,34 @@ i18n/zh/documents/
 │   ├── 学习经验.md
 │   ├── 开发经验.md
 │   ├── 编程之道.md
-│   ├── 胶水编程.md
 │   └── 系统提示词构建原则.md
 │
 ├── 教程与指南/
 │   ├── auggie-mcp配置文档.md
 │   ├── LazyVim快捷键大全.md
 │   ├── tmux快捷键大全.md
-│   ├── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
-│   └── telegram-dev/
+│   └── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
 │
 ├── 模板与资源/
 │   ├── 代码组织.md
 │   ├── 工具集.md
 │   ├── 编程书籍推荐.md
-│   └── 通用项目架构模板.md
+│   ├── 通用项目架构模板.md
+│   └── memory-bank-template/
 │
-└── 项目实战经验/
-    └── telegram-dev/
+├── 外部资源聚合/                # 🔗 外部链接汇总
+│   ├── AI工具与平台/
+│   ├── GitHub精选仓库/
+│   ├── 提示词资源/
+│   ├── 开发工具/
+│   ├── 教程与课程/
+│   └── 社区与论坛/
+│
+└── 项目实战经验/                # 📁 实战案例
+    ├── fate-engine-dev/
+    ├── polymarket-dev/
+    ├── telegram-dev/
+    └── ...
 ```

 ## 文档分类
@@ -52,43 +65,57 @@ i18n/zh/documents/
 *   [02-开发环境搭建](./从零开始vibecoding/02-开发环境搭建.md) - 搭建开发环境（提示词版）
 *   [03-IDE配置](./从零开始vibecoding/03-IDE配置.md) - 配置 VS Code / Cursor / Windsurf

+### 🧬 胶水编程 (Glue Coding)
+
+**软件工程的圣杯与银弹。** 彻底解决 Vibe Coding 的幻觉、复杂性和门槛问题。
+
+*   [胶水编程介绍](./胶水编程/README.md) - 革命性编程范式
+
 ### 方法论与原则

 关于编程思想、开发哲学和项目核心原则的文档。

-*   `A Formalization of Recursive Self-Optimizing Generative Systems.md`
-*   `gluecoding.md`
-*   `vibe-coding-经验收集.md`
-*   `学习经验.md`
-*   `开发经验.md`
-*   `编程之道.md`
-*   `胶水编程.md`
-*   `系统提示词构建原则.md`
+*   `A Formalization of Recursive Self-Optimizing Generative Systems.md` - 递归自优化系统形式化
+*   `gluecoding.md` - 胶水编程理论
+*   `vibe-coding-经验收集.md` - 经验汇总
+*   `学习经验.md` - 学习心得
+*   `开发经验.md` - 开发实践
+*   `编程之道.md` - 编程哲学
+*   `系统提示词构建原则.md` - 提示词工程

 ### 教程与指南

 具体工具的配置、使用指南和操作教程。

-*   `auggie-mcp配置文档.md`
-*   `LazyVim快捷键大全.md`
-*   `tmux快捷键大全.md`
-*   `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md`
-*   `telegram-dev/`
+*   `auggie-mcp配置文档.md` - Augment MCP 配置
+*   `LazyVim快捷键大全.md` - LazyVim 快捷键
+*   `tmux快捷键大全.md` - tmux 快捷键
+*   `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md` - 远程开发

 ### 模板与资源

 可复用的项目模板、代码结构规范和资源列表。

-*   `代码组织.md`
-*   `工具集.md`
-*   `编程书籍推荐.md`
-*   `通用项目架构模板.md`
+*   `代码组织.md` - 代码组织规范
+*   `工具集.md` - 工具推荐
+*   `编程书籍推荐.md` - 书籍推荐
+*   `通用项目架构模板.md` - 项目模板
+*   `memory-bank-template/` - Memory Bank 模板

-### 项目实战经验
+### 🔗 外部资源聚合
+
+外部优质资源汇总，持续更新。
+
+*   [外部资源聚合](./外部资源聚合/README.md) - 总索引
+
+### 📁 项目实战经验

 实际项目开发中的经验总结和案例。

-*   `telegram-dev/` - Telegram Bot 开发经验
+*   [项目实战经验](./项目实战经验/README.md) - 总索引
+*   `fate-engine-dev/` - 命理引擎开发
+*   `polymarket-dev/` - Polymarket 数据分析
+*   `telegram-dev/` - Telegram Bot 开发

 ## 相关资源

@@ -0,0 +1,172 @@
+# 🧬 胶水编程 (Glue Coding)
+
+> **软件工程的圣杯与银弹——终于出现了。**
+
+---
+
+## 🚀 颠覆性宣言
+
+**胶水编程不是一种技术，而是一场革命。**
+
+它可能完美解决了 Vibe Coding 的三大致命缺陷：
+
+| 传统 Vibe Coding 的痛点 | 胶水编程的解法 |
+|:---|:---|
+| 🎭 **AI 幻觉** - 生成不存在的 API、错误的逻辑 | ✅ **零幻觉** - 只使用已验证的成熟代码 |
+| 🧩 **复杂性爆炸** - 项目越大越失控 | ✅ **复杂性归零** - 每个模块都是久经考验的轮子 |
+| 🎓 **门槛过高** - 需要深厚编程功底才能驾驭 AI | ✅ **门槛消失** - 你只需要描述"连接方式" |
+
+---
+
+## 💡 核心理念
+
+```
+传统编程：人写代码
+Vibe Coding：AI 写代码，人审代码
+胶水编程：AI 连接代码，人审连接
+```
+
+### 范式转移
+
+**从「生成」到「连接」的根本性转变：**
+
+- ❌ 不再让 AI 从零生成代码（幻觉的根源）
+- ❌ 不再重复造轮子（复杂性的根源）
+- ❌ 不再要求你理解每一行代码（门槛的根源）
+
+- ✅ 只复用成熟的、经过生产验证的开源项目
+- ✅ AI 的唯一职责：理解你的意图，将模块连接起来
+- ✅ 你的唯一职责：描述清楚「输入是什么，输出要什么」
+
+---
+
+## 🏗️ 架构哲学
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    你的业务需求                          │
+└─────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────┐
+│                   AI 胶水层 (Glue Layer)                 │
+│                                                         │
+│   "我理解你要做什么，让我把这些积木连起来"                  │
+│                                                         │
+└─────────────────────────────────────────────────────────┘
+                           │
+          ┌────────────────┼────────────────┐
+          ▼                ▼                ▼
+   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
+   │  成熟模块 A  │  │  成熟模块 B  │  │  成熟模块 C  │
+   │  (10万+ ⭐)  │  │  (生产验证)  │  │  (官方 SDK)  │
+   └─────────────┘  └─────────────┘  └─────────────┘
+```
+
+**实体 (Entity)**：成熟的开源项目、官方 SDK、久经考验的库
+**连接 (Link)**：AI 生成的胶水代码，负责数据流转和接口适配
+**功能 (Function)**：你描述的业务目标
+
+---
+
+## 🎯 为什么这是银弹？
+
+### 1. 幻觉问题 → 彻底消失
+
+AI 不再需要"发明"任何东西。它只需要：
+- 阅读模块 A 的文档
+- 阅读模块 B 的文档
+- 写出 A → B 的数据转换
+
+**这是 AI 最擅长的事情，也是最不容易出错的事情。**
+
+### 2. 复杂性问题 → 转嫁给社区
+
+每个模块背后都有：
+- 数千个 Issue 的讨论
+- 数百个贡献者的智慧
+- 数年的生产环境打磨
+
+**你不是在管理复杂性，你是在站在巨人的肩膀上。**
+
+### 3. 门槛问题 → 降到最低
+
+你不需要懂：
+- 底层实现原理
+- 最佳实践细节
+- 边界情况处理
+
+你只需要会说人话：
+> "我要把 Telegram 的消息，经过 GPT 处理，存到 PostgreSQL"
+
+**AI 会帮你找到最合适的轮子，然后把它们粘起来。**
+
+---
+
+## 📋 实践流程
+
+```
+1. 明确目标
+   └─→ "我要实现 XXX 功能"
+
+2. 寻找轮子
+   └─→ "有没有成熟的库/项目已经做过类似的事？"
+   └─→ 让 AI 帮你搜索、评估、推荐
+
+3. 理解接口
+   └─→ 把官方文档喂给 AI
+   └─→ AI 总结：输入是什么，输出是什么
+
+4. 描述连接
+   └─→ "A 的输出要变成 B 的输入"
+   └─→ AI 生成胶水代码
+
+5. 验证运行
+   └─→ 跑通 → 完成
+   └─→ 报错 → 把错误扔给 AI，继续粘
+```
+
+---
+
+## 🔥 经典案例
+
+### 案例：Polymarket 数据分析 Bot
+
+**需求**：实时获取 Polymarket 数据，分析后推送到 Telegram
+
+**传统做法**：从零写爬虫、写分析逻辑、写 Bot → 3000 行代码，2 周时间
+
+**胶水做法**：
+```
+轮子 1: polymarket-py (官方 SDK)
+轮子 2: pandas (数据分析)
+轮子 3: python-telegram-bot (消息推送)
+
+胶水代码: 50 行
+开发时间: 2 小时
+```
+
+---
+
+## 📚 延伸阅读
+
+- [胶水开发提示词](../../prompts/coding_prompts/胶水开发.md)
+- [项目实战：polymarket-dev](../项目实战经验/polymarket-dev/)
+
+---
+
+## 🎖️ 总结
+
+> **能抄不写，能连不造，能复用不原创。**
+
+胶水编程是 Vibe Coding 的终极进化形态。
+
+它不是偷懒，而是**工程智慧的最高体现**——
+
+用最少的原创代码，撬动最大的生产力。
+
+**这就是软件工程等待了 50 年的银弹。**
+
+---
+
+*"The best code is no code at all. The second best is glue code."*