planning-with-files

planning-with-files 技能为管理复杂、多步骤的任务提供了稳健的架构框架，通过将文件系统视为外部的持久化工作记忆。该系统专为 AI 代理设计，通过在项目专用的 Markdown 文件中维护状态，解决了“中间丢失”现象，代理会定期读取这些文件以将目标保持在当前的注意力窗口内。此技能非常适合需要高结构化输出及跨长期会话进行可验证进度跟踪的开发人员、研究人员与项目经理。

• 启用 3-file 模式 (task_plan.md, notes.md, 以及 deliverable.md) 来隔离关注点并有效管理内存使用。

• 强制执行基于阶段的作业，确保目标、研究发现与最终产出在逻辑上具备可追溯的步骤。

• 包含任务规划、研究笔记与状态报告的标准化模板，减少认知负担与上下文切换。

• 维护“遇到的错误”专区以记录失败轨迹与解决路径，促进迭代学习与调试能力。

• 在每个重要阶段或操作后，推动对文件进行原子化、随时可提交的更新，确保项目状态始终与文件系统同步。

• 用户应在执行超过三个步骤或需要多工具协调的任务时启用此技能，例如架构研究、复杂的代码重构或多阶段软件开发。

• 预期的输入包括任务定义、研究查询或功能需求；预期的输出为结构化的 Markdown 文件，作为项目的真理来源。

• 实际限制：用户应避免将此技能用于简单或单一操作的查询，以免建立文件的成本变得不必要。此技能依赖于“先读后做”规则的严格执行，以确保代理在整个任务生命周期中保持目标的一致性。使用此方式可防止上下文堆叠，并确保大型研究发现能组织在外部笔记中，而非短暂的内存缓冲区内。