Files
vibe-coding-cn/docs/references/sources/00-intro.md
T
2026-05-04 05:01:12 +08:00

28 KiB
Raw Blame History

参考资料

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

核心摘要

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

  • 本目录回答“具体工程怎么组织、怎么选技术、怎么设置硬门禁”。
  • 它承载稳定、可执行、可检查、可复用的工程参考资料。
  • 本 README 提供稳定锚点和细粒度目录,作为工程参考资料的统一入口。

常用入口

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

总目录

  1. 工程实践 - 项目架构、代码组织、开发经验、质量门禁与常见坑。
  2. 技术栈 - 技术栈选型、组合案例与学习路径。

折叠块语法

长目录统一使用 details + summary,常用入口放在折叠块外,完整细粒度目录放在折叠块内。

<details>
<summary><strong>完整细粒度目录(点击展开/收起)</strong></summary>

### 细粒度目录

- [章节](#stable-anchor)

</details>
完整细粒度目录(点击展开/收起)

细粒度目录

和其他目录的边界

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

维护规则

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