外化进度追踪

概述

外化进度追踪是 Agent Harness 设计中的核心实践，使用文件系统作为外部记忆，通过结构化的进度文件（如 claude-progress.txt 和 features.json）实现跨会话的状态传递和任务协调。

关键内容

1. 核心文件结构：
2. claude-progress.txt：
   • 已完成的任务列表
   • 当前进行中的任务
   • 下一步计划
   • 关键决策和约束背景
   • 已知问题和阻塞点

3. features.json：

   • 功能列表及各自状态
   • 每个功能的完成标准
   • 功能间的依赖关系

4. 设计原则：

5. 文件系统作为单一真相源（Single Source of Truth）
6. 不依赖 Agent 的对话历史来维护状态
7. 每个执行步骤结束后必须更新进度文件

8. 进度文件应包含足够的上下文，使新实例能无缝继续

9. 与 外化工作记忆 的关系：

10. 外化进度追踪是 外化工作记忆 概念在长时任务中的具体实现
11. 通过持久化存储减轻模型对内部上下文记忆的负担

12. 使 Agent 可以专注于当前推理，而非全局状态管理

13. 与 Session 交接机制 的对比：

14. 两者都使用文件外部化状态
15. 外化进度追踪更细粒度，专注于任务级别的进度
16. Session 交接机制更宏观，关注跨会话的知识传递

来源

• raw/articles/ai-engineering/anthropic-engineering/claude-engineering/09_effective_harnesses.md — Effective harnesses for long-running agents

相关

• 外化工作记忆 — implements（外化进度追踪实现了外化工作记忆的概念）
• 初始化-编码循环模式 — part_of（是初始化-编码循环模式的核心组件）
• Agent Harness 运行框架 — part_of（是 Harness 框架的关键实践）
• Session 交接机制 — compares_to（相似但更细粒度的状态外部化方案）