让 AI 用文件做盘外记忆，规划复杂任务步骤 #

解决长任务中的上下文遗忘问题：通过强制 AI 将阶段性计划、研究发现和错误日志写入项目目录下的文件，确保 AI 在执行多步骤任务、长期研究或构建复杂项目时，始终拥有清晰的当前状态和目标。

为什么需要这个技能 #

大型语言模型的“工作记忆”（Context Window）是有限的且易丢数据的（RAM）。一旦上下文窗口满了或会话间隔太久，AI 就会忘记之前的指令、已完成的步骤和收集到的信息。

对于需要分阶段执行的复杂任务（如开发功能、深度调研），如果不把重要信息写下来，AI 很容易在中间步骤“断片”，导致重复劳动或逻辑混乱。这个技能就是教 AI 如何像人类记笔记一样，把关键信息持久化到磁盘。

适用场景 #

• 多步骤任务：需要连续调用多个工具，执行 3 个以上连续操作的项目。
• 长期研究：需要整理大量信息，不能一次性塞进上下文窗口的调研工作。
• 项目构建：涉及文件创建、代码编写、测试的自动化工程任务。
• 恢复状态：需要读取之前的会话记录，接着中断后的工作继续进行。

核心工作流 #

1. 初始化计划文件：在开始任何复杂任务前，先在项目根目录创建 task_plan.md，明确任务阶段和目标。
2. 强制持久化记录：
   • 发现新信息后，立即写入 findings.md。
   • 记录当前进度、测试结果后，更新 progress.md。
   • 遇到错误时，记录在计划文件中，避免重复尝试相同失败的操作。
3. 定期同步状态：
   • 每完成一个阶段，将状态从 in_progress 改为 complete。
   • 遇到错误时，先阅读相关计划文件，确认当前状态再尝试修复。
4. 执行与迭代：
   • 遵循“两操作一保存”原则，每进行 2 次浏览或搜索后，必须保存发现。
   • 若连续失败 3 次（3-Strike），检查错误日志并调整策略或重新规划。

文件用途说明 #

注意：所有规划文件必须存放在你的项目根目录，而不是技能安装目录。这确保文件与你代码一起协作，便于版本管理和持久化。

关键规则与反模式 #

• 不要在文件刚写完就立即读取，内容还在上下文中。
• 不要将大段内容仅依赖记忆，必须存储到文件中。
• 不要静默重试失败操作，先查阅错误日志和之前的尝试记录。
• 不要在技能目录中创建你的规划文件，务必放在项目目录。

下载和安装 #

下载 planning-with-files 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，将模板复制到项目根目录即可使用。具体路径参考内附的 USAGE.zh.md 或 scripts/init-session.sh 初始化脚本。

你可能还需要 #

暂无推荐