mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-17 21:08:05 +00:00
docs: add directory readmes and agent guides
This commit is contained in:
@@ -0,0 +1,39 @@
|
||||
# Concepts 目录 Agent 指南
|
||||
|
||||
## 目录职责
|
||||
|
||||
`docs/concepts/` 存放项目的核心概念与工程认知框架。
|
||||
|
||||
这里的文档回答:
|
||||
|
||||
- Vibe Coding 的基本概念是什么。
|
||||
- 新手如何定义问题、拆解问题和构建系统。
|
||||
- 工程方法如何从经验沉淀为可复用模型。
|
||||
|
||||
## 文件地图
|
||||
|
||||
```text
|
||||
concepts/
|
||||
├── README.md # 核心概念索引
|
||||
├── AGENTS.md # 本目录操作规则
|
||||
├── 拼好码.md # 复用优先与胶水原则
|
||||
├── 问题求解.md # 问题定义与求解框架
|
||||
├── 系统构建方法.md # 自顶向下、自底向上、分而治之
|
||||
├── 开发范式演进.md # 软件开发范式演进
|
||||
├── 语言层要素.md # 代码理解所需语言层要素
|
||||
└── 递归自优化系统.md # 递归自优化生成系统形式化
|
||||
```
|
||||
|
||||
## 修改规则
|
||||
|
||||
- 新增概念文档时,必须同步更新 `README.md`。
|
||||
- 重命名文件时,必须同步更新全仓链接和 `metadata/redirects.yml`。
|
||||
- 概念文档应优先使用稳定术语,避免同一概念多种叫法并存。
|
||||
- 不把一次性操作步骤放入本目录;操作型内容应放入 `docs/getting-started/`
|
||||
或 `docs/references/`。
|
||||
|
||||
## 质量要求
|
||||
|
||||
- 每个概念先说明它解决的问题。
|
||||
- 尽量给出使用场景、判断标准和简单例子。
|
||||
- 不确定的外部事实必须标注 TODO 或迁移到 `docs/research/`。
|
||||
Reference in New Issue
Block a user