用途:为复杂任务提供基于文件的规划与进度跟踪,把重要信息写入磁盘而非仅依赖上下文窗口。核心思路是上下文窗口相当于易失的 RAM,文件系统相当于持久的磁盘。
主要能力:创建并维护三个文件——task_plan.md(阶段、进度、决策)、findings.md(研究、发现)、progress.md(会话日志、测试结果)。提供模板与脚本,包括 scripts/init-session.sh 初始化规划文件、scripts/check-complete.sh 校验阶段完成、scripts/session-catchup.py 恢复上次会话上下文。
使用方式:开始复杂任务前先创建 task_plan.md,再创建 findings.md 和 progress.md,模板位于 <forge-root>/skills/planning-with-files/templates/,规划文件应放在项目目录而非技能安装目录。恢复上次会话可运行:$(command -v python3 || command -v python) skills/planning-with-files/scripts/session-catchup.py "$(pwd)",Windows PowerShell 用 python "skills\planning-with-files\scripts\session-catchup.py" (Get-Location)。
关键规则:先建计划;每两次查看/浏览/搜索操作后立即保存关键发现;重大决策前重读计划;每阶段完成后更新状态并记录错误;记录所有错误;不重复失败动作,采用三振错误协议,三次失败后升级给用户。
适用场景:三步以上的多步任务、研究任务、构建项目、跨多次工具调用的任务。简单问题、单文件编辑、快速查询可跳过。
限制:资料未提供收费、价格、平台支持范围等具体信息。