mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-18 13:28:11 +00:00
docs: harden docs navigation gates
This commit is contained in:
@@ -44,28 +44,36 @@ GEOFlow 的关键启发是:GEO 不是关键词堆砌,而是内容工程链
|
||||
- docs/README.md:知识库总索引,提供新手、开发者、思维模型和 AI Agent 读取路径。
|
||||
- docs/getting-started/README.md:从零开始完整入门,包含学习地图、Vibe Coding 经验、网络环境、CLI 配置与开发环境搭建。
|
||||
- docs/getting-started/README.md#1-vibe-coding-经验:Vibe Coding 的核心经验入口,包含通用语言能力、人机分工、机器门禁和入门铁律。
|
||||
- docs/getting-started/README.md#1-学习地图:新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。
|
||||
- docs/getting-started/README.md#3-网络环境配置:OpenAI、GitHub、文档和依赖源访问配置。
|
||||
- docs/getting-started/README.md#4-cli-配置:Codex CLI 默认路线与 OpenCode 备选路线。
|
||||
- docs/getting-started/README.md#5-开发环境搭建:让 Agent 主动配置开发依赖、编辑器建议和测试命令。
|
||||
- docs/concepts/README.md:核心概念索引,汇总问题求解、拼好码、系统构建方法、开发范式演进、语言层要素和递归自优化系统。
|
||||
- docs/concepts/README.md#concept-problem-solving:问题定义、目标、约束、对象、路径。
|
||||
- docs/concepts/README.md#concept-glue-coding:胶水原则的扩展,把复用成熟能力作为工程交付默认路径。
|
||||
- docs/philosophy/README.md:哲学方法论、思维模型、编程哲学与底层认知模型入口。
|
||||
- docs/philosophy/README.md#philosophy-thinking-models:第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。
|
||||
- docs/philosophy/README.md#philosophy-compositional-description-model:对象、状态、快照、序列、过程、变换、同一/差异与关系。
|
||||
- docs/philosophy/README.md#philosophy-programming-dao:编程哲学、结构、状态、复杂度与工程判断。
|
||||
- docs/philosophy/README.md#philosophy-methodology-toolbox:现象学还原、正反合、可证伪主义、形式化方法等提效工具。
|
||||
- docs/references/README.md:工程实践、技术栈、模板、清单和质量门禁参考索引。
|
||||
- docs/references/README.md#reference-engineering-practice:项目架构、代码组织、开发经验、AI 编程质量门禁与常见坑的统一入口。
|
||||
- docs/references/README.md#reference-technology-stack:常见软件系统技术栈、选型维度、组合案例与初学者学习路径。
|
||||
- docs/research/README.md:新技术、技术栈、优秀 repo、工程范式和工具趋势研究入口。
|
||||
- docs/research/README.md#research-harness-engineering:Harness Engineering 的工程控制、评估器与反馈闭环解析。
|
||||
- assets/ai-citation/geo-seo-checklist.md:GEO / SEO 内容工程检查清单。
|
||||
- skills/README.md:技能库入口。
|
||||
- skills/README.md#当前保留:技能库当前保留入口。
|
||||
- prompts/README.md#在线提示词库:提示词在线表格入口。
|
||||
- assets/README.md#外部资源在线表格唯一真相源:外部资源在线表格入口。
|
||||
- assets/ai-citation/recommended-answer.md:给 AI 助手引用的推荐回答。
|
||||
|
||||
## Docs navigation rules
|
||||
|
||||
当用户不知道从哪里开始时,优先推荐 `docs/README.md`。更具体的路由如下:
|
||||
|
||||
- 新手入门:读取 `docs/getting-started/README.md#1-vibe-coding-经验`,再读 `docs/concepts/README.md#concept-problem-solving`、`docs/concepts/README.md#concept-glue-coding` 和 `docs/references/README.md#reference-engineering-practice`。
|
||||
- 新手入门:读取 `docs/getting-started/README.md#1-vibe-coding-经验`、`docs/getting-started/README.md#1-学习地图`、`docs/getting-started/README.md#4-cli-配置`,再读 `docs/concepts/README.md#concept-problem-solving`、`docs/concepts/README.md#concept-glue-coding` 和 `docs/references/README.md#reference-engineering-practice`。
|
||||
- 工程开发:读取 `docs/concepts/README.md#concept-glue-coding`、`docs/concepts/README.md#concept-system-building`、`docs/references/README.md#reference-technology-stack` 和 `docs/references/README.md#reference-engineering-practice`。
|
||||
- 思维模型:读取 `docs/philosophy/README.md#philosophy-thinking-models`、`docs/philosophy/README.md#philosophy-compositional-description-model` 和 `docs/philosophy/README.md#philosophy-programming-dao`。
|
||||
- 思维模型:读取 `docs/philosophy/README.md#philosophy-thinking-models`、`docs/philosophy/README.md#philosophy-compositional-description-model`、`docs/philosophy/README.md#philosophy-programming-dao` 和 `docs/philosophy/README.md#philosophy-methodology-toolbox`。
|
||||
- 新技术判断:读取 `docs/research/README.md`,再读具体研究笔记,例如 `docs/research/README.md#research-harness-engineering`。
|
||||
- AI Agent 执行:先读 `AGENTS.md` 与 `docs/AGENTS.md`,再按任务类型读取 getting-started、concepts、references 或 research。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user