planning-with-files

把 AI 计划存成文件，崩溃/清空后也能接着干

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 2313 🐛 待处理 17 👀 关注 112

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 27953

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类智能体

开发团队OthmanAdi

官网地址https://gilded-laurel-c7nj.here.now

GitHubhttps://github.com/OthmanAdi/planning-with-files

定价模式🏷️完全免费

价格说明开源项目，MIT 许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Shell

技术栈/模型agent-skills,autonomous-agents,claude,claude-code,claude-code-skills,claude-skills,codex,coding-agent,context-engineering,context-rot,cursor,github-copilot,hermes-plugin,hermes-skill,llm-agents,long-running-agents,manus,multi-agent-systems,planning,session-recovery

GitHub 星标★ 27953

上线时间2026-01-03 00:00:00

代码更新2026-11-07

仓库体积26.7 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

planning-with-files 是一个基于文件系统的持久化规划工具，专为 AI 编程代理和长时间运行的任务设计。它解决了 AI 代理在对话中断、上下文压缩或模型重置后丢失计划的问题，通过将计划以 Markdown 文件形式持久化存储，实现崩溃恢复和会话恢复。其核心能力包括：每轮自动将计划重新注入上下文，对抗上下文衰减（context rot）；提供确定性的完成门控，确保任务按计划推进；支持多种主流 AI 代理（如 Claude Code、Codex、Cursor、OpenCode 等 60+ 工具）。安装方式多样，可通过 npm、Claude Code 插件市场或 npx skills 获取。该项目采用 Shell 语言编写，轻量且易于集成，适合需要长期稳定执行复杂任务的 AI 工作流。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 27953

技术标签

agent-skills autonomous-agents claude claude-code claude-code-skills

使用教程

难度：入门约 15 分钟部署方式：全局安装 5 步

环境要求

一个受支持的 AI 编码助手

安装与启动步骤

1装成 Skill

一条命令装到全局，适用于它列出的几十种编码助手。
```
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
```
2或走插件市场

插件路线内容最全，带 skill、钩子和斜杠命令。
```
/plugin marketplace add OthmanAdi/planning-with-files
```
3起一个多步任务

让它规划一个需要多轮的任务，观察项目根目录多出三个 Markdown。
4中途清空上下文再继续

清空后直接继续，看它能不能从当前阶段接上。
5核对清单只增不减

正常工作时已完成项不会倒退，出现倒退说明有东西在乱写。
```
cat task_plan.md
```

如何确认成功

任务中途清空上下文或触发压缩后继续，助手能从 task_plan.md 记录的当前阶段接着做，不需要你复述已完成部分

注意事项

它把计划从上下文窗口搬到磁盘上的三个 Markdown：task_plan.md 管阶段与复选框，findings.md 记研究结论，progress.md 记会话与测试结果。
关键在于每轮靠宿主的生命周期钩子把计划重新注入，所以能扛住清空、压缩和崩溃 —— 这和「先让模型列个计划」有本质区别。
注意 npm install planning-with-files 只装文件不注册钩子，要钩子得走 skills 或插件路线。
并行任务各自落在 .planning 下按日期与短名分的目录里，靠 .active_plan 指针切换。
计划文件默认进 .gitignore，不入库。
官方给了五种语言的 skill 变体，中文环境装 planning-with-files-zh 即可。