Repolode
提交项目
OthmanAdi

OthmanAdi/planning-with-files

为 AI 编程代理提供基于文件的任务规划技能，把计划保存在磁盘上，在上下文重置、/clear 或崩溃后仍可恢复。

在 GitHub 查看官网
Star
27,940
Fork
2,314
未关闭 Issue
11
最近提交
11小时前

这是什么？

Planning with Files 是一个面向 AI 编程代理的技能，把任务的计划、调研笔记和进度记录在项目内的三个 Markdown 文件中：task_plan.md、findings.md 和 progress.md。状态保存在磁盘而非上下文窗口里，因此代理在 /clear、上下文压缩或崩溃之后，仍能从当前阶段继续工作。

生命周期钩子会在每轮对话开始时重新注入当前计划的上下文，完成度检查脚本则判断计划各阶段是否已结束。并行任务可以在 .planning/ 下使用独立目录，并通过活动计划指针切换。自动恢复只读取项目文件，读取本地代理会话记录需要显式开启 catchup 模式。

该技能可通过 npx skills、Claude Code 插件市场或 npm 安装，并为 Claude Code、Codex CLI、Cursor、OpenCode、Hermes Agent 等提供原生插件集成，还提供多种语言的译本。

核心功能

  • 01将计划、调研发现和进度以 Markdown 文件形式保存在项目中
  • 02通过生命周期钩子在每轮对话中重新注入当前计划
  • 03在 /clear、上下文压缩或会话崩溃后恢复计划
  • 04完成度检查可判断计划各阶段是否全部完成
  • 05为并行任务提供相互隔离的计划目录
  • 06可通过 Agent Skills 标准安装到多种编程代理中

适用场景

  • 跨多次会话进行的长周期重构或迁移
  • 需要代理在 /clear 之后仍能接续的多步骤编码任务
  • 在代理工作过程中保留决策与测试结果的可追溯记录

收录于专题

Claude Code 工具、技能与插件开源 AI Agent 框架与应用AI 编程助手与编码 AgentAI Agent 技能包

标签

#agent-skills#ai-agents#claude-code#context-engineering#planning#llm-agents#coding-agent#autonomous-agents#claude#claude-code-skills

常见问题

planning-with-files 是什么？
为 AI 编程代理提供基于文件的任务规划技能，把计划保存在磁盘上，在上下文重置、/clear 或崩溃后仍可恢复。 Planning with Files 是一个面向 AI 编程代理的技能，把任务的计划、调研笔记和进度记录在项目内的三个 Markdown 文件中：task_plan.md、findings.md 和 progress.md。状态保存在磁盘而非上下文窗口里，因此代理在 /clear、上下文压缩或崩溃之后，仍能从当前阶段继续工作。
planning-with-files 可以免费使用吗？用的什么许可证？
planning-with-files 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
planning-with-files 还在维护吗？
活跃维护中。planning-with-files 最近一次提交是在 2026年11月7日。
planning-with-files 适合用来做什么？
跨多次会话进行的长周期重构或迁移 需要代理在 /clear 之后仍能接续的多步骤编码任务 在代理工作过程中保留决策与测试结果的可追溯记录
在哪里获取 planning-with-files？
源代码和安装说明在 GitHub 上：https://github.com/OthmanAdi/planning-with-files

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目