planning

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AI Maestro Planning

AI Maestro规划

Solve the execution problem -- staying focused during complex, multi-step tasks. Uses persistent markdown files to track goals, findings, and progress so you never lose context. Part of the AI Maestro suite.

解决执行难题——在复杂的多步骤任务中保持专注。使用持久化Markdown文件跟踪目标、发现和进度，确保不会丢失上下文。属于AI Maestro套件的一部分。

When to Use

适用场景

Multi-step tasks (3+ steps)
Research projects
Building features requiring >5 tool calls
Any task where you might lose track of the goal

多步骤任务（3步及以上）
研究项目
需要调用5次以上工具的功能开发
任何可能导致目标偏离的任务

The 3-File Pattern

三文件模式

Create in

docs_dev/

(or

$AIMAESTRO_PLANNING_DIR

File	Purpose	Update When
`task_plan.md`	Goals, phases, decisions, errors	After each phase
`findings.md`	Research, discoveries, resources	During research
`progress.md`	Session log, test results	Throughout session

在

docs_dev/

（或

$AIMAESTRO_PLANNING_DIR

目录）中创建：

文件	用途	更新时机
`task_plan.md`	目标、阶段、决策、错误记录	完成每个阶段后
`findings.md`	研究内容、发现成果、资源链接	研究过程中
`progress.md`	会话日志、测试结果	整个会话过程中

Quick Start

快速开始

bash

PLAN_DIR="${AIMAESTRO_PLANNING_DIR:-docs_dev}"
mkdir -p "$PLAN_DIR"

Then create

task_plan.md

with:

markdown

undefined

bash

PLAN_DIR="${AIMAESTRO_PLANNING_DIR:-docs_dev}"
mkdir -p "$PLAN_DIR"

然后创建

task_plan.md

，内容如下：

markdown

undefined

Task: [Goal]

任务: [目标]

Phases

阶段

Decisions

决策记录

Decision	Rationale	Date

决策	理由	日期

Errors Encountered

遇到的错误

Error	Attempt	Resolution

undefined

错误	尝试次数	解决方案

undefined

The 6 Rules

六条规则

Create plan first -- Never start complex work without
```
task_plan.md
```
Read before decide -- Re-read the plan before any major decision
Update after act -- Mark phases complete, log what changed
2-action rule -- After every 2 search/browse operations, save findings to
```
findings.md
```
Log all errors -- Every error goes in the plan with attempt number and resolution
Never repeat failures -- If an action failed, change your approach

先创建计划——开始复杂工作前必须先创建
```
task_plan.md
```
先读计划再决策——做出任何重大决策前重新阅读计划
行动后更新计划——标记阶段完成，记录所有变更
两操作规则——每完成2次搜索/浏览操作后，将发现内容保存到
```
findings.md
```
记录所有错误——所有错误都要记录到计划中，包含尝试次数和解决方案
不重复失败——如果某操作失败，更换方法

The 3-Strike Protocol

三次重试协议

Strike	Action
1	Diagnose root cause, apply targeted fix
2	Try a different approach entirely
3	Question assumptions, search for similar issues
After 3	Escalate to user with all attempts documented

重试次数	行动
1	诊断根本原因，应用针对性修复
2	完全尝试另一种方法
3	质疑假设，搜索类似问题
3次重试后	将所有尝试记录整理后上报给用户

The 5-Question Reboot

五问题重启法

Lost? Answer these from your planning files:

Where am I? (current phase in
```
task_plan.md
```
)
Where am I going? (remaining phases)
What's the goal? (goal section)
What have I learned? (
```
findings.md
```
)
What have I done? (
```
progress.md
```
)

迷失方向？从规划文件中回答这些问题：

我当前处于哪个阶段？（查看
```
task_plan.md
```
中的当前阶段）
我的下一步目标是什么？（剩余阶段）
整体目标是什么？（目标部分）
我学到了什么？（查看
```
findings.md
```
）
我已经完成了什么？（查看
```
progress.md
```
）

Full AI Maestro Experience

完整AI Maestro体验

This skill works standalone with no dependencies. For the complete experience including memory search, docs search, graph query, agent messaging, and agent management, install the full AI Maestro platform.

该功能可独立运行，无依赖项。如需完整体验，包括记忆搜索、文档搜索、图查询、Agent消息传递和Agent管理，请安装完整的AI Maestro平台。