Agent原生架构:Claude Code 后时代该如何构建智能体应用
最近Claude Code大火,火的原因不简单是Vibe编程神器本身,更重要的是它正在重新定义智能体的开发范式,过去利用胶水代码或者拖拉拽方式构建的传统(面向过程)智能体,或将被那种只需要描述结果,交给持续循环运行达成目标的Agent原生智能体所颠覆。
Claude Code配合恰到好处的的插件、Skills等机制证明了一个好的编程智能体就是一个好的通用智能体。让智能体重构代码库的架构,同样能让它整理文件、管理阅读列表或自动化工作流程。
近日,Dan Shipper与Claude联合发布的《Agent-Native Architecture》技术指南,详述了这种全新的智能体构建方式,提出Agent原生架构的五大核心原则和一些值得探讨的细节。
五大核心原则
1. 对等性(Parity)
用户能通过UI完成的操作,智能体都应该能通过工具实现。
这是基础原则。没有它,其他都免谈。确保智能体拥有能完成UI所有功能的工具。
测试方法:选择任何UI操作,智能体能完成吗?
2. 粒度(Granularity)
工具应该是原子性基础功能,特性则是智能体通过循环操作达成的结果。
工具是基础能力,特性是提示词中描述的结果,由配备工具的智能体循环运行直到达成。
判断标准:改变行为时你是在编辑提示词还是重构代码?
3. 可组合性(Composability)
有了原子工具和对等性,你就能通过编写新提示词创造新功能。
想要"周报"功能?只需一个提示词:"回顾本周修改的文件,总结关键变化。基于未完成项目和临近截止日期,建议下周三个优先级。"
智能体使用list_files、read_file和它的判断能力。你描述了结果,智能体循环直到达成。
4. 涌现能力(Emergent Capability)
智能体能完成你没有明确设计的任务。
运作循环:
用原子工具和对等性构建 用户要求你没预料到的功能 智能体组合工具来完成,或失败后暴露差距 观察请求模式 添加领域工具或提示词优化常见模式 重复
测试标准:它能处理你领域内的开放式请求吗?
5. 自我改进(Self-improvement)
Agent原生应用通过累积上下文和提示词优化而改进,无需发布代码。
累积上下文:状态通过上下文文件跨会话保持
开发者级优化:为所有用户发布更新的提示词
用户级定制:用户为自己的工作流修改提示词
文件作为通用接口
关键洞察是"文件作为通用接口"的设计理念。在传统软件中,API承担系统间通信工作。在智能体原生架构中,文件成为更自然的交互媒介。
为什么选择文件?
智能体天然擅长:智能体已经了解cat、grep、mv、mkdir,文件操作是它们最熟练的基础功能。
用户可见:用户能看到智能体创建了什么,可以编辑、移动、删除。没有黑盒。
便携性强:导出轻松,备份轻松,用户拥有自己的数据。
跨设备同步:在移动端配合iCloud,所有设备共享同一文件系统。智能体的工作出现在各处,无需构建服务器。
自文档化:/projects/acme/notes/比SELECT * FROM notes WHERE project_id = 123更易理解。
目录结构设计
Documents/
├── AgentCheckpoints/ # 临时文件
│ └── {sessionId}.checkpoint
├── AgentLogs/ # 调试日志
│ └── {type}/{sessionId}.md
└── Research/ # 用户工作区
└── books/{bookId}/
├── full_text.txt
├── notes.md
└── agent_log.md上下文注入模式
# Context
## Who I Am
Reading assistant for the Every app.
## What I Know About This User
- Interested in military history and Russian literature
- Prefers concise analysis
## What Exists
- 12 notes in /notes
- three active projects
## Recent Activity
- User created "Project kickoff" (two hours ago)
## My Guidelines
- Don't spoil books they're reading
- Use their interests to personalize insights智能体在每次会话开始时读取这个文件,随着状态变化更新它——无需代码变更的便携工作记忆。
移动端的独特机遇与挑战
机遇
文件系统支持:智能体能自然使用文件,采用在其他地方同样有效的基础功能。
丰富的设备上下文:围墙花园的访问权限。健康数据、位置、照片、日历——桌面端或网页端不存在的上下文。
本地应用:每个人都有自己的应用副本。应用可以自我修改、自我分叉、按用户演化。
应用状态同步:通过iCloud,所有设备共享同一文件系统。智能体的工作出现在所有设备上——无需服务器。
挑战
智能体是长时间运行的,移动应用却不是。
智能体可能需要30秒、5分钟或1小时来完成任务。但iOS会在几秒钟不活动后将应用置于后台,可能完全终止应用以回收内存。
这需要精心设计:
检查点机制:…