Agent 为什么能连续做十几步？

这份材料区分了由预定义代码路径控制的 Workflow 与由模型动态控制过程的 Agent，并强调先采用能工作的最简单方案。它还给出 Prompt Chaining、Routing、Parallelization、Orchestrator-Workers、Evaluator-Optimizer 等组合模式，以及何时值得承担 Agent 的延迟、成本和复合错误。

这份文档把 Claude Code 的 Agent Loop 描述为收集上下文、采取行动、验证结果三个相互交织的阶段，并说明模型与工具如何通过结果反馈持续调整。它还解释 Claude Code 作为 Harness 所承担的上下文管理、执行环境、会话、压缩、检查点和权限职责。

这份材料逐步解释 Codex Harness 如何组装 instructions、tools 与 input，通过 Responses API 在一次 Turn 内循环完成模型推理和工具调用。它还说明对话增长、上下文窗口、Prompt Caching 与 Compaction 为什么属于 Harness 的核心工程责任。

xAI 官方说明本次公开的是 Grok Build 编码 Agent 与终端 TUI，并明确列出 Agent Loop、代码交互工具、终端 UI，以及 Skills、Plugins、Hooks、MCP Servers、Subagents 等扩展系统。它让课程可以用真实实现核对 Harness 责任，而不是让产品经理通读源码。

固定提交 README 将公开范围界定为 grok CLI/TUI 与 Agent Runtime 的 Rust 源码快照，并标出 TUI、Agent Runtime、工具、Workspace、MCP、Sandbox 等主要 crate；仓库由 xAI 内部 monorepo 定期同步且不接受外部贡献。

该文件展示 Session Actor 怎样统一接收命令、模型 Turn 完成、工具与 MCP 事件、会话状态和停止事件，再启动下一段工作或进入 Idle；它证明生产 Loop 还要管理并发事件、生命周期与恢复，而不是只有“模型想一步、工具做一步”。

工具 crate 的 NOTICE 明确说明 apply_patch、grep_files、list_dir、read_file 从 openai/codex 移植，bash、edit、glob、grep、read、skill、todowrite、write 从 sst/opencode 移植；这些实现经过跨语言翻译、Tool Trait 适配与扩展。

这段固定提交源码展示 Hermes 如何检查工具名和 JSON 参数、限制委派数量、去重调用，并用结构化工具结果把可恢复错误送回下一轮。它直接证明生产级 Agent Loop 在模型输出与真实动作之间还需要确定性处理。

这段固定提交源码先持久化工具调用，再交给执行器产生真实副作用；若工具 Guardrail 阻断，则写入明确的受控终止原因。它证明工具执行、恢复与用户可见状态需要由 Harness 收口。

这段固定提交源码定义 Turn 结束时的预算耗尽、回退与完成判定，并把轨迹保存、资源清理和清理错误纳入统一关账。它支持课程把 completed 视为需要系统证据与退出处理的状态，而不是模型的一句话。

这段固定提交源码在 Turn 结束时修复未闭合的工具消息序列，并把最终消息和会话状态持久化；持久化失败会作为清理错误保留，而不是静默伪装成完整成功。