SuperAPI AI 工具集

planning-with-files

办公与效率

查看项目

更新于 10-16 02:20

技能介绍

用途

planning-with-files 是一个用于组织复杂任务的工作流技能,目标是把持久化的 Markdown 文件当作“磁盘上的工作记忆”,以类似 Manus 的方式管理规划、进度跟踪和知识存储。它适合在开始复杂任务时使用,帮助把目标、阶段、研究发现和最终产出分别落到文件中,而不是全部堆在上下文里。

主要能力

该技能围绕“三文件模式”展开。对于每一个非平凡任务,创建三个文件:

  • task_plan.md:跟踪阶段与进度,在每个阶段完成后更新。
  • notes.md:存储研究发现与资料,在研究过程中更新。
  • [deliverable].md:最终输出,在完成时生成。

它提供了一套核心工作流循环:先创建带目标和阶段的 task_plan.md;然后研究并把结果保存到 notes.md,同时更新 task_plan.md;接着阅读 notes.md 创建交付物并更新 task_plan.md;最后交付最终输出。

使用方式

在开始任何复杂任务之前,先在工作目录创建 task_plan.md,用复选框定义阶段,每完成一个阶段后标记 [x] 并更改状态,在做决定前先阅读计划文件以刷新目标。

task_plan.md 模板包含:标题(Task Plan: [简要描述])、Goal(一句话描述最终状态)、Phases(阶段复选框列表,如规划与设置、研究/收集信息、执行/构建、审查与交付)、Key Questions(待回答的问题)、Decisions Made(已做决定及理由)、Errors Encountered(遇到的错误及解决方式)、Status(当前处于第几阶段及正在做什么)。

notes.md 模板用于研究与发现,包含 Sources(来源名称、URL、要点)和 Synthesized Findings(按类别归纳的发现)。

关键规则包括:始终先创建计划,绝不无计划开始复杂任务;决定前先阅读计划文件,让目标保持在注意力窗口;行动后立即更新计划文件,标记完成阶段、更新状态、记录错误;存储而非塞入,大输出写入文件,工作记忆中只保留路径;记录所有错误,每个错误都写入“Errors Encountered”部分,为未来任务积累知识。

适用场景

适合使用三文件模式的情况包括:多步骤任务(3 步以上)、研究任务、构建或创建某物、跨多次工具调用的任务,以及任何需要组织性的任务。

可以跳过的情况包括:简单问题、单文件编辑、快速查找。

限制与注意事项

应避免的反模式包括:不要用 TodoWrite 做持久化,而应创建 task_plan.md 文件;不要只陈述一次目标就忘记,而应在每次决定前重读计划;不要隐藏错误并重试,而应把错误记录到计划文件;不要把一切塞进上下文,而应把大内容存入文件;不要立即开始执行,而应先创建计划文件。

关于高级模式,资料提到可参考 reference.md 了解注意力操作技巧、错误恢复模式以及来自 Manus 的上下文优化;参考 examples.md 了解真实任务示例和复杂工作流模式。这些参考文件的具体内容暂未提供。