Agent 教程

外观

第 7 章研究笔记 ​

本章不是继续阅读某一个 Claude Code 子系统，而是把前面章节提炼出的设计组合成一个简化版 Agent。

来源设计 ​

  • QueryEngine.ts：会话封装。
  • query.ts：Agent 主循环。
  • Tool.ts：Tool 抽象。
  • toolExecution.ts：工具执行管线。
  • permissions.ts：权限网关。
  • sessionStorage.ts：append-only 会话日志。
  • commands.ts、SkillTool、services/mcp：后续扩展方向。

最小模块 ​

text
ModelClient
AgentLoop
MessageStore
ToolRegistry
ToolExecutor
PermissionGate
SessionStore

先不做的能力 ​

  • 插件市场。
  • 完整 MCP transport。
  • 自研终端 renderer。
  • 多层 context compact。
  • 子 Agent 和后台任务。
  • 自动记忆。

一开始必须做的边界 ​

  • tool_use/tool_result 配对。
  • 工具输入 schema 校验。
  • 写操作权限确认。
  • 会话日志。
  • max turns。
  • abort。
  • 错误型 tool_result。