SuperAPI AI 工具集

planning-with-files

办公与效率

查看项目

更新于 10-15 07:54

技能介绍

用途

planning-with-files 是一个工作流技能,目标是像 Manus 那样工作:把持久化的 Markdown 文件当作“磁盘上的工作记忆”,用于复杂任务的规划、进度跟踪和知识存储。它解决的是复杂任务中目标容易遗忘、上下文被大量内容塞满、错误被隐藏等问题,通过把计划、笔记和交付物落到文件里,让工作过程可追踪、可恢复。

主要能力

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

文件 用途 更新时机
task_plan.md 跟踪阶段与进度 每个阶段之后
notes.md 存储发现与研究结果 研究过程中
[deliverable].md 最终输出 完成时

核心工作流分为四个循环:

  • 循环 1:创建 task_plan.md,写明目标与阶段。
  • 循环 2:研究 → 保存到 notes.md → 更新 task_plan.md。
  • 循环 3:读取 notes.md → 创建交付物 → 更新 task_plan.md。
  • 循环 4:交付最终输出。

循环的细节要求:在每个重大动作之前,读取 task_plan.md 以刷新注意力窗口中的目标;在每个阶段之后,编辑 task_plan.md,标记 [x] 并更新状态;在存储信息时,写入 notes.md,不要把内容塞进上下文。

使用方式

快速开始:在任何复杂任务之前,先在工作目录中创建 task_plan.md,用复选框定义阶段,每个阶段后更新(标记 [x] 并更改状态),做决定前先读取以刷新目标。

task_plan.md 模板:

# Task Plan: [Brief Description]

## Goal

[One sentence describing the end state]

## Phases

- [ ] Phase 1: Plan and setup
- [ ] Phase 2: Research/gather information
- [ ] Phase 3: Execute/build
- [ ] Phase 4: Review and deliver

## Key Questions

1. [Question to answer]
2. [Question to answer]

## Decisions Made

- [Decision]: [Rationale]

## Errors Encountered

- [Error]: [Resolution]

## Status

**Currently in Phase X** - [What I'm doing now]

notes.md 模板:

# Notes: [Topic]

## Sources

### Source 1: [Name]

- URL: [link]
- Key points:
  - [Finding]
  - [Finding]

## Synthesized Findings

### [Category]

- [Finding]
- [Finding]

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

适用场景

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

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

限制与反模式

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

进阶内容

reference.md 中提供注意力操纵技术、错误恢复模式、来自 Manus 的上下文优化;examples.md 中提供真实任务示例和复杂工作流模式。

暂未提供

关于该技能的安装命令、收费方式、支持平台等信息,资料中暂未提供。