项目介绍
Planning with Files 是一项Agent Skill,核心内容是让 Agent 用持久文件记录计划、进度与发现,减少长任务中的上下文丢失,并支持中断后恢复。它把拆分复杂任务、记录研究发现放在同一个公开项目里,安装前可以先看清目录、命令和限制,再决定是否接入自己的 Agent 工作流。
核心功能
拆分复杂任务
仓库 README 或组件说明记录了拆分复杂任务的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。
记录研究发现
仓库 README 或组件说明记录了记录研究发现的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。
跨会话恢复进度
仓库 README 或组件说明记录了跨会话恢复进度的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。
保留决策轨迹
仓库 README 或组件说明记录了保留决策轨迹的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。
安装与使用
按照公开 GitHub 说明配置 Planning with Files,首次接入时保持较小权限范围,再用低风险任务验证,确认正常后再投入日常使用。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我安装并配置Planning with Files。
项目地址:https://github.com/OthmanAdi/planning-with-files
请先阅读仓库 README 和许可证,确认当前宿主、依赖、目标目录与所需权限。严格采用仓库记录的方法,不要把凭据写进文件或日志;如果支持只读或最小权限模式,优先从该模式开始。完成后运行一个小型验证,并告诉我实际修改、执行命令、配置位置和验证结果。遇到覆盖文件或扩大权限的操作时先停下说明。- 已安装 Node.js 与 npx
- 允许 Agent 在项目目录创建计划文件
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g- 1确认依赖和使用范围
先读 README,确认目标宿主,并准备这些条件:已安装 Node.js 与 npx;允许 Agent 在项目目录创建计划文件。执行前检查目标目录和权限范围。
- 2按仓库方式完成配置
执行仓库给出的命令: npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
- 3用小任务验证
重启或重新加载目标 Agent,确认已安装列表中出现 Planning with Files,再运行仓库提供的最小示例。最小示例通过后,再用于重要项目。
重启或重新加载目标 Agent,确认已安装列表中出现 Planning with Files,再运行仓库提供的最小示例。最小示例通过后,再用于重要项目。
- 短小的一次性任务可能不值得维护额外文件
- 计划文件仍需要定期整理,不能代替任务判断
使用场景
持续数小时的编码任务
当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于持续数小时的编码任务。
需要多轮检索的研究任务
当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于需要多轮检索的研究任务。
中断后继续的 Agent 工作
当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于中断后继续的 Agent 工作。
使用评价
这次评价依据仓库 README、组件说明、许可证和维护元数据。比较值得肯定的是把容易丢失的过程信息放到可检查的文件里;安装方式覆盖多种 Agent 宿主。同时也要把限制说清楚,短小的一次性任务可能不值得维护额外文件;计划文件仍需要定期整理,不能代替任务判断。本次收录没有把资料核验写成本机实测。
值得一试的地方
- 把容易丢失的过程信息放到可检查的文件里
- 安装方式覆盖多种 Agent 宿主
使用前要知道
- 短小的一次性任务可能不值得维护额外文件
- 计划文件仍需要定期整理,不能代替任务判断
README
Planning with Files
Overview
让 Agent 用持久文件记录计划、进度与发现,减少长任务中的上下文丢失,并支持中断后恢复。 让 Agent 用持久文件记录计划、进度与发现,减少长任务中的上下文丢失,并支持中断后恢复。
Getting started
- 按照公开 GitHub 说明配置 Planning with Files,首次接入时保持较小权限范围,再用低风险任务验证,确认正常后再投入日常使用。
- 仓库把 Planning with Files 定位为让 Agent 用持久文件记录计划、进度与发现,减少长任务中的上下文丢失,并支持中断后恢复。重点不在做一份泛泛的合集,而是把拆分复杂任务、记录研究发现、跨会话恢复进度、保留决策轨迹这些能力整理成可以继续使用或核验的内容。
- 从公开 README 可以确认的要点包括文件化计划与进度、支持中断恢复、兼容 18 种以上 Agent、可用 Skills CLI 安装。这些信息来自仓库说明和目录,本次收录没有把文档描述写成已经在本机完成的实测结果。
- 重启或重新加载目标 Agent,确认已安装列表中出现 Planning with Files,再运行仓库提供的最小示例。最小示例通过后,再用于重要项目。
Configuration
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g在 GitHub 阅读完整 README →