新增章节

Context Engineering

上下文不是“越多越好”,而是“可控、可验证、可复用”。目标是用最小上下文得到稳定输出。

三层上下文模型

静态上下文

规则、约束、架构规范(稳定不变)

  • 项目规范(lint/约束)
  • 接口契约(OpenAPI)
  • 安全边界与权限模型

工作区上下文

与当前任务强相关的文件与代码片段

  • 相关文件路径
  • 最小必要片段(diff/函数)
  • 复现步骤与日志

动态上下文

随时间变化的状态与记忆(要可控)

  • 检索结果(RAG)
  • 最近决策与原因
  • 临时结论与待验证假设

实践清单(建议默认执行)

  • 先给 AI:目标 + 当前现状 + 约束 + 输出格式
  • 把“参考资料”显式分组:规则/代码/日志/数据
  • 限制上下文:只给最相关的 3-8 个文件(或关键片段)
  • 对不确定的地方要求标注 [需要确认],避免瞎编
  • 每次迭代都留痕:变更点 + 证据(测试/日志/截图)