基于Claude code的“上下文工程”实践来了！

推荐语

基于Claude Code的"上下文工程"实践指南：让AI编程助手真正可用，首次写出可用代码概率提升10倍！

核心内容：
1. 上下文工程五大关键步骤详解：从搭建框架到执行开发
2. 与传统提示词工程的本质区别：从猜谜语到提供完整开发工具包
3. 实际案例展示：如何让AI高效完成爬虫等编程任务

杨芳贤

53AI创始人/腾讯云(TVP)最具价值专家

“上下文工程”最近真的挺火的，两周前发了一篇概念普及文章，怎么理解PE（提示词工程）应该改名为“上下文工程”？估计大多数人看了都没啥体感，感觉无非又是AI圈造了个新词儿。

这玩意是概念炒作还是真的趋势呢？我个人的判断：绝对是趋势。 

不要纠结叫什么，那都不重要，重要的是要尝试去理解到底是什么（What），怎么做（How）。

最近有个基于Claude Code的开源项目叫context-engineering-intro（文末点击原文可直达）。

这个项目介绍的"上下文工程"（Context Engineering）本质上是一套让AI编程助手真正能用的方法论，核心思想是：

整个流程可以拆解为5个关键步骤：

1. 搭框架（CLAUDE.md）

相当于给AI定公司规章制度。比如代码必须怎么写（缩进用空格还是Tab）、测试要覆盖多少、文档必须包含哪些内容。这个文件就是AI的"员工手册"，每次干活都会自动遵守这些规则。 

这个claude.md文件是通过CC的/init命令自动生成的，CC会扫描整个仓库，最后生成一份精要的项目开发指南和原则手册。后续的所有命令都会默认把这个文件注入在上下文中。

2.写需求（INITIAL.md）

不是简单说"做个网站"，而要像专业产品需求文档那样写清楚：用什么技术栈（比如React+Python）、要对接哪些API、性能要求（支持1000人同时访问）、参考哪些现有代码（examples/里的案例）。就像给程序员的需求文档越详细，成品越符合预期。

3.生成PRP蓝图

用/generate-prp命令让AI自己把需求文档转化成超级详细的施工图（PRP文件）。这个文件会包含：分几步开发、每步要写哪些文件、怎么验证代码是否正确、遇到错误怎么处理。相当于AI自己做了个项目管理甘特图。

4.执行开发

用/execute-prp命令让AI照着蓝图写代码。关键的是AI会边写边自查：写完一个功能就自动跑测试，失败了会自己debug，直到全部通过为止。就像有个程序员在持续集成环境里开发。

5.案例库支撑（examples/）

项目强调要在examples文件夹放大量样例代码，比如"正确的错误处理长什么样"、"API该怎么调用"。AI会像新人学习老员工的代码一样，直接模仿这些案例的风格和模式。

这种方法的突破性在于：传统prompt engineering像猜谜语（不断调整指令 wording），而上下文工程是给AI装备完整的"开发工具包"。实验证明，配上详细案例和规则的AI助手，第一次就能写出可用代码的概率能提高10倍以上。

举个实际例子：要让AI写个爬虫，传统方法是不断修改prompt"用Python爬数据存数据库"；上下文工程则是：

1. 在CLAUDE.md定义必须用异步编程 

2. 在examples放现成的防封禁爬虫案例 

3. 在INITIAL.md指定要爬哪些网站、存PG数据库的哪个表 

4. 生成PRP后AI会自动处理验证码、限速等问题。

今天亲测了一把，写了一个复杂的爬虫和把爬下来的数据封装成稳定可靠的查询api的需求。

按照上述流程，CC自迭代了20分钟，耗费了我Pro会员一半的用量，完成了所有需求，一次跑通。因为有了生成PRP的过程，在实施之前，我检验了设计是否符合预期，再对文档稍作了一些修改。

CC最后交付的结果质量非常高，预期满足率>95%。所有的代码抽象，接口封装，以及缓存设计，可靠性设计都非常符合预期，比我写的牛x多了。

这算是最近看到的一个最有画面感的“上下文工程”案例了，其实本质就是在让AI干一件复杂的事情之前，把你脑子里的预期和认知，用文字提前表达清楚，通AI工具辅助补充完整。形成一套“Workflow”，里面包含了精心调优过的Prompt（自定义command）。 

延展一下就是，每一个Repo，每一个场景都可以借助这套范式，通过持续的调优，定义出最符合，效果最好的“上下文工程”资产。 

大家可以实践起来，没有CC，用Gemini Cli、Cursor也同样可以干。