docs: standardize docs readme blocks

This commit is contained in:
tukuaiai
2026-05-05 00:47:53 +08:00
parent 8f91e3b2a8
commit 6e3fffd541
7 changed files with 162 additions and 133 deletions
+18 -7
View File
@@ -5,13 +5,15 @@
> `philosophy/` 是哲学方法论、思维模型、编程哲学和底层认知模型的线性手册。
## 核心摘要
## 字多不看
- 本目录回答“为什么这样判断、如何减少幻觉、如何让复杂问题可描述、可推理、可验证”。
- 它保留可迁移的认知模型和方法论,不放一次性命令、工具清单或新技术观察
- 本 README 提供稳定锚点和细粒度目录,作为哲学方法论的统一入口
- 先用“思维模型”选择认知工具
- 再用“组合描述模型”把对象、状态、序列、过程和关系说清楚
- 需要工程判断时读“编程之道”。
- 需要提效方法时读“方法论工具箱”。
## 总目录
## 快速导航
1. [思维模型](#philosophy-thinking-models) - 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。
2. [组合描述模型](#philosophy-compositional-description-model) - 对象、状态、快照、序列、过程、变换、同一/差异与关系。
@@ -155,17 +157,26 @@
</details>
## 和其他目录的边界
## 使用方式
- 遇到复杂问题,先读 [思维模型](#philosophy-thinking-models),选择合适的分析工具。
- 需要把复杂对象拆清楚,读 [组合描述模型](#philosophy-compositional-description-model)。
- 需要判断代码、架构和复杂度,读 [编程之道](#philosophy-programming-dao)。
- 需要形成可复用方法,读 [方法论工具箱](#philosophy-methodology-toolbox)。
## 正文
### 和其他目录的边界
- `concepts/` 负责 Vibe Coding 核心概念和工程思想。
- `references/` 负责可执行的工程实践、技术栈、门禁和清单。
- `research/` 负责新技术、新 repo 和趋势判断。
- 本目录只保留能迁移到多个问题上的认知模型和方法论。
## 维护规则
### 维护规则
- 本目录采用“线性总文档”结构,正文统一收敛到 `README.md`
- 新增内容时优先追加到对应大章节,并同步补充总目录或细粒度目录。
- 新增内容时优先追加到对应大章节,并同步补充快速导航或完整细粒度目录。
- 不再新增同级主题 `.md` 文件;如确需拆分,必须同步更新全仓索引、AGENTS 与 metadata。
- 目录内只保留 `README.md``AGENTS.md`