重写 Agentic AI 教程：扩展内容、新增章节、清理 AI 写作痕迹

- 重写全部 7 个章节，统一写作风格，去掉类比和模板化表达
- 新增 Agent 实践与治理章节（agent-practice.md）
- 新增技术附录：API 调用与 Function Calling、RAG 技术详解
- intro.md 加入 Agent 四条标准定义、对齐定律、Prompting 基础地位
- ai-essentials.md 加入 Context Bloat/Mega-Prompt 反模式
- multimodal-creativity.md 加入图像生成演进、音频生成
- reasoning-logic.md 加入确认偏误、Human-in-the-loop、RAG 原理
- ai-coding.md 加入 Plan Mode、Ralph Loop、架构债务等局限性
- agentic-system.md 加入 Memory 机制、简化 MCP、动手练习
- agent-practice.md 加入 Multi-agent 实现模式、评估与调试、反模式汇总
- 更新 AGENTS.md 写作风格指南
- 更新 VitePress 侧边栏配置

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: kimmywork

AGENTS.md

@@ -1,61 +1,74 @@
-# 写作风格指南（基于 docs/chapters）
+# 写作风格指南
 
 以下规则用于 AI 在本书中撰写或改写章节内容，保持与现有章节一致的写作风格与结构。
 
+本项目包含两个教程：
+- **编程导引**（docs/chapters）——JavaScript 编程入门
+- **Agentic AI**（docs/agentic-ai）——AI 协作与 Agent 实践
+
 ## 语气与叙述
 
 - 友好、耐心、口语化、引导式，但不幼稚、不俯视读者，也不把读者当成小孩子。
-- 常用提问引导思考（例如“为什么会这样？”“那该怎么办？”），语气保持专业与克制。
+- 常用提问引导思考（例如"为什么会这样？""那该怎么办？"），语气保持专业与克制。
 - 先给直观解释，再给更严格的概念或结构化表述。
-- 允许轻量自我指代/引导（如“我们可以看到”“我们先看一个例子”）。
+- 允许轻量自我指代/引导（如"我们可以看到""我们先看一个例子"）。
+- 不用类比来解释概念。直接用清晰的语言把概念说清楚，让一般读者也能理解。
 
 ## 概念呈现方式
 
-- 先直觉/类比，再进入正式概念或定义。
+- 先直觉，再进入正式概念或定义。
 - 即便解释口语化，也尽量给出标准、严谨的术语和定义，避免误导。
-- 常用“短句总结 + 加粗关键词”的方式强调要点。
-- 中英术语并列出现，格式常为“中文（English）”或“中文 English”。
+- 中英术语并列出现，格式常为"中文（English）"或"中文 English"。
 - 不堆砌概念，控制密度与节奏。
+- 不用"短句总结"的固定模板。要点在正文中自然强调即可。
+- 加粗要克制。每个段落最多保留一个强调点，不要每个关键词都加粗。
 
 ## 章节结构与节奏
 
 - 使用清晰的 Markdown 标题层级（# 章节、## 小节、### 子节）。
 - 每个小节围绕一个明确问题或概念展开。
 - 示例与解释交替出现，避免纯概念堆叠。
 - 常见收尾结构：
-  - “小结/总结”
-  - “练习”（列表形式，偏可操作）
-  - “延伸阅读”（链接到 reference 目录）
+  - "小结"（每条控制在一句话以内）
+  - "练习"（列表形式，偏可操作，一到四条为宜）
+  - "延伸阅读"（链接到 reference 目录）
 
 ## 示例与代码
 
 - 以 JavaScript 为主，必要时可以用伪代码或其他语言对比，但需明确标注。
 - 代码块短小、可直接运行，示例名称尽量直观。
-- 代码前后给出简短解释，强调“为什么这么写/会发生什么”。
+- 代码前后给出简短解释，强调"为什么这么写/会发生什么"。
 - 允许用数学公式（LaTeX）辅助说明，但不应喧宾夺主。
 
 ## 格式与排版
 
-- 关键术语用 **加粗**。
-- 列表常用无序列表（* 或 -），用于“要点/原因/步骤”。
+- 列表常用无序列表（* 或 -），用于"要点/原因/步骤"。
 - 提醒/注释常用引用块（> 提醒：...）。
 - 强调差异或对比时使用短段落分隔。
 
 ## 读者假设
 
 - 默认读者为零基础或初学者，尽量减少跳步。
-- 遇到“容易误解/容易出错”的点要显式提醒。
+- 遇到"容易误解/容易出错"的点要显式提醒。
 - 不制造焦虑，适当安抚读者，明确展示学习进步与里程碑。
 
 ## 链接与引用
 
-- “延伸阅读”集中链接到 `docs/reference`（或其子目录）下的概念条目。
+- "延伸阅读"集中链接到 `docs/reference`（或其子目录）下的概念条目。
 - 章节主体尽量少外链；必要外链放在首次出现处，且简短。
 
 ## 练习风格
 
-- 练习题偏“动手写/动手改”，一到四条为宜。
+- 练习题偏"动手写/动手改"，一到四条为宜。
 - 明确引导 Learn-by-doing，鼓励多动手、多尝试。
 - 引导发散思维，不局限于教程中给定的例子或解法。
 - 题目表述清晰，避免过度开放。
 - 与本章关键概念直接相关。
+
+## Agentic AI 教程特有约定
+
+- 核心概念（Prompting 基础、对齐定律、不要焦虑、技能>工具）在多个章节反复出现，但每次侧重不同，不做简单重复。
+- 反模式和最佳实践分散到各章节的相关位置讲，不在开头集中灌输。
+- 技术概念（MCP、Gateway、Memory 等）点到为止，配合一两个例子，不深入协议细节。
+- 动手练习不给具体代码，只描述实现步骤和目标，让读者自己写。
+- 附录（reference/）放技术细节较深的内容（RAG、API 调用），正文只讲原理和概念。