增加每章节 README 文件

2026-09-22 15:57:59 +08:00
parent 8e86665096
commit 9445061c76
49 changed files with 3815 additions and 6 deletions
@@ -0,0 +1,55 @@
+# 代码开发 Agent
+
+> 所属：阶段六 · 垂直领域 Agent 落地实践
+> 目标：掌握仓库级检索 / AST 分块 / 多文件读写 / 沙箱执行，能在真实代码库里改代码。
+
+---
+
+## 📌 学习目的
+
+掌握仓库级检索 / AST 分块 / 多文件读写 / 沙箱执行，能在真实代码库里改代码。
+
+## ✅ 学习要求（前置条件）
+
+已完成阶段四「03_rag_technique」+ 阶段三「02_langgraph_core」。
+
+## 📚 主要学习内容
+
+- 仓库级检索：全库建索引（按函数 / 类切块）
+- AST 分块：`ast` 模块按函数 / 类边界切
+- 多文件读写：diff 预览 + 限根目录
+- 长上下文管理：符号表常驻 + 按需拉取
+- 沙箱执行：Docker 隔离跑生成代码
+
+## 📖 对应 docs
+
+- 目录：[`docs/06-阶段六-垂直领域Agent落地实践/`](../../docs/06-阶段六-垂直领域Agent落地实践/)（按目录名里的 `第 X 篇` 对应）
+- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
+
+## 🛠️ 建议练习
+
+- [ ] 用 AST 把一个 Python 文件按函数切块
+- [ ] 实现一个仓库符号表（函数名 → 文件/行号）
+- [ ] 实现「定位 → 改 → 跑测试」三步 Agent
+
+## 🏁 完成后达成标准
+
+- [ ] 能用 AST 分块实现仓库级检索
+- [ ] 能管理多文件 diff 与根目录限制
+- [ ] 能在沙箱中安全执行 Agent 生成的代码
+
+---
+
+## 🚀 运行提示
+
+```bash
+# 激活根目录的虚拟环境
+cd /Users/jack/source/Demo/py/demo_python_agent
+source .venv/bin/activate   # 或直接用 uv run ...
+
+# 进入本章目录
+cd code/006_phase6_vertical_apps/01_coding_agent
+
+# 跑你的练习文件
+uv run python your_exercise.py
+```