架构层次

五个正交关注点组合成完整的 Agent

L1 Tools & Execution

Agent 能做什么。基础层：工具赋予模型与外部世界交互的能力。

s01tools

The Agent Loop

Bash is All You Need

84 LOC1 tools

The minimal agent kernel is a while loop + one tool

s02tools

Tools

The Loop Didn't Change

115 LOC4 tools

Adding tools means adding handlers, not rewriting the loop

L2 Planning & Coordination

如何组织工作。从简单的待办列表到跨 Agent 共享的依赖感知任务板。

s03planning

TodoWrite

Plan Before You Act

173 LOC5 tools

Visible plans improve task completion and accountability

s04planning

Subagents

Process Isolation = Context Isolation

146 LOC5 tools

Process isolation gives context isolation for free

s05planning

Skills

SKILL.md + tool_result Injection

177 LOC5 tools

Skills inject via tool_result, not system prompt

s07planning

Tasks

Persistent CRUD with Dependencies

202 LOC8 tools

File-based state survives context compression

L3 Memory Management

在上下文限制内保持记忆。压缩策略让 Agent 可以无限工作而不失去连贯性。

s06memory

Compact

Strategic Forgetting

200 LOC5 tools

Forgetting old context enables infinite-length sessions

L4 Concurrency

非阻塞执行。后台线程和通知总线实现并行工作。

s08concurrency

Background Tasks

Fire and Forget

193 LOC6 tools

Non-blocking daemon threads + notification queue

L5 Collaboration

多 Agent 协作。团队、消息传递和能独立思考的自主队友。

s09collaboration

Agent Teams

Teammates + Mailboxes

343 LOC10 tools

Persistent teammates with async mailbox inboxes

s10collaboration

Team Protocols

Shutdown + Plan Approval

414 LOC12 tools

Same request-response pattern, two applications

s11collaboration

Autonomous Agents

Idle Cycle + Auto-Claim

494 LOC14 tools

Polling + timeout makes teammates self-organizing

s12collaboration

Worktree + Task Isolation

Isolate by Directory

689 LOC16 tools

Task board coordinates ownership, worktrees isolate execution, and events make lifecycle auditable