planning-foundation 是 superpower-planning 中所有工作流技能共同继承的基础能力,核心思路是把上下文窗口当作易失的内存,把文件系统当作持久磁盘,凡重要内容都写入 .planning/。
用途:为多步骤、研究型、项目构建或跨越大量工具调用的任务提供持久化的会话状态记录。简单问题、单文件修改和快速查询被明确列为可跳过的场景。
主要能力与用法: 一、目录约定。.planning/ 被视为 gitignored 的临时工作状态,含 findings.md(发现与决策)与 progress.md(任务状态看板加会话日志);agents/ 目录不初始化时创建,由子智能体按需各自建立,如 .planning/agents/implementer/,每角色一个目录并跨任务持续追加。计划文件放在 docs/plans/。 二、快速开始。在复杂任务前创建 .planning/ 目录,参照 templates/progress.md 建 progress.md,参照 templates/findings.md 建 findings.md;重大决策前重读计划,每阶段结束后更新状态与错误。 三、2-Action 派发规则。每完成两次读取、搜索或探索操作,立即按内容类型归档:发现、决策、意外归 findings.md;状态、动作、错误、结果归 progress.md。 四、错误处理。所有错误都要记录,绝不重复相同失败动作。采用三振出局协议:第一次诊断并修复,第二次换方法,第三次重新审视假设,三次失败后升级给用户。 五、读写判断。刚写完的文件不必重读;看过图像或 PDF、浏览器返回数据要立即写入;新阶段开始、发生错误或中断后恢复时需重读相关或全部规划文件。 六、五问重启测试。能否回答我在哪、要去哪、目标是什么、学到了什么、做了什么,分别对应 progress.md 的任务状态看板、剩余阶段、计划中的目标陈述、findings.md 与 progress.md。
模板与脚本:templates/findings.md、templates/progress.md、templates/agent-context.md,以及 scripts/init-planning-dir.sh、scripts/check-complete.sh、scripts/session-catchup.py。
限制与反模式:不要把 TaskCreate/TaskUpdate 当作跨会话持久化,任务 API 仅用于会话内编排;不要只陈述一次目标就遗忘,不要隐藏错误静默重试,不要把一切塞进上下文,不要未建计划文件就立即执行,不要让子智能体发现丢失,应聚合到顶层 findings.md。官方文本与具体收费、平台等信息暂未提供。