Files
vibe-coding-cn/docs/references/sources/00-intro.md
T
2026-05-05 00:47:53 +08:00

28 KiB
Raw Blame History

参考资料

references/ 是工程实践、技术栈、模板、清单、质量门禁和可复用经验的线性手册。

字多不看

生成规则:本文件由 docs/references/sources/ 按文件名顺序拼接生成;请修改源片段后运行 make sync-reference-readme,不要直接编辑总文档主体。

  • 本目录回答“具体工程怎么组织、怎么选技术、怎么设置硬门禁”。
  • 先看“工程实践”,获得项目架构、代码组织、开发经验、质量门禁和常见坑。
  • 再看“技术栈”,完成技术选型、组合案例判断和初学者学习路径设计。
  • 长文档优先走快速导航;需要完整索引时再展开细粒度目录。

快速导航

目标 直接跳转
新项目结构怎么搭 项目架构模板
AI 代码质量怎么卡住 AI 编程质量门禁与常见坑
系统提示词怎么写 系统提示词构建原则
强前置条件怎么约束 强前置条件约束
常见坑怎么排查 常见坑汇总
底层程序逻辑怎么审 底层程序逻辑设计与工程优化项
技术栈怎么选 如何选择技术栈
初学者先学什么 初学者应该学什么技术栈
完整细粒度目录(点击展开/收起)

细粒度目录

使用方式

  • 先从 工程实践 判断项目结构、代码组织、质量门禁和常见坑。
  • 再从 技术栈 判断技术选型、组合案例和学习路径。
  • 只查具体问题时,优先使用上方“快速导航”和细粒度目录。
  • 本 README 是生成文件;新增或调整正文时先改 docs/references/sources/

正文

和其他目录的边界

  • 检查清单、模板、质量门禁和经验类内容优先收敛到本 README 的工程实践部分。
  • 技术选型、技术栈组合和学习路径优先收敛到本 README 的技术栈部分。
  • 新技术、工具趋势、优秀 repo 解析先放入 research,形成稳定工程参考后再放入本目录。

维护规则

  • 本目录采用“线性总文档”结构,正文统一收敛到 README.md
  • 新增内容时优先追加到对应大章节,并同步补充快速导航或完整细粒度目录。
  • 不再新增同级主题 .md 文件;如确需拆分,必须同步更新全仓索引、AGENTS 与 metadata。
  • 目录内只保留 README.mdAGENTS.md