上下文工程替代提示词工程：Claude Code编程效率提升指南

从提示词工程到上下文工程：AI编程的范式转变

随着 Claude Code 1.0.5E 版本的发布（已原生支持 Windows 系统，无需 WSL），越来越多的开发者开始使用这款 AI 编程工具。然而，大多数用户仍然沿用传统的提示词工程（Prompt Engineering）方式——像使用聊天机器人一样，输入任务描述，然后等待 AI 生成代码。

这种方式存在明显的局限性：提示词所能承载的有效信息非常有限，开发者需要反复斟酌措辞和句式，AI 却依然无法获取足够的上下文信息，导致生成的代码偏离需求、bug 频出。

上下文工程（Context Engineering） 正是为了解决这一痛点而诞生的新范式。它不再纠结于"怎么提问"，而是为 AI 提供完整的、体系化的上下文——包括项目文档、代码示例、编码规则、开发模式和验证机制。让 AI 真正理解"需要开发什么"以及"需要用到哪些技术栈和框架"。

大多数 AI 编程智能体无法有效完成复杂任务，主要原因不是模型能力不足，而是上下文缺失。

Context Engineering 开源项目解析

为了降低上下文工程的使用门槛，一个名为 Context Engineering 的开源项目应运而生，目前已获得超过 5000 Star。即使完全没有编程经验的用户，也能借助这个项目在 Claude Code 中进行复杂项目的开发。

项目核心文件结构

该项目包含几个关键文件和目录：

• claude.md：全局规则文件，定义项目认知、代码风格、安全合规等全局性约束
• initial.md：初始功能需求文件，描述要开发的产品功能和技术要求
• PRP/ 文件夹：存放产品需求提示（Product Requirement Prompt），相当于产品需求文档 + 精选代码 + 技术文档的综合体
• examples/ 文件夹：放置参考代码，让 Claude Code 理解代码结构和风格

这种结构化的上下文组织方式，让 AI 能够遵循项目结构和用户的编码习惯，支持多步骤的功能开发，并且能够自行发现和修复错误。

实战演示：用上下文工程开发 AI 智能体

下面通过一个完整案例，展示如何使用上下文工程在 Claude Code 中，基于微软开源的 AutoGen 智能体框架，从零开发一款代码生成 AI 智能体。

第一步：准备上下文材料

首先需要收集两类关键材料：

1. 官方文档：AutoGen 的官方技术文档
2. 代码示例：从 AutoGen 项目的 samples 目录中选取带 UI 界面的代码案例，放入 examples/ 文件夹

这些材料为 AI 提供了框架的使用方式和最佳实践参考。

第二步：生成 initial.md 和 claude.md

将需求描述输入 Claude Code（或 Cursor）：

我需要用 AutoGen 实现一个能够根据用户输入的开发要求生成代码、检查代码质量、优化代码和修复代码的 Agent。请根据我的需求索引当前整个项目，参考 AutoGen 官方文档以及模板文件，生成 initial.md 和 claude.md。

AI 会索引整个项目，读取 AutoGen 相关文档，并根据模板自动生成这两个核心文件。生成的 initial.md 包含了 Agent 功能描述、UI 框架文档等内容；claude.md 则涵盖了项目认知、架构规范、模块化要求、代码风格和安全合规等全局规则。

第三步：生成 PRP 文件

使用官方提供的 generatePRP 命令，Claude Code 会自动执行以下流程：

1. 读取需求：解析 initial.md 中的项目需求
2. 研究阶段：分析代码库、搜索相似实现、识别约定和规范
3. 文档收集：获取相关 API 文档和项目库文档
4. 创建蓝图：制定分步实现计划、添加验证检查点和测试要求
5. 质量检查：评估完整度和上下文充分性
6. 生成 PRP：输出综合性的产品需求提示文件

第四步：执行开发

使用 executePRP 命令，Claude Code 会根据 PRP 文件自动完成整个项目开发：

• 加载上下文：读取完整 PRP 文件，理解所有需求
• 制定计划：创建详细的任务列表（本案例被拆分为 10 个子任务）
• 逐步执行：依次完成环境配置、代码分析工具、数据模型、代码生成 Agent、代码质量检查 Agent、代码优化 Agent 以及 UI 界面集成
• 测试验证：运行测试和代码检查，不通过则自动修复并重新验证

最终生成的项目包含完整的核心功能：代码生成 Agent、代码审查 Agent、代码优化 Agent，以及基于 Chainlit 的 Web UI 界面。

运行效果与实际验证

启动项目后，在浏览器中可以看到一个简洁美观的代码编写 AI 智能体界面。测试输入"用 Python 实现冒泡算法"后，三个 Agent 依次协作：

1. 代码编写 Agent：生成冒泡排序的 Python 代码并附带说明
2. 代码审查 Agent：对代码进行评估，给出改进建议
3. 代码优化 Agent：输出最终优化后的完整代码，并解释改进内容

整个项目一次运行通过，没有出现任何报错。这充分证明了上下文工程相比传统提示词工程的巨大优势：

• 全程无需手动编写代码：包括 initial.md 和 claude.md 都由 AI 自动生成
• 复杂项目一次成功：多 Agent 协作、UI 集成等复杂功能一次性完成
• 零编程基础可用：只要掌握上下文工程的步骤流程，即可开发复杂项目
• 大幅减少调试成本：充分的上下文让 AI 理解全貌，显著降低 bug 率

上下文工程的核心理念很简单：与其教 AI 怎么猜你的意图，不如直接把它需要知道的一切都告诉它。 这不仅是使用技巧的升级，更是 AI 编程思维方式的根本转变。