fix: add placeholder docs for 21 missing files referenced in README

adongwanai · adongwanai · commit 1f50ed01750c · 2026-05-24T00:39:01.000+08:00
README.md referenced 21 doc files that never existed, causing 404s on GitHub.
Created placeholder markdown files with 🚧 'coming soon' notices for:
- docs/01-theory/: 7 files (01-09)
- docs/02-tech-stack/: 8 files (frameworks, RAG, RL, etc.)
- docs/03-practice/: 3 files (RAG, security, graduation)
- docs/04-interview/: 3 files (career, resume, storytelling)
diff --git a/docs/01-theory/01-what-is-agent.md b/docs/01-theory/01-what-is-agent.md
@@ -0,0 +1,11 @@
+# 什么是 AI Agent？
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 AI Agent 的定义、分级体系（L1-L5）、以及与传统软件的核心区别。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/01-theory/02-agent-history.md b/docs/01-theory/02-agent-history.md
@@ -0,0 +1,11 @@
+# Agent 技术演进史
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将梳理从符号主义到 LLM 驱动 Agent 的技术演进历程。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/01-theory/03-transformer.md b/docs/01-theory/03-transformer.md
@@ -0,0 +1,11 @@
+# Transformer 架构详解
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将深入讲解 Self-Attention、位置编码、多头注意力等核心机制。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/01-theory/04-react-framework.md b/docs/01-theory/04-react-framework.md
@@ -0,0 +1,11 @@
+# 手撕 ReAct 框架
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 ReAct（Reasoning + Acting）框架的原理与实现方法。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/01-theory/05-cot-and-planning.md b/docs/01-theory/05-cot-and-planning.md
@@ -0,0 +1,11 @@
+# Chain-of-Thought 与规划
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将讲解 CoT 推理、任务规划与分解策略。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/01-theory/08-agent-bench.md b/docs/01-theory/08-agent-bench.md
@@ -0,0 +1,11 @@
+# AgentBench 详解
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 Agent 评测基准、多维度能力评估方法。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/01-theory/09-evaluation-metrics.md b/docs/01-theory/09-evaluation-metrics.md
@@ -0,0 +1,11 @@
+# Agent 评估指标体系
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍科学评估 Agent 系统的指标与方法论。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/04-langchain-guide.md b/docs/02-tech-stack/04-langchain-guide.md
@@ -0,0 +1,11 @@
+# LangChain 框架指南
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 LangChain 核心概念、组件与实战用法。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/06-multi-agent-frameworks.md b/docs/02-tech-stack/06-multi-agent-frameworks.md
@@ -0,0 +1,11 @@
+# Multi-Agent 框架详解
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将对比 AutoGen、CrewAI、Swarm 等多智能体框架的设计理念与适用场景。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/07-agentscope.md b/docs/02-tech-stack/07-agentscope.md
@@ -0,0 +1,11 @@
+# AgentScope 入门
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍阿里开源 AgentScope 框架的使用指南。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/08-vector-db-basics.md b/docs/02-tech-stack/08-vector-db-basics.md
@@ -0,0 +1,11 @@
+# 向量数据库基础
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 Milvus、Chroma、Qdrant 等向量数据库的选型与使用方法。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/14-mcp-protocol.md b/docs/02-tech-stack/14-mcp-protocol.md
@@ -0,0 +1,11 @@
+# MCP 协议详解
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 Model Context Protocol 的原理与实践。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/20-rag-full-pipeline.md b/docs/02-tech-stack/20-rag-full-pipeline.md
@@ -0,0 +1,11 @@
+# RAG 全链路实战
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍从文档解析到检索增强生成的完整管线搭建。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/21-agent-reinforcement-learning.md b/docs/02-tech-stack/21-agent-reinforcement-learning.md
@@ -0,0 +1,11 @@
+# Agent 强化学习
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 PPO、DPO、GRPO 在 Agent 训练中的应用。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/02-tech-stack/22-build-your-agent-framework.md b/docs/02-tech-stack/22-build-your-agent-framework.md
@@ -0,0 +1,11 @@
+# 从零构建 Agent 框架
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将手把手教你手撕一个最小可用的 Agent 框架。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/03-practice/02-high-availability-rag.md b/docs/03-practice/02-high-availability-rag.md
@@ -0,0 +1,11 @@
+# 高可用 RAG 系统实战
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍生产级 RAG 系统的架构设计与优化策略。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/03-practice/03-agent-security.md b/docs/03-practice/03-agent-security.md
@@ -0,0 +1,11 @@
+# Agent 安全防护
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 Prompt 注入防护、权限控制、安全最佳实践。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/03-practice/04-graduation-project.md b/docs/03-practice/04-graduation-project.md
@@ -0,0 +1,11 @@
+# 毕业设计选题指南
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将提供 AI Agent 方向毕业设计选题建议与实施路径。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/04-interview/06-career-transition.md b/docs/04-interview/06-career-transition.md
@@ -0,0 +1,11 @@
+# 转行攻略
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍非科班转行大模型方向的完整路径规划。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/04-interview/12-resume-guide.md b/docs/04-interview/12-resume-guide.md
@@ -0,0 +1,11 @@
+# 简历撰写指南
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 AI 方向简历优化、项目描述技巧。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
diff --git a/docs/04-interview/13-storytelling.md b/docs/04-interview/13-storytelling.md
@@ -0,0 +1,11 @@
+# 面试讲故事技巧
+
+> 🚧 本文档正在编写中，敬请期待...
+
+## 概述
+
+本文将介绍 STAR 法则、项目经历表达与亮点提炼技巧。
+
+---
+
+*如果你希望贡献此文档，欢迎提交 PR！*
