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)

智能体能完成你没有明确设计的任务。

运作循环:

  1. 用原子工具和对等性构建
  2. 用户要求你没预料到的功能
  3. 智能体组合工具来完成,或失败后暴露差距
  4. 观察请求模式
  5. 添加领域工具或提示词优化常见模式
  6. 重复

测试标准:它能处理你领域内的开放式请求吗?

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会在几秒钟不活动后将应用置于后台,可能完全终止应用以回收内存。

这需要精心设计:

检查点机制:…

— 以上为试看内容(约 40%),开通会员后阅读全文 —