Skills · 社区项目

Planning with Files

让 Agent 用持久文件记录计划、进度与发现,减少长任务中的上下文丢失,并支持中断后恢复。

26.2k StarsMITShell3 天前更新
01

项目介绍

Planning with Files 是一项Agent Skill,核心内容是让 Agent 用持久文件记录计划、进度与发现,减少长任务中的上下文丢失,并支持中断后恢复。它把拆分复杂任务、记录研究发现放在同一个公开项目里,安装前可以先看清目录、命令和限制,再决定是否接入自己的 Agent 工作流。

02

核心功能

01

拆分复杂任务

仓库 README 或组件说明记录了拆分复杂任务的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

02

记录研究发现

仓库 README 或组件说明记录了记录研究发现的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

03

跨会话恢复进度

仓库 README 或组件说明记录了跨会话恢复进度的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

04

保留决策轨迹

仓库 README 或组件说明记录了保留决策轨迹的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

03

安装与使用

按照公开 GitHub 说明配置 Planning with Files,首次接入时保持较小权限范围,再用低风险任务验证,确认正常后再投入日常使用。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装并配置Planning with Files。
项目地址:https://github.com/OthmanAdi/planning-with-files

请先阅读仓库 README 和许可证,确认当前宿主、依赖、目标目录与所需权限。严格采用仓库记录的方法,不要把凭据写进文件或日志;如果支持只读或最小权限模式,优先从该模式开始。完成后运行一个小型验证,并告诉我实际修改、执行命令、配置位置和验证结果。遇到覆盖文件或扩大权限的操作时先停下说明。
01开始前准备
  • 已安装 Node.js 与 npx
  • 允许 Agent 在项目目录创建计划文件
02复制安装命令或配置
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
03按步骤完成安装
  1. 1
    确认依赖和使用范围

    先读 README,确认目标宿主,并准备这些条件:已安装 Node.js 与 npx;允许 Agent 在项目目录创建计划文件。执行前检查目标目录和权限范围。

  2. 2
    按仓库方式完成配置

    执行仓库给出的命令: npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g

  3. 3
    用小任务验证

    重启或重新加载目标 Agent,确认已安装列表中出现 Planning with Files,再运行仓库提供的最小示例。最小示例通过后,再用于重要项目。

如何确认安装成功

重启或重新加载目标 Agent,确认已安装列表中出现 Planning with Files,再运行仓库提供的最小示例。最小示例通过后,再用于重要项目。

使用前注意
  • 短小的一次性任务可能不值得维护额外文件
  • 计划文件仍需要定期整理,不能代替任务判断
04

使用场景

SCENARIO 01

持续数小时的编码任务

当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于持续数小时的编码任务。

SCENARIO 02

需要多轮检索的研究任务

当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于需要多轮检索的研究任务。

SCENARIO 03

中断后继续的 Agent 工作

当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于中断后继续的 Agent 工作。

05

使用评价

这次评价依据仓库 README、组件说明、许可证和维护元数据。比较值得肯定的是把容易丢失的过程信息放到可检查的文件里;安装方式覆盖多种 Agent 宿主。同时也要把限制说清楚,短小的一次性任务可能不值得维护额外文件;计划文件仍需要定期整理,不能代替任务判断。本次收录没有把资料核验写成本机实测。

值得一试的地方

  • 把容易丢失的过程信息放到可检查的文件里
  • 安装方式覆盖多种 Agent 宿主

使用前要知道

  • 短小的一次性任务可能不值得维护额外文件
  • 计划文件仍需要定期整理,不能代替任务判断
06

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