面对 AI 编程中上下文重置、目标漂移等痛点,planning-with-files 技巧提供了一套解法。它将关键状态持久化到文件,变易失记忆为可追溯的工作流,让复杂开发任务变得可控、可恢复。
智能速览
planning-with-files 通过三文件系统(task_plan.md、findings.md、progress.md)管理复杂任务。
自动化 Hook 机制能在关键节点同步目标,防止开发过程偏离轨道。
即使清空上下文,会话恢复功能也能从文件中恢复工作状态,避免信息丢失。
该方案特别适合需要多阶段、长期维护的复杂编程项目。
所有关键发现和过程都被记录,增强了任务的可追溯性和可调试性。
精华内容
这套方法的核心,是把文件系统当作 AI 的稳定外部记忆。通过分工明确的文件和自动化流程,将原本转瞬即逝的上下文信息,固化为可随时查阅的持久记录。
三文件分工
task_plan.md 是项目的主控面板,明确任务目标、范围和关键决策,并通过复选框实时维护阶段状态。它确保了方向的正确性和范围的约束性。
findings.md 作为客观信息的数据库,存放所有研究发现、代码片段和文档摘录。它只记录已确认的事实,而非推测或待办,是构建结论的基础。
progress.md 则是连续的开发日志,记录每次会话的实际操作、遇到的错误和调试过程。它的核心价值在于提供完整的可追溯性,方便回顾问题缘由和恢复工作进度。
自动化流程
Pre-Execution Hook 是防止目标漂移的关键。在每次写入、编辑或执行命令前,它会自动读取 task_plan.md,将核心目标重新注入上下文。
Post-Execution Hook 在操作完成后提醒检查并更新阶段状态,确保 task_plan.md 的实时性。
Stop Hook 在结束前检查所有阶段是否完成,避免任务遗漏。
View Hook 规定每两次查看操作后必须将发现写入 findings.md,强制保存重要信息,防止被上下文覆盖。
会话恢复机制
该技巧的核心优势之一是会话恢复能力。当上下文窗口满载,需要运行 /clear 命令清空时,传统方式会导致所有工作记忆丢失。而 planning-with-files 能在下一次启动时,自动从三个文件中恢复任务状态、研究发现和进度日志。
这保证了即使会话中断,也能无缝衔接,避免了大量重复性工作。为了最大化此效果,建议关闭上下文的自动压缩功能,手动控制清空时机,让持久化文件承担记忆职责。
适用场景
planning-with-files 并非万能,它在处理复杂、多阶段、需要长期维护的项目时价值最大。例如,开发一个包含多个模块的 CLI 工具,或进行持续的代码库重构。
在这些场景中,任务目标、研究发现和执行过程都至关重要。反之,对于一次性、简单的脚本编写任务,使用这套流程反而会增加不必要的开销。因此,正确识别任务复杂度是发挥其价值的前提。
planning-with-files 巧妙地利用文件系统解决了 AI 编程中的记忆难题,为长期、复杂的开发任务提供了高度可控和可追溯的框架。这种思路是否预示着未来 AI 工作流的新方向?