mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-13 02:48:05 +00:00
docs: standardize docs readme blocks
This commit is contained in:
@@ -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`。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user