docs: add 哲学与方法论 module to README and project structure

This commit is contained in:
tukuaiai 2026-01-10 19:10:52 +08:00
parent 3be6ecacbb
commit 132d3e6902
8 changed files with 339 additions and 12 deletions

View File

@ -150,9 +150,10 @@ git push
│ ├── README.md # 多语言索引
│ ├── zh/ # 中文主语料
│ │ ├── documents/ # 文档库
│ │ │ ├── 00-基础指南/ # 方法论与原则
│ │ │ ├── -01-哲学与方法论/ # 最高思想纲领与方法论
│ │ │ ├── 00-基础指南/ # 核心原则与底层逻辑
│ │ │ ├── 01-入门指南/ # 从零开始教程
│ │ │ ├── 02-方法论/ # 工具与技巧
│ │ │ ├── 02-方法论/ # 具体工具与技巧
│ │ │ ├── 03-实战/ # 项目实战案例
│ │ │ └── 04-资源/ # 外部资源聚合
│ │ ├── prompts/ # 提示词库
@ -280,7 +281,7 @@ bash backups/一键备份.sh
### Core Directories
- **`i18n/zh/prompts/`**: 核心提示词库00-元提示词、01-系统提示词、02-编程提示词、03-用户提示词)
- **`i18n/zh/skills/`**: 模块化技能库00-元技能、01-AI工具、02-数据库、03-加密货币、04-开发工具)
- **`i18n/zh/documents/`**: 知识库00-基础指南、01-入门指南、02-方法论、03-实战、04-资源)
- **`i18n/zh/documents/`**: 知识库(-01-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战、04-资源)
- **`libs/external/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`libs/external/chat-vault/`**: AI 聊天记录保存工具
- **`backups/`**: 备份脚本与存档

View File

@ -38,6 +38,7 @@
<!-- 资源直达 - 按重要性分组 -->
<!-- 🔴 核心理念 (红色系) -->
<p>
<a href="./i18n/zh/documents/-01-哲学与方法论/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
<a href="./i18n/zh/documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md"><img src="https://img.shields.io/badge/🧠_核心哲学-必读-crimson?style=for-the-badge" alt="核心哲学"></a>
<a href="./i18n/zh/documents/00-基础指南/胶水编程.md"><img src="https://img.shields.io/badge/🧬_胶水编程-银弹-red?style=for-the-badge" alt="胶水编程"></a>
<a href="./i18n/zh/documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md"><img src="https://img.shields.io/badge/🎨_Canvas白板-图形驱动-orange?style=for-the-badge" alt="Canvas白板驱动开发"></a>
@ -391,9 +392,10 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
│ ├── README.md # 多语言索引
│ ├── zh/ # 中文主语料
│ │ ├── documents/ # 文档库
│ │ │ ├── 00-基础指南/ # 方法论与原则
│ │ │ ├── -01-哲学与方法论/ # 最高思想纲领与方法论
│ │ │ ├── 00-基础指南/ # 核心原则与底层逻辑
│ │ │ ├── 01-入门指南/ # 从零开始教程
│ │ │ ├── 02-方法论/ # 工具与技巧
│ │ │ ├── 02-方法论/ # 具体工具与技巧
│ │ │ ├── 03-实战/ # 项目实战案例
│ │ │ └── 04-资源/ # 外部资源聚合
│ │ ├── prompts/ # 提示词库

View File

@ -0,0 +1,99 @@
# -01- Philosophy & Methodology: The Underlying Protocol of Vibe Coding
> **"Code is a projection of thought; philosophy is the operating system of thought."**
In the paradigm of Vibe Coding, we are no longer just "typists" but "architects of intention." This module transforms cross-disciplinary philosophical tools into executable engineering directives, aimed at eliminating cognitive friction in human-AI collaboration and enhancing the precision of intention delivery.
---
## Index
1. [Perception & Definition: Seeing the Truth](#1-perception--definition-seeing-the-truth)
2. [Logic & Refinement: Deep Reasoning](#2-logic--refinement-deep-reasoning)
3. [Verification & Correction: Countering Hallucinations](#3-verification--correction-countering-hallucinations)
4. [Systems & Evolution: Global Decision Making](#4-systems--evolution-global-decision-making)
5. [Frontier Cognitive Tools: Formalization & Computation](#5-frontier-cognitive-tools-formalization--computation)
---
## 1. Perception & Definition: Seeing the Truth
*Goal: Eliminate subjective bias and linguistic ambiguity before prompting.*
### Phenomenological Reduction
* **Method**: **Epoche (Suspension of Judgment)**. Describe "what is actually happening" rather than "what should happen."
* **Vibe App**: When describing bugs, provide raw logs and observed outputs; avoid injecting "I think it's this function" biases.
### Hermeneutics
* **Method**: **Hermeneutic Circle**. Understand the part through the whole and the whole through the part.
* **Vibe App**: Ask the model to restate requirements and list ambiguities before writing code.
### Steelmanning
* **Method**: Addressing the strongest possible version of an opponent's argument.
* **Vibe App**: In refactoring, ask: "Prove why my current solution is reasonable first, then propose a new one that surpasses it."
---
## 2. Logic & Refinement: Deep Reasoning
*Goal: Elevate the model's thinking depth towards optimal rather than just feasible solutions.*
### Socratic Questioning
* **Method**: Continuous inquiry. Why? What's the evidence? What's the counterexample?
* **Vibe App**: Use 5 layers of "Why" for model solutions, focusing on performance, edge cases, and graceful degradation.
### Occam's Razor
* **Method**: Entia non sunt multiplicanda praeter necessitatem (Entities should not be multiplied beyond necessity).
* **Vibe App**: Demand the model to "remove 30% complexity while keeping core requirements," favoring stateless designs.
### Bayesian Epistemology
* **Method**: Dynamically updating beliefs based on new evidence.
* **Vibe App**: Treat error logs as "new evidence" to update the prompt strategy via conditionalization, rather than repeating the same path.
---
## 3. Verification & Correction: Countering Hallucinations
*Goal: Establish scientific feedback loops to ensure code determinism.*
### Popperian Falsifiability
* **Method**: A theory that is not falsifiable is not scientific.
* **Vibe App**: Every "seemingly correct" code must have a test case that could prove it wrong. Shift from "I think it's right" to "I haven't falsified it yet."
### Counterfactual Thinking
* **Method**: Ask "What if X were not the case?"
* **Vibe App**: Build test matrices: What if the network times out? What if the disk is full? What if API returns are out of order?
### Experimental Philosophy (x-phi)
* **Method**: Using data to test intuitions.
* **Vibe App**: Don't argue over which API is better; generate A/B test scripts and let the benchmark data decide.
---
## 4. Systems & Evolution: Global Decision Making
*Goal: Maintain elegance in complex engineering, balancing speed and quality.*
### Systems Thinking / Holism
* **Method**: Focus on boundaries, feedback, and coupling.
* **Vibe App**: Visualize data flows and dependency graphs to decouple high-risk points and shorten feedback loops.
### Dialectical Contradiction Analysis
* **Method**: Identify and resolve the primary contradiction.
* **Vibe App**: When stuck, analyze if it's "unclear requirements," "unstable APIs," or "slow feedback." Resolve the core bottleneck first.
### Pragmatism
* **Method**: Truth is defined by its utility and effect.
* **Vibe App**: Define quantifiable metrics (P95 latency, cost, delivery time). Optimize one metric per iteration.
### Decision Theory
* **Method**: Distinguish between reversible and irreversible decisions.
* **Vibe App**: Label modifications as "fragile" or "foundational." Prioritize high-value, reversible actions (MVP).
---
## 5. Frontier Cognitive Tools: Formalization & Computation
* **Formal Methods**: Using math and modal logic to make epistemological problems computable and cumulative.
* **Computational Philosophy**: Using simulations and agent models to turn mental models into runnable experiments.
* **Reflective Equilibrium**: Iteratively calibrating specific judgments and general principles for systemic consistency.
* **Conceptual Engineering**: Actively engineering and optimizing conceptual tools to serve Vibe Coding practices.
---
*Note: This content evolves continuously as the supreme ideological directive of the Vibe Coding CN project.*

View File

@ -8,6 +8,7 @@
```
documents/
├── -01-philosophy-and-methodology/ # Supreme ideological directive
├── 00-fundamentals/ # Core concepts & principles
│ ├── Glue Coding.md
│ ├── Language Layer Elements.md
@ -47,6 +48,10 @@ documents/
## 🗂️ Categories
### -01-philosophy-and-methodology
Supreme ideological directive and epistemological tools:
- **Philosophy & Methodology** - The underlying protocol of Vibe Coding
### 00-fundamentals
Core concepts and methodology:
- **Glue Coding** - Revolutionary programming paradigm

View File

@ -0,0 +1,99 @@
# -01- 哲学与方法论Vibe Coding 的底层协议
> **“代码是思维的投影,哲学是思维的操作系统。”**
在 Vibe Coding 的范式中,我们不再仅仅是“打字员”,而是“意图的架构师”。本模块将跨学科的哲学工具转化为可执行的工程指令,旨在消除人机协作中的认知摩擦,提升意图传递的精确度。
---
## 目录索引
1. [感知与定义:如何看清真相](#1-感知与定义如何看清真相)
2. [逻辑与精炼:如何深度推理](#2-逻辑与精炼如何深度推理)
3. [验证与纠偏:如何对抗幻觉](#3-验证与纠偏如何对抗幻觉)
4. [系统与演进:如何全局决策](#4-系统与演进如何全局决策)
5. [前沿认知工具:形式化与计算化](#5-前沿认知工具形式化与计算化)
---
## 1. 感知与定义:如何看清真相
*目标:在输入 prompt 之前,消除主观偏见与语境歧义。*
### 现象学还原 (Phenomenological Reduction)
* **方法****悬置假设**。不讨论“应该怎么做”,只记录“实际发生了什么”。
* **Vibe 应用**:在描述 Bug 时,只提供原始日志、输入数据和观察到的输出,严禁带入“我觉得是某个函数坏了”的预设。
### 诠释学 (Hermeneutics)
* **方法****语境循环**。理解局部必须基于整体,理解整体必须基于局部。
* **Vibe 应用**:让模型先复述需求并列出所有歧义点(术语定义、隐含前提),在达成语境一致后再编写代码。
### “钢人化”原则 (Steelmanning)
* **方法**:以最强版本的理解去反驳或改进。
* **Vibe 应用**:在重构讨论时,要求模型:“先证明我现有方案的合理性,再提出一个能全面超越它的新方案。”
---
## 2. 逻辑与精炼:如何深度推理
*目标:提升模型的思考深度,追求最优解而非可行解。*
### 苏格拉底式诘问 (Socratic Questioning)
* **方法**:连续追问。你凭什么?证据是什么?反例是什么?
* **Vibe 应用**:对模型的方案进行 5 层追问,特别是关于“性能开销”、“边界安全”和“失败降级”的底层逻辑。
### 奥卡姆剃刀 (Occam's Razor)
* **方法**:若无必要,勿增实体。
* **Vibe 应用**:让模型给出方案后,强制执行指令:“删掉 30% 复杂度,保持核心需求不变,优先选择无状态设计。”
### 贝叶斯认识论 (Bayesian Epistemology)
* **方法**:根据新证据动态更新信念。
* **Vibe 应用**将报错信息视为“新证据”通过条件化更新Conditionalization修正 Prompt 策略,而非在错误的路径上死磕。
---
## 3. 验证与纠偏:如何对抗幻觉
*目标:建立科学的反馈回路,确保代码的确定性。*
### 波普尔式可证伪性 (Falsifiability)
* **方法**:不能被证伪的理论不是科学。
* **Vibe 应用**:任何“看起来对”的代码都必须配一个能把它证明为错的测试用例。从“我认为正确”转变为“我暂时没能证伪”。
### 反事实推理 (Counterfactual Thinking)
* **方法**:问“如果 X 不成立会怎样?”
* **Vibe 应用**:构建测试矩阵:如果网络超时?如果磁盘写满?如果 API 返回乱序?将反事实场景转化为容错分支。
### 实验哲学 (Experimental Philosophy / x-phi)
* **方法**:用数据检验直觉。
* **Vibe 应用**:不争论哪个 API 更好用,直接让模型生成 A/B 测试脚本,用 Benchmark 的客观数据做决策。
---
## 4. 系统与演进:如何全局决策
*目标:在复杂工程中保持优雅,平衡速度与质量。*
### 系统论/整体论 (Systems Thinking)
* **方法**:关注边界、反馈与耦合。
* **Vibe 应用**:让模型可视化数据流与依赖图,优先解耦高风险点,通过缩短反馈回路(如本地 Mock 环境)来加速 Vibe。
### 辩证法的矛盾分析
* **方法**:定位并解决主要矛盾。
* **Vibe 应用**:当卡住时,分析是“需求不清”、“接口不稳”还是“反馈太慢”?先冻结次要矛盾,集中火力解决核心瓶颈。
### 实用主义 (Pragmatism)
* **方法**:以效果为真理标准。
* **Vibe 应用**定义量化指标P95 延迟、成本、交付时间)。每轮迭代只优化一个指标,避免过度工程。
### 决策论 (Decision Theory)
* **方法**:区分可逆与不可逆决策。
* **Vibe 应用**要求模型标注哪些修改是“易碎”的哪些是“地基”优先执行高价值且可逆的动作MVP
---
## 5. 前沿认知工具:形式化与计算化
* **形式化方法 (Formal Methods)**:使用数学与模态逻辑精确化论证,使认识论问题可推演、可对比、可累积。
* **计算哲学 (Computational Philosophy)**:用仿真与代理模型实例化哲学研究,将思维模型转化为可运行的代码实验。
* **反思平衡 (Reflective Equilibrium)**:在具体判断、通用原则与背景理论之间反复校正,追求系统的一致性。
* **概念工程 (Conceptual Engineering)**:不仅是澄清概念,更是主动改造和优化概念工具以服务于 Vibe Coding 实践。
---
*注:本模块内容将持续演进,作为 Vibe Coding CN 项目的最高思想纲领。*

View File

@ -0,0 +1,107 @@
### 现象学还原(悬置假设)用于 vibe coding
**核心目的**
把“我以为需求是这样”从对话里剥离出去,只留下可观察、可复现、可检验的事实与体验结构,从而让模型在更少臆测的前提下产出可用代码。
---
## 1) 方法要点(在工程语境下怎么理解)
* **悬置epoché**:暂时不采纳任何“原因解释/业务推断/最佳实践偏好”。
只记录:发生了什么、期望是什么、约束是什么。
* **还原reduction**:把问题还原到“给定输入→经过过程→得到输出”的最小结构。
先不谈架构、模式、技术栈优雅与否。
* **意向性intentionality**:明确“这个功能是为谁、在什么情境下、要达成什么体验”。
不是“做个登录”,而是“用户在弱网下也能在 2 秒内完成登录并得到明确反馈”。
---
## 2) 适用场景
* 需求描述充满抽象词:快、稳定、像某某一样、智能、顺滑。
* 模型开始“自带设定”:自己补产品逻辑、乱选框架、擅自加复杂度。
* Bug 复现困难:偶发、环境相关、输入边界不清。
---
## 3) 操作流程(可直接照做)
### A. 先“清空解释”,只保留现象
用四件套描述:
1. **现象**:实际发生的结果(含报错/截图/日志片段)。
2. **意图**:我想要的结果(可观察标准)。
3. **情境**:环境与前置条件(版本、平台、网络、权限、数据规模)。
4. **边界**:哪些不需要做/不要假设(不改接口、不引入新依赖、不改数据库结构等)。
### B. 产出“最小可复现体”MRE
* 最小输入样例(最短 JSON/最小表/最小请求)
* 最小代码片段(去掉无关模块)
* 明确复现步骤1、2、3
* 预期 vs 实际(对照表)
### C. 把“抽象词”降维成可测指标
* “快”→ P95 延迟 < X冷启动 < Y吞吐 >= Z
* “稳定”→ 错误率 < 0.1%重试策略熔断条件
* “好用”→ 交互反馈、错误文案、可撤销/可恢复
---
## 4) 给模型的提示词模板(可直接复制)
**模板 1还原问题禁止脑补**
```
请先做“现象学还原”:不要推测原因、不要引入额外功能。
只根据我给的信息,输出:
1) 现象(可观察事实)
2) 意图(我想要的可观察结果)
3) 情境(环境/约束)
4) 未确定项(必须问清或需要我补的最小信息)
5) 最小可复现步骤MRE
然后再给出最小修复方案与对应测试。
```
**模板 2抽象需求变可测规格**
```
把下面需求做“悬置假设”处理:删掉所有抽象词,转成可验证规格:
- 明确输入/输出
- 明确成功/失败判定
- 明确性能/资源指标(如需要)
- 明确不做什么
最后给出验收用例列表。
需求:<粘贴>
```
---
## 5) 在 vibe coding 的具体落地方式(习惯化)
* **每次开工先写“现象卡片”**2 分钟):现象/意图/情境/边界。
* **先让模型复述**:要求它只复述事实与缺口,不许给方案。
* **再进入生成**:方案必须绑定到“可观察验收”与“可证伪测试”。
---
## 6) 常见陷阱与对策
* **陷阱:把解释当事实**(“可能是缓存导致”)
对策:把“可能”移到“假设列表”,每条假设配验证步骤。
* **陷阱:需求用形容词堆叠**
对策:强制转成指标与用例;不满足“可测”不让写代码。
* **陷阱:模型自选技术栈**
对策:边界里写死:语言/框架/依赖/接口不可变。
---
## 7) 一句话口诀(便于放进工具箱卡片)
**先悬置解释,再固定现象;先写验收标准,再让模型写实现。**

View File

@ -0,0 +1,11 @@
把辩证法的正反合用到 vibe coding我把每次写代码都当一轮“三段论”
正(当前状态):先让模型按直觉快速给出“最顺的实现”,目标只有一个:尽快跑通主路径
反(审计与调优):立刻站在“挑刺者”视角反驳它:列失败模式/边界条件/性能与安全隐患并用测试、类型、lint、基准把反驳落地
合(根据审核计修正):把速度与约束合起来:重构接口、收敛依赖、补齐测试与文档,形成下一轮更稳定的起点
实践口诀:先顺写 → 再打脸 → 再收敛
vibe 负责生成可能性,正反合负责把可能性变成工程确定

View File

@ -6,17 +6,19 @@
```
documents/
├── 00-基础指南/ # 核心理念,胶水编程,方法论
├── 01-入门指南/ # 从零开始,环境配置
├── 02-方法论/ # 工具教程,开发经验
├── 03-实战/ # 项目实战经验
└── 04-资源/ # 模板,工具,外部资源
├── -01-哲学与方法论/ # 最高思想纲领,底层逻辑
├── 00-基础指南/ # 核心理念,胶水编程,方法论
├── 01-入门指南/ # 从零开始,环境配置
├── 02-方法论/ # 工具教程,开发经验
├── 03-实战/ # 项目实战经验
└── 04-资源/ # 模板,工具,外部资源
```
## 🚀 快速导航
| 目录 | 说明 | 适合人群 |
|:---|:---|:---|
| [-01-哲学与方法论](./-01-哲学与方法论/) | 思想纲领、认识论工具 | 架构师与深度开发者 |
| [00-基础指南](./00-基础指南/) | 胶水编程、核心理念 | 理解本质 |
| [01-入门指南](./01-入门指南/) | 环境配置、从零开始 | 新手入门 |
| [02-方法论](./02-方法论/) | 工具教程、开发经验 | 提升效率 |
@ -25,8 +27,9 @@ documents/
## 📖 推荐学习路径
1. **理念** → [胶水编程](./00-基础指南/胶水编程.md)
2. **入门** → [Vibe Coding 哲学原理](./01-入门指南/00-Vibe%20Coding%20哲学原理.md)
1. **思维** → [-01-哲学与方法论](./-01-哲学与方法论/README.md)
2. **理念** → [胶水编程](./00-基础指南/胶水编程.md)
3. **入门** → [Vibe Coding 哲学原理](./01-入门指南/00-Vibe%20Coding%20哲学原理.md)
3. **配置** → [开发环境搭建](./01-入门指南/02-开发环境搭建.md)
4. **工具** → [tmux 快捷键](./02-方法论/tmux快捷键大全.md)
5. **实践** → [项目实战经验](./03-实战/)