mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-06 15:47:46 +00:00
tukuaiai
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# Philosophy 目录 Agent 指南
|
|
|
|
## 目录职责
|
|
|
|
`docs/philosophy/` 存放哲学方法论、思维模型、编程哲学与底层认知模型。
|
|
|
|
这里的文档回答：
|
|
|
|
- 如何建立可迁移的思维模型。
|
|
- 如何从哲学和系统视角理解工程问题。
|
|
- 如何用更底层的概念描述变化、关系和复杂度。
|
|
|
|
## 文件地图
|
|
|
|
```text
|
|
philosophy/
|
|
├── README.md # 线性总文档：思维模型、组合描述模型、编程之道、软件工程的朴素真理、方法论工具箱
|
|
└── AGENTS.md # 本目录操作规则
|
|
```
|
|
|
|
## 修改规则
|
|
|
|
- 继承 `docs/AGENTS.md` 的 README 结构契约：H1 后直接进入 `## 字多不看`，再按 `快速导航 -> 完整细粒度目录 -> 使用方式 -> 正文` 排列。
|
|
- 新增模型时，优先补到 `README.md` 的对应章节。
|
|
- 不再新增同级主题 `.md` 文件；如确需拆分，必须同步更新全仓链接和 `metadata/redirects.yml`。
|
|
- 哲学内容必须落到工程判断或认知工具，不写成纯概念堆叠。
|
|
- 重命名章节锚点时，必须同步更新全仓链接和 `metadata/redirects.yml`。
|
|
- 不在 README 正文中写 `和其他目录的边界` 或 `维护规则`；维护者规则只写本文件。
|
|
|
|
## 质量要求
|
|
|
|
- 每个模型说明适用场景和使用方法。
|
|
- 抽象概念应配工程例子或判断清单。
|
|
- 保持术语稳定，避免同一模型出现多个标题口径。
|
|
- 修改后必须运行 `make sync-doc-toc` 和 `make test`。
|