long-running-agent

Long-Running Agent 框架为执行复杂、多阶段项目的 AI 代理提供了强大的架构。它通过实现持久性状态管理系统来弥补语言模型在不同开发阶段之间的上下文断层，从而解决了常见的“一次性完成”限制。此框架非常适合开发人员构建自主编程代理，这些代理需要处理大规模代码库、增量功能开发以及长期严格的测试周期。

• 包含双代理模式：用于环境设置的初始设置代理 (Initializer Agent) 和用于增量进度的编码代理 (Coding Agent)。

• 使用 init.sh、feature_list.json 和 claude-progress.txt 的标准化会话启动协议，确保上下文连续性。

• 通过进度追踪进行严格的状态管理，包括记录会话时间戳、git 提交历史以及针对特定功能的通过/失败验证。

• 通过初始化脚本自动处理环境设置，包括依赖安装与开发服务器编排。

• 增量开发方法论，强制执行一次处理一个功能，并附带端对端测试要求。

• 确保初始设置代理仅执行一次，以设置基本目录并创建必要的追踪文件。

• 维护 feature_list.json 的完整性，绝不修改测试说明，且仅在成功的端对端验证后更新状态字段。

• 使用提供的进度模板总结变更、记录当前状态，并为后续会话定义清晰的下一步。

• 集成如 Puppeteer MCP 等浏览器自动化工具进行真实端对端验证，而非仅依赖内部单元测试。

• 每个会话结束时务必将进度提交至 git，以维护下一个代理实例可恢复且干净的状态。

• 当应用于非编程领域时，请专注于任务分解、进度持久化以及根据定义的约束条件验证工作成果。