Planning-with-Files部署与配置：从开发到生产的最佳实践

Planning-with-Files部署与配置从开发到生产的最佳实践【免费下载链接】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-filesPlanning-with-Files是一个基于Manus AI工作流模式的Claude Code技能通过三文件系统实现持久化规划与知识管理。这个价值20亿美元收购背后的工作流模式能够帮助AI代理解决上下文丢失、目标漂移和错误重复等核心问题。为什么选择Planning-with-Files在AI代理开发中我们经常面临上下文管理的挑战。Planning-with-Files通过文件系统作为持久化存储实现了真正的磁盘工作内存。根据项目数据该模式在8个月内帮助Manus AI实现了从启动到1亿美元收入的惊人增长。核心优势持久化记忆规划文件在磁盘上永久保存自动目标追踪通过hooks机制保持目标在注意力窗口中错误智能处理3次尝试协议防止重复失败多会话支持5问题重启测试确保上下文完整快速安装指南方法一Claude Code插件安装推荐/plugin marketplace add OthmanAdi/planning-with-files /plugin install planning-with-filesplanning-with-files方法二手动安装mkdir -p .claude/plugins git clone https://gitcode.com/gh_mirrors/pl/planning-with-files.git .claude/plugins/planning-with-files方法三Cursor集成git clone https://gitcode.com/gh_mirrors/pl/planning-with-files.git cp -r planning-with-files/.cursor .cursor三文件系统配置详解1. task_plan.md - 任务规划核心位置项目根目录用途定义任务阶段、追踪进度、记录决策关键配置定义3-7个可完成的阶段设置状态pending → in_progress → complete记录所有技术决策和错误2. findings.md - 知识发现库位置项目根目录用途存储研究结果、技术决策和重要发现2-Action规则每2次浏览/搜索操作后必须更新此文件3. progress.md - 会话日志位置项目根目录用途详细记录每个阶段的行动、测试结果和错误日志生产环境部署策略开发阶段配置在开发环境中建议使用完整的hooks功能# 初始化所有规划文件 ./scripts/init-session.sh # 验证完成状态 ./scripts/check-complete.sh生产环境最佳实践文件位置管理规划文件必须创建在项目目录中避免在技能安装目录中创建文件错误处理协议第1次尝试诊断和修复第2次尝试采用不同方法第3次尝试重新思考整体方案会话恢复机制实施5问题重启测试维护完整的错误时间戳记录高级配置技巧Hooks自动化配置Planning-with-Files v2.0.0引入了强大的hooks系统PreToolUse Hook在执行Write/Edit/Bash操作前自动读取task_plan.mdStop Hook在停止前验证所有阶段是否完成模板定制化项目提供了完整的模板系统skills/planning-with-files/templates/task_plan.mdskills/planning-with-files/templates/findings.mdskills/planning-with-files/templates/progress.md性能优化建议内存管理避免在上下文中存储大量内容利用findings.md作为外部知识库定期更新progress.md保持会话连续性常见问题解决方案文件位置错误问题规划文件创建在技能安装目录而非项目目录解决方案明确指定项目路径在项目根目录创建CLAUDE.md文件使用技能时提供完整上下文信息Hooks不触发问题PreToolUse hook未按预期运行排查步骤确认Claude Code版本为v1.0.18验证技能安装路径正确检查task_plan.md文件存在性版本升级策略从v1.0.0升级到v2.0.0新增hooks自动化功能增强的模板系统改进的错误处理协议监控与维护建立完整的监控体系定期检查规划文件完整性验证hooks功能正常运行维护错误日志的时效性通过遵循这些最佳实践Planning-with-Files能够在开发和生产环境中提供稳定可靠的AI代理规划支持。【免费下载链接】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），仅供参考