From eb40ae29f20a6b562d9ee9fd079d8980ca168c71 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 3 May 2026 01:18:26 +0800 Subject: [PATCH] docs: remove merged philosophy source files --- docs/philosophy/README.md | 4 +- docs/philosophy/控制论与科学方法论.md | 45 ----------- docs/philosophy/现象学还原.md | 107 -------------------------- docs/philosophy/辩证法.md | 28 ------- metadata/redirects.yml | 6 ++ 5 files changed, 8 insertions(+), 182 deletions(-) delete mode 100644 docs/philosophy/控制论与科学方法论.md delete mode 100644 docs/philosophy/现象学还原.md delete mode 100644 docs/philosophy/辩证法.md diff --git a/docs/philosophy/README.md b/docs/philosophy/README.md index db273fc..702d62b 100644 --- a/docs/philosophy/README.md +++ b/docs/philosophy/README.md @@ -207,7 +207,7 @@ ruff + black + pyright(或 mypy) + pytest + hypothesis + pydantic(msgspec可替 **扩展阅读**： -- [`控制论与科学方法论`](控制论与科学方法论.md) - 用“可能性空间/反馈/信息/黑箱/可证伪”解释从试错到收敛的机制 +- [控制论与科学方法论](#控制论与科学方法论) - 用“可能性空间/反馈/信息/黑箱/可证伪”解释从试错到收敛的机制 --- @@ -552,7 +552,7 @@ README.md # 概念表/错误语义/验收指标 ## 来源文档整合补充 -本节合并 `现象学还原.md`、`辩证法.md` 与 `控制论与科学方法论.md` 的核心内容，源文件保留，便于独立阅读与追溯。 +本节合并原 `现象学还原.md`、`辩证法.md` 与 `控制论与科学方法论.md` 的核心内容，作为哲学方法论的统一入口。 ### 现象学还原用于 Vibe Coding diff --git a/docs/philosophy/控制论与科学方法论.md b/docs/philosophy/控制论与科学方法论.md deleted file mode 100644 index c5dad64..0000000 --- a/docs/philosophy/控制论与科学方法论.md +++ /dev/null @@ -1,45 +0,0 @@ -# 控制论与科学方法论 - -1. 一切控制行为的逻辑起点是被控对象存在一个由多种发展可能性构成的集合，即可能性空间，控制的本质就是通过选择手段，使该可能性空间朝向目标状态收缩 - -2. 人类改造世界的一切实践活动，包括创造自然界不存在的事物，其本质都是在多维度、多层次的可能性空间中进行的一系列选择，选择物质、选择条件、选择时机，最终将极小概率的组合实现为确定性的结果 - -3. 控制能力是一个可以被量化的物理量，定义为控制前后可能性空间大小之比（M/m），它揭示了任何工具或方法都存在一个固有的能力上限，超出此上限的控制目标无法通过简单重复操作达成 - -4. 负反馈是一种通过不断比较现状与目标的差距，并采取行动缩小该差距的机制，它的核心作用是将有限的单次控制能力进行累积性放大，从而实现远超单次能力上限的精确控制 - -5. 正反馈是一种自我增强的机制，其中系统的输出被反馈以放大其输入，导致状态持续偏离初始平衡点，这种机制是系统崩溃、恶性循环、爆炸性增长以及系统结构演化的根本动力 - -6. 信息不是物质或能量，而是对系统可能性空间认知状态的改变，信息的获得本质上是头脑中关于事物不确定性的减少，其量值（比特）是可能性空间收缩程度的对数度量 - -7. 控制与信息是同一过程的一体两面，控制的实现必须以获得足够的信息量为前提，而信息的传递本身就是通过一系列微观控制行为实现的，二者共同构成了知与行的统一体 - -8. 组织并非实体，而是一种结构状态，其形成过程是系统内各组成部分之间相互联系的可能性空间急剧缩小的过程，一个系统组织化程度的高低，等价于其结构中所包含的信息量的多少 - -9. 复杂系统内部的因果关系超越了线性链条，呈现为概率因果、互为因果（反馈环）和因果网络等多种形式，这导致系统内部的终极原因往往是循环的，而非指向某个外部的初始第一因 - -10. 由于因果关系的无限性和复杂性，任何有效的分析都必须通过建立“相对孤立系统”这一思想模型来人为地切断弱相关联系，从而将无限问题转化为有限问题进行研究 - -11. 拥有内部反馈回路的系统会自发地趋向于“稳态结构”，这是一种动态平衡状态，在此状态下，系统内部各组成部分的相互作用能够抵御外部的随机干扰，维持整体结构的稳定 - -12. 系统的演化，本质上是从一个旧的稳态结构被破坏，经过一个不稳定的过渡阶段，最终落入一个新的稳态结构的过程 - -13. “超稳定系统”是一种特殊的宏观稳定结构，它通过内部周期性的动荡和崩溃（不稳定）来释放积累的压力，并启动修复机制，从而在更长的时间尺度上维持其根本结构的稳定，中国封建社会的王朝循环是其典型范例 - -14. 自组织系统是在没有外部指令的情况下，由大量不稳定的子单元通过内部相互作用，从无序状态自发地涌现出宏观有序结构的过程，其发展的方向和最终形态对初始的“组织核心”的微小涨落极其敏感 - -15. 质变，即系统性质的根本改变，可以通过两种截然不同的方式实现：渐变（连续穿越一系列稳定的中间状态）与飞跃（由于原有稳定态消失而被迫穿越不稳定区域的突变） - -16. 决定质变方式是渐变还是飞跃的关键，并非变化速度的快慢，而是其所经过的中间状态是否稳定；不稳定的中间态意味着能量上的“山脊”，系统无法停留，只能快速“滚落”，形成飞跃 - -17. 系统所有可能的稳定性质都对应于其抽象势函数空间中的“洼地”，渐变是“洼地”本身平滑地移动或变形，而飞跃则是某个“洼地”突然变浅消失，导致系统状态“坠落”到另一个更深的“洼地”中 - -18. “矫枉必须过正”（滞后现象）是飞跃式质变的伴生现象，它源于系统从状态A到状态B的突变点，与从状态B回到状态A的突变点在控制参数上不重合，因此需要施加额外的反向作用才能跨越这个“滞后区域” - -19. 任何被认识的客体本质上都是一个其内部机制未知的“黑箱”，人类只能通过施加可控制的输入并观察其可观察的输出来构建关于其内部结构的“模型”（即理论或假说） - -20. 所谓认识过程，就是以“实践-理论-实践”的负反馈循环，不断比较模型预测与黑箱实际输出的差异，并依据此差异修正模型，以求无限逼近客观真实 - -21. 认识的负反馈循环能否收敛于真理，取决于多个刚性条件：理论必须具有可证伪性（清晰地提供信息），认识反馈的速度必须快于客体自身变化的速度，反馈调节的幅度不能过度，以及实践结果与理论真伪之间存在可靠的判别关系 - -22. 科学规律的本质是变量之间的约束关系，人类认识规律的过程，就是通过扩大控制能力，将原本不可控的随机变量，转变为在已知规律（约束）下可以预测和控制的确定性结果，从而将人类的控制边界向外延伸 diff --git a/docs/philosophy/现象学还原.md b/docs/philosophy/现象学还原.md deleted file mode 100644 index 00186fa..0000000 --- a/docs/philosophy/现象学还原.md +++ /dev/null @@ -1,107 +0,0 @@ -### 现象学还原（悬置假设）用于 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) 一句话口诀（便于放进工具箱卡片） - -**先悬置解释，再固定现象；先写验收标准，再让模型写实现。** diff --git a/docs/philosophy/辩证法.md b/docs/philosophy/辩证法.md deleted file mode 100644 index 67f93c8..0000000 --- a/docs/philosophy/辩证法.md +++ /dev/null @@ -1,28 +0,0 @@ -# 辩证法在 Vibe Coding 里的用法：正反合 - -把辩证法的“正反合”用到 Vibe Coding：我把每次写代码都当一轮“三段论”。 - -## 正：当前状态（先跑通） - -- 让模型按直觉快速给出“最顺的实现” -- 目标只有一个：尽快跑通主路径 - -## 反：审计与调优（再打脸） - -- 立刻站在“挑刺者”视角反驳它 -- 列出失败模式、边界条件、性能与安全隐患 -- 用测试、类型、lint、基准把反驳落地 - -## 合：根据审核修正（再收敛） - -- 把速度与约束合起来 -- 重构接口、收敛依赖、补齐测试与文档 -- 形成下一轮更稳定的起点 - -## 实践口诀 - -先顺写 → 再打脸 → 再收敛 - -## 一句话总结 - -Vibe 负责生成可能性，正反合负责把可能性变成工程确定性。 diff --git a/metadata/redirects.yml b/metadata/redirects.yml index 71048b5..77921b5 100644 --- a/metadata/redirects.yml +++ b/metadata/redirects.yml @@ -11,6 +11,12 @@ redirects: to: docs/philosophy/思维模型.md - from: docs/concepts/编程之道.md to: docs/philosophy/编程之道.md + - from: docs/philosophy/现象学还原.md + to: docs/philosophy/README.md + - from: docs/philosophy/辩证法.md + to: docs/philosophy/README.md + - from: docs/philosophy/控制论与科学方法论.md + to: docs/philosophy/README.md - from: docs/guides/playbook/ to: docs/README.md - from: docs/playbooks/