vibe-coding-cn/docs/concepts/AGENTS.md

Concepts 目录 Agent 指南

目录职责

docs/concepts/ 存放项目的核心概念与工程认知框架。

这里的文档回答：

• Vibe Coding 的基本概念是什么。
• 新手如何定义问题、拆解问题和构建系统。
• 工程方法如何从经验沉淀为可复用模型。

文件地图

concepts/
├── README.md          # 核心概念索引
├── AGENTS.md          # 本目录操作规则
├── 拼好码.md          # 复用优先与胶水原则
├── 问题求解.md        # 问题定义与求解框架
├── 系统构建方法.md    # 自顶向下、自底向上、分而治之
├── 开发范式演进.md    # 软件开发范式演进
├── 语言层要素.md      # 代码理解所需语言层要素
└── 递归自优化系统.md  # 递归自优化生成系统形式化

修改规则

• 新增概念文档时，必须同步更新 README.md。
• 重命名文件时，必须同步更新全仓链接和 metadata/redirects.yml。
• 概念文档应优先使用稳定术语，避免同一概念多种叫法并存。
• 不把一次性操作步骤放入本目录；操作型内容应放入 docs/getting-started/ 或 docs/references/。

质量要求

• 每个概念先说明它解决的问题。
• 尽量给出使用场景、判断标准和简单例子。
• 不确定的外部事实必须标注 TODO 或迁移到 docs/research/。