基于文件的规划方法：使用Markdown文件作为工作记忆，提升复杂任务效率

planning-with-files by codingheader/myskills

1 周安装量

GitHub

安装命令

npx skills add https://github.com/codingheader/myskills --skill planning-with-files

方法论项目管理生产力

🇨🇳中文介绍

基于文件的规划

像 Manus 一样工作：使用持久的 Markdown 文件作为你的"磁盘工作记忆"。

核心原则

Context Window = RAM (易失，有限)
Filesystem = Disk (持久，无限)

→ 任何重要的内容都要写入磁盘。

快速开始

在进行任何复杂任务之前，创建以下三个文件：

task_plan.md — 跟踪阶段和进度
findings.md — 存储研究和发现
progress.md — 会话日志和测试结果

起始模板请参见 references/ 目录。

文件用途

文件	用途	何时更新
`task_plan.md`	阶段、进度、决策	每个阶段之后
`findings.md`	研究、发现	发现之后

🇺🇸English

Planning with Files

Work like Manus: Use persistent markdown files as your "working memory on disk."

Core Principle

Context Window = RAM (volatile, limited)
Filesystem = Disk (persistent, unlimited)

→ Anything important gets written to disk.

Quick Start

Before ANY complex task, create these three files:

task_plan.md — Track phases and progress
findings.md — Store research and discoveries
progress.md — Session log and test results

See references/ for starting templates.

File Purposes

File	Purpose	When to Update
`task_plan.md`	Phases, progress, decisions	After each phase
`findings.md`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

3. 决策前先阅读

在做出重大决策之前，阅读计划文件。这能让目标保持在你的注意力窗口中。

完成任何阶段后：

标记阶段状态：in_progress → complete
记录遇到的任何错误
注明创建/修改的文件

5. 记录所有错误

每个错误都要记录在计划文件中。这有助于积累知识并防止重复犯错。

6. 绝不重复失败

if action_failed:
    next_action != same_action

跟踪你尝试过的内容。改变方法。

三次尝试错误协议

ATTEMPT 1: 诊断与修复
  → 仔细阅读错误
  → 识别根本原因
  → 应用针对性修复

ATTEMPT 2: 替代方法
  → 同样的错误？尝试不同的方法
  → 不同的工具？不同的库？
  → **绝不**重复完全相同的失败操作

ATTEMPT 3: 重新全面思考
  → 质疑假设
  → 搜索解决方案
  → 考虑更新计划

AFTER 3 FAILURES: 上报给用户
  → 解释你尝试了什么
  → 分享具体的错误
  → 请求指导

何时使用此模式

多步骤任务（3 步以上）
研究任务
构建/创建项目
涉及多次工具调用的任务

简单问题
单文件编辑
快速查找

references/task_plan.md — 阶段跟踪模板
references/findings.md — 研究存储模板
references/progress.md — 会话日志模板

Manus 原则： 完整的上下文工程模式请参见 references.md
实际示例： 实际实现请参见 examples.md

不要	应该这样做
陈述目标后就忘记	决策前重新阅读计划
隐藏错误并默默重试	将错误记录到计划文件
把所有东西塞进上下文	将大内容存储在文件中
立即开始执行	首先创建计划文件
重复失败的操作	跟踪尝试，改变方法

这种模式是 Manus 在 8 个月内从发布到被 20 亿美元收购的原因。

1. Create Plan First

Never start a complex task without task_plan.md. Non-negotiable.

2. The 2-Action Rule

"After every 2 view/browser/search operations, IMMEDIATELY save key findings to text files."

This prevents visual/multimodal information from being lost.

3. Read Before Decide

Before major decisions, read the plan file. This keeps goals in your attention window.

After completing any phase:

Mark phase status: in_progress → complete
Log any errors encountered
Note files created/modified

Every error goes in the plan file. This builds knowledge and prevents repetition.

6. Never Repeat Failures

if action_failed:
    next_action != same_action

Track what you tried. Mutate the approach.

The 3-Strike Error Protocol

ATTEMPT 1: Diagnose & Fix
  → Read error carefully
  → Identify root cause
  → Apply targeted fix

ATTEMPT 2: Alternative Approach
  → Same error? Try different method
  → Different tool? Different library?
  → NEVER repeat exact same failing action

ATTEMPT 3: Broader Rethink
  → Question assumptions
  → Search for solutions
  → Consider updating the plan

AFTER 3 FAILURES: Escalate to User
  → Explain what you tried
  → Share the specific error
  → Ask for guidance

When to Use This Pattern

Multi-step tasks (3+ steps)
Research tasks
Building/creating projects
Tasks spanning many tool calls

Simple questions
Single-file edits
Quick lookups

references/task_plan.md — Phase tracking template
references/findings.md — Research storage template
references/progress.md — Session logging template

Manus Principles: See references.md for complete context engineering patterns
Real Examples: See examples.md for practical implementations

Don't	Do Instead
State goals once and forget	Re-read plan before decisions
Hide errors and retry silently	Log errors to plan file
Stuff everything in context	Store large content in files
Start executing immediately	Create plan file FIRST
Repeat failed actions	Track attempts, mutate approach

This pattern is why Manus went from launch to $2B acquisition in 8 months.

Python PDF处理教程：合并拆分、提取文本表格、创建PDF文件

58,600 周安装

基于文件的规划方法：使用Markdown文件作为工作记忆，提升复杂任务效率

🇨🇳中文介绍

基于文件的规划

核心原则

快速开始

文件用途

🇺🇸English

Planning with Files

Core Principle

Quick Start

File Purposes

相关 Skills

关键规则

1. 先创建计划

2. 双操作规则

3. 决策前先阅读

4. 行动后更新

5. 记录所有错误

6. 绝不重复失败

三次尝试错误协议

何时使用此模式

模板

高级主题

反面模式

Critical Rules

1. Create Plan First

2. The 2-Action Rule

3. Read Before Decide

4. Update After Act

5. Log ALL Errors

6. Never Repeat Failures

The 3-Strike Error Protocol

When to Use This Pattern

Templates

Advanced Topics

Anti-Patterns

最新 Skills