Jason Zhou 分享了如何通过“上下文工程”（Context Engineering）和完善的文档系统，让 Claude Code 在复杂代码库中的表现提升10倍，干货满满，值得深度学习：1. 上下文工程是关键 Claude Code 默认接收系统提示（System prompt）、系统工具、MCP工具、CLAUDE.md文档和消息

Jason Zhou 分享了如何通过“上下文工程”（Context Engineering）和完善的文档系统，让 Claude Code 在复杂代码库中的表现提升10倍，干货满满，值得深度学习：

1. 上下文工程是关键
Claude Code 默认接收系统提示（System prompt）、系统工具、MCP工具、CLAUDE.md文档和消息。使用 /context 指令可以查看上下文结构，合理设计上下文能极大提升代码智能生成质量。

2. 子代理（Sub-agent）管理上下文
子代理适合只读任务（如调研），能将大量信息浓缩成关键摘要，帮助主代理聚焦核心内容，避免上下文爆炸。

3. 高效的文档系统至关重要
Jason推荐建立 .agent 文件夹，包含：
- System：项目结构、技术栈、数据库模式、关键模块
- SOP：常见错误及最佳实践流程
- Tasks：产品需求文档（PRD）
- README：文档总目录，支持管理大型代码库

这个结构借鉴了 Manus 的本地缓存上下文卸载思路，能处理复杂项目。

4. 自动更新文档
设计 /update-doc 命令，代理每完成关键功能或修正错误后自动更新文档，保持知识库与代码同步，防止“上下文漂移”。

5. 实践案例：管理遗留代码库
@ODMtweets 分享了用类似方法管理基于 WordPress 的大规模遗留代码库。为每个类生成文档，并配合定制代理模式，显著提升了代理对旧代码的理解和操作效率。

上下文工程改变游戏规则：合理设计上下文不仅提升效率，还能让初级开发者产出接近资深水平。
- 文档驱动开发（DDD）落地：结合PRD和细化任务计划，让AI协助代码实现与评审，形成闭环。
- 防止提示漂移：保持文档即时更新和子代理分工，避免上下文信息丢失或偏离目标。
- 成本与收益权衡：更智能的上下文管理虽增加计算成本，但带来的开发效率提升远超投入。