AI Agent 时代,开发者最该维护的不是 Prompt,而是上下文资产

1 阅读4分钟

很多开发者现在还在优化 Prompt。

怎么让 AI 按步骤回答。 怎么让 AI 输出代码。 怎么让 AI 补测试。 怎么让 AI 模仿团队风格。 怎么让 AI 不要废话。

这些都没错,但进入 AI Agent 时代之后,只优化 Prompt 已经不够了。

因为 Agent 不只是回答问题,它会读取项目、理解代码库、执行步骤、生成修改,甚至同时处理多个任务。

OpenAI 的 Codex 文档显示,Codex 是可以读取、编辑、运行代码的 coding agent;Codex cloud 可以在自己的云环境中处理任务,包括并行执行。

这说明 AI 编程正在从“单次问答”,进入“持续协作”。

在这个阶段,开发者真正要维护的不是某一个神奇 Prompt,而是上下文资产。

什么叫上下文资产?

简单说,就是让 AI 快速理解项目规则、业务边界、工程规范和历史约束的一组资料。

它可以包括:

项目架构说明。 技术栈说明。 代码规范。 接口返回格式。 错误处理方式。 数据库约束。 权限模型。 测试要求。 部署规则。 业务术语。 历史坑位。

这些东西如果没有沉淀,每次让 AI 写代码都像新员工第一天入职。

比如你让 AI 写一个接口,如果它不知道你们统一返回:

type Result<T> = {
  code: number;
  message: string;
  data: T;
}

它可能随便返回一个对象。

如果它不知道你们错误统一使用:

throw new BusinessError("ORDER_NOT_FOUND")

它可能直接 throw new Error()

如果它不知道 service 层不能直接访问 request,它就会写出不符合团队规范的代码。

很多人以为这是模型能力问题,其实更多时候是上下文缺失问题。

我建议每个项目都维护一个 ai_context.md

示例:

# Project AI Context

## Tech Stack
- Frontend: React + TypeScript
- Backend: NestJS
- Database: PostgreSQL
- ORM: Prisma

## Code Style
- 禁止使用 any
- API 返回必须使用 Result<T>
- 错误统一使用 BusinessError
- service 层不能直接访问 request
- repository 层负责数据库访问

## Security Rules
- 所有写操作必须校验权限
- 不允许在日志中打印 token
- 用户隐私字段必须脱敏
- 删除操作必须二次确认

## Testing Rules
- 核心 service 必须有单元测试
- 高风险逻辑必须覆盖异常路径
- 所有 bugfix 必须补回归测试

如果项目复杂,可以拆成多个文件:

/docs/ai/project.md
/docs/ai/code_style.md
/docs/ai/security.md
/docs/ai/testing.md
/docs/ai/domain_terms.md
/docs/ai/known_issues.md

不同任务加载不同上下文。

写功能时,加载项目架构和代码规范。 修 bug 时,加载已知问题和测试要求。 做 Review 时,加载安全规则和团队规范。 写文档时,加载业务术语表。 做重构时,加载历史兼容说明。

这比一个万能 Prompt 更实用。

上下文资产还有一个好处:它能让团队协作更稳定。

一个新开发者加入项目,不一定马上理解所有历史规范。但如果项目有清晰的 AI 上下文文件,他可以让 AI 帮他解释模块、生成符合规范的代码、理解老逻辑。

这时候 AI 不只是个人工具,而是团队知识入口。

更重要的是,上下文资产可以跨模型复用。

你今天用 ChatGPT,明天用 Claude,后天用 Gemini,或者用 Grok 做技术讨论,项目上下文都可以作为稳定输入。模型会变,工具会变,但上下文资产是团队自己的。

如果你经常在多个模型之间测试代码理解、长文解释、文档生成和任务拆解,gpt1998.com 可以作为 ChatGPT、Claude、Gemini、Grok 等模型的综合入口,帮助你比较不同模型对同一份项目上下文的理解能力。

但真正关键的不是入口,而是你有没有把项目知识沉淀下来。

判断一个团队有没有 AI 协作基础,可以看几个问题:

有没有项目架构说明? 有没有代码规范文档? 有没有安全规则? 有没有测试要求? 有没有业务术语表? 有没有历史坑位记录? 这些内容能不能被 AI 直接读取?

如果没有,每次和 AI 协作都会重新解释一遍。

未来开发者会越来越多地和 Agent 协作。Google I/O 2026 官方信息也显示,AI 会继续进入 Gemini、Android、Chrome、Cloud 等产品和开发生态。

这意味着开发工作会越来越依赖“可被机器理解的项目知识”。

所以,别只收藏 Prompt 模板。

Prompt 是一次性的。 上下文资产是可积累的。

Agent 时代,真正成熟的开发团队,不是拥有最多 AI 工具,而是拥有最清晰、最可复用的上下文资产。