AgentIndex icon
AgentIndex
工具MCP 服务HOT分类热门最新选型清单对比指南
提交工具
工具MCP 服务HOT分类热门最新选型清单对比指南
首页/
记忆与上下文/
planning-with-files
planning-with-files logo

planning-with-files

活跃·★ 28.1k·MIT·更新于 2026-11-11
★ 最受欢迎

Planning with Files(PWF)是由 Othman Adi 开源的高口碑智能体规划框架,其核心哲学极为简明深刻:“智能体的上下文窗口终将耗尽,但磁盘上的规划永不磨灭。”该项目专门解决自主智能体在执行跨多轮复杂工程任务时容易出现的注意力发散、步骤遗忘与重复无用功等缺陷。

不同于脆弱的、极易随上下文压缩或 `/clear` 会话重置而灰飞烟灭的纯提示词指令,PWF 将任务状态硬性固化在项目本地的三大核心 Markdown 文件中:`task_plan.md`(结构化任务分解与当前执行项)、`findings.md`(项目架构洞察、API 特性与排错发现)以及 `progress.md`(已验证里程碑与单测证据)。系统通过生命周期钩子(Hooks)在每一轮对话前后自动比对读取,强力将模型拉回真实的执行路径上。

在针对长链路复杂任务的盲测 A/B 对比中,PWF 展现出压倒性的执行收敛率,目前已全面覆盖 60 余款遵循 Agent Skills 标准的智能体,并原生适配 Claude Code、Codex、Pi、OpenCode 与 DeepSeek Harness。需要注意的是,该模式会在项目根目录下直接产生规划辅助文档,需合理配置 Git 忽略或归档;每一轮的文件读写同步也会带来微小的磁盘 I/O 耗时。

本文根据项目 README 和公开仓库数据整理,我们没有实际试用过该工具。数据截至 2026-11-12。

许可证
MIT
最新发布
v3.28.1 · 2026-11-07
最近提交
2026-11-11
贡献者
72
复刻数
2,311
未关闭的 issue 和 PR
12
首次发布
2026-01-03

来源:GitHub、npm 和 PyPI 的公开接口。

#智能体技能#自主智能体#Claude#Claude Code#Claude Code 技能#Claude 技能#Codex#编程智能体
$ 安装
$ npx skills add OthmanAdi/planning-with-files --skill planning-with-files
↗ 访问官网★ GitHub
01

功能特性

01维护 task_plan.md、findings.md 与 progress.md。
02生命周期钩子注入选定项目计划上下文。
03提供 Agent Skills 及多个宿主专用插件路径。
02

为什么选择它

+不可磨灭的任务规划状态,无论遇到上下文压缩、会话重置还是终端意外崩溃,进度永不丢失。
+标准三文件体系(task_plan、findings、progress),清晰割裂任务清单、代码认知与实测证据。
+全自动生命周期会话钩子机制,轮次触发强约束,从机制上杜绝智能体自说自话与目标漂移。
+极佳的生态普适性,支持主流 Agent Skills 规范,无缝赋能 60 余款智能体编码工具。
03

权衡点

!直接在项目根目录下生成规划辅助文档,需要在团队协作中规范 Git 提交策略或加入 .gitignore。
!每轮迭代均涉及本地文件的读取比对与状态覆写,在超多轮次任务中存在微量磁盘 I/O 延迟。
!若开发者在终端外手动跳步完成了部分改动,智能体需要执行特定的同步模式来更新文件状态。
!对于极度简单、单文件小修小补的快速问答任务,维持整套文件规划机制会显得略显繁琐。
04

维护状况检查

活跃检查日期: 2026-11-12
最近提交
2026-11-11
近 90 天提交数
100+
近 90 天发布数
30
最新发布
v3.28.1 (2026-11-07)
未关闭 issue
12
近期 issue 至少有一条评论的比例
18/24
近 12 周每周提交数
近 12 周每周提交数: 9, 27, 14, 62, 38, 5, 12, 16, 21, 13, 31, 12

最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。

状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

  • #19 For multi-step / complex tasks, how should this skill be used properly?29 条评论 · 2026-01-12
  • #230 Invitation: get planning-with-files verified on Sigistry (free, open source)5 条评论 · 2026-08-28
  • #326 Consider opt-in checkbox-only re-attestation for routine progress updates4 条评论 · 2026-10-17
  • #196 Add an optional hosted quick-try link for planning-with-files4 条评论 · 2026-07-08
  • #380 SKILL.md is about 10k tokens: Claude Code keeps the first 5,000 after compaction, and three documented mechanisms no longer exist0 条评论 · 2026-11-10

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

05

兼容性

agent-skills
需要兼容 Agent Skills 的宿主
已通过文档验证
06

快速开始

1
$ npx skills add OthmanAdi/planning-with-files --skill planning-with-files
07

使用场景

↳在磁盘上跟踪长期编程任务。
↳在压缩或清空上下文后继续计划。
↳分别保存研究发现与进度更新。
08

同类工具

⚡热门对决:
VSnuwa-skill★38.5k→VSawesome-agent-skills★37.3k→VShuashu-design★29.7k→VSobsidian-wiki★3.8k→
nuwa-skill logo
nuwa-skill★ 38.5k
通过调研人物资料、提炼思维框架与表达方式来生成可复用人物视角技能的工具。
VS对比→
awesome-agent-skills logo
awesome-agent-skills★ 37.3k
整理开发团队与社区发布的 Agent Skills,并提供分类和安装路径参考的资源目录。
VS对比→
huashu-design logo
huashu-design★ 29.7k
面向兼容智能体的 HTML 设计技能,制作网页、应用原型、幻灯片及信息图。
VS对比→
video-shotcraft logo
video-shotcraft★ 21.0k
用产品截图、镜头配方和 Remotion 制作可继续编辑的发布视频的智能体技能。
obsidian-wiki logo
obsidian-wiki★ 3.8k
让智能体将资料与会话知识整理为互链 Markdown,并维护跨会话记忆的 Obsidian 知识库工具。
VS对比→
darwin-skill logo
darwin-skill★ 7.0k
通过基线对比、实跑盲评和保留或回滚机制改进智能体技能的工具。
VS对比→
drama-skills logo
drama-skills★ 4.4k
覆盖原著改编、分镜、图片视频提示词、制作和审片的 AI 短剧技能集合。
VS对比→
huashu-motion logo
huashu-motion★ 2.9k
让智能体用网页代码制作发布动画、配乐并通过画面批注迭代的视频技能。
VS对比→
查看全部替代品 →

评论

登录后发表评论

暂无评论,来发表第一条吧

本页内容
01功能特性02为什么选择它03权衡点04维护状况检查05兼容性06快速开始07使用场景08同类工具
OthmanAdi /
planning-with-files
↗

基于文件的智能体持久化规划框架:通过本地 Markdown 文件固化任务蓝图,无惧上下文丢失与会话重置

28.1k2.3kMIT
最后更新1周前
状态活跃
分类记忆与上下文
贡献者72
最新发布v3.28.1
链接
文档↗讨论↗问题↗版本↗
推荐云部署
Ad

在 DigitalOcean 上一键部署

为你的 MCP 服务、Docker 容器与智能体提供即开即用云服务器,新用户立享 $200 免费额度(60天有效)。

立即领取 $200 免费额度
© 2026 AgentIndex.app|由十年 iOS 开发者构建。
按场景挑选关于我们联系我们广告合作隐私政策使用条款QYSGitHub请作者喝咖啡 ☕

按分类浏览

MCP 服务器代码助手工作流自动化RAG / 知识库多智能体浏览器自动化大模型基础设施开发者工具可观测性

与 Anthropic, OpenAI 或 Microsoft 无关。