Planning-with-Files错误处理最佳实践3-Strike Protocol与5-Question Reboot Test【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files在AI代理工作流程中错误处理往往是区分高效系统与失败尝试的关键因素。Planning-with-Files项目基于Manus AI被Meta以20亿美元收购的上下文工程原则为AI代理提供了一套完整的错误处理框架确保每个失败都成为学习的机会而不是重复的噩梦。为什么错误处理如此重要AI代理在执行复杂任务时经常面临目标漂移和记忆丢失的问题。经过50多个工具调用后原始目标往往被遗忘在上下文的深处。Planning-with-Files通过将错误持久化存储到文件中确保相同的错误不会重复发生。核心洞察错误恢复是真正智能代理行为的最清晰信号之一。3-Strike Protocol结构化错误恢复策略3-Strike Protocol是Planning-with-Files的核心错误处理机制它确保代理不会陷入无限重试的循环中第一次尝试诊断与修复仔细阅读错误信息识别根本原因应用针对性修复第二次尝试替代方法相同的错误尝试不同的方法不同的工具不同的库绝不重复完全相同的失败操作第三次尝试重新思考质疑假设搜索解决方案考虑更新计划3次失败后升级到用户解释你尝试了什么分享具体的错误信息请求指导5-Question Reboot Test上下文恢复检查当代理需要从暂停状态恢复工作时5-Question Reboot Test确保代理能够快速重新定位我在哪里→ 查看task_plan.md中的当前阶段我要去哪里→ 查看剩余阶段目标是什么→ 查看计划中的目标声明我学到了什么→ 查看findings.md我做了什么→ 查看progress.md实际应用错误日志记录模式在Planning-with-Files工作流程中错误被系统性地记录在两个关键文件中task_plan.md中的错误记录## Errors Encountered | Error | Attempt | Resolution | |-------|---------|------------| | FileNotFoundError | 1 | Check if file exists, create empty list if not | | JSONDecodeError | 2 | Handle empty file case explicitly |progress.md中的错误日志## Error Log | Timestamp | Error | Attempt | Resolution | |-----------|-------|---------|------------| | 2026-01-15 10:35 | FileNotFoundError | 1 | Added file existence check |关键原则绝不重复失败Planning-with-Files遵循Manus的核心原则if action_failed: next_action ! same_action跟踪你尝试过的方法改变你的方法。工作流程中的错误处理集成错误发生时的标准操作流程立即记录→ 在task_plan.md和progress.md中同时记录错误分析模式→ 识别错误的根本原因制定新策略→ 基于失败的洞察调整方法最佳实践总结必须遵守的规则✅创建计划文件第一- 绝不跳过task_plan.md的创建✅2-Action规则- 每2次浏览/搜索操作后必须更新findings.md✅记录所有错误- 即使你立即修复了它们✅永不重复失败- 如果操作失败下一个操作必须不同常见反模式❌隐藏错误并静默重试❌重复完全相同的失败操作❌认为快速修复的错误不需要记录实战案例从错误中学习在构建Python CLI待办事项应用的示例中代理遇到了两个关键错误FileNotFoundError→ 第1次尝试添加文件存在检查JSONDecodeError→ 第2次尝试显式处理空文件情况通过系统性地记录这些错误代理不仅解决了当前问题还为未来的类似任务积累了宝贵的经验。结论将失败转化为成功Planning-with-Files的3-Strike Protocol和5-Question Reboot Test共同构成了一个强大的错误处理生态系统。它们确保AI代理能够从错误中学习避免重复相同的失败在中断后快速恢复上下文建立持续改进的知识库记住在AI代理的世界里唯一真正的失败是不从错误中学习。Planning-with-Files让每个错误都成为通向成功的垫脚石。通过采用这些最佳实践你的AI代理将能够处理更复杂的任务保持目标一致性并持续改进其性能。这些原则正是Manus AI在短短8个月内实现1亿美元收入的核心秘密。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考