登录

Resource detail

planning-with-files

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and co

GlobalFreeOpen source

Keep this listing accurate

Owners can claim a listing; anyone can report a factual issue or request removal.

At a glance

planning-with-files

Pricing

Free

Access

No login

Platforms

Web

Chinese support

No

Last checked

2026-09-03

Popularity

93/100

Free quota:MIT 许可开源,技能与插件免费获取。

Pricing evidence

USD 0 / 一次性安装仓库以 MIT 许可开源;可通过 Claude Code 插件市场、npx skills、npm、Pi、Hermes 或 OpenCode 插件数组安装,其中只有 Claude Code 插件方式会带齐全部 hook。Open price source

Free quota:MIT 许可开源,技能与插件免费获取。

Verification and source

Partially verified

目录记录的 skills.sh 条目页只提供说明、安装命令、42.4K 安装数和「含 Hooks」提醒,没有许可和适配客户端,因此转到该页给出的 GitHub 仓库核对:已确认 MIT 许可、task_plan.md/findings.md/progress.md 三文件结构、各宿主 3 至 8 个 hook 的作用、SHA-256 计划篡改标记和并行写入告警;README 自述 96.7% 通过率只来自 v2.21.0 在 claude-sonnet-4-6 上的单次运行且只衡量文件格式一致性,5.0 对 13.3 轮的恢复对比为作者自测、未在当前默认行为下重测,均未作为效果结论采用。skills.sh 页面标注的 26.6K 星标未与仓库交叉核对。

GitHub 仓库 OthmanAdi/planning-with-files

Tags

Skill计划长任务

Audience

开发者

Update info

Updated 2026-09-03

Popularity 93/100

Typical use

长任务编排进度可恢复

Citation card

planning-with-files

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and co

AI X Tool · https://aixtool.xyz/resources/planning-with-files

Why try it

Good fit

  • MIT 许可,把计划、发现和进度写到磁盘上的三个 markdown 文件,上下文被清空后仍能续跑
  • 对 Claude Code、Cursor、GitHub Copilot、Codex 等宿主提供 hook,在会话开始、提交提示、写入之后和压缩之前重新注入计划
  • 计划正文与批准时的 SHA-256 不符会被标记 [PLAN TAMPERED] 拒绝注入,并能发现并行会话互相覆盖

Watch outs

  • README 自述的 96.7% 通过率只来自单一版本、单一模型的一次运行,衡量的是文件格式一致性而非长任务目标漂移
  • 以技能方式安装可能出现「静默没有 hook」,官方建议走插件方式并用 /plan-doctor 校验
  • 计划文件默认被 gitignore,会被下一个任务覆盖,不是可归档的交付物

Not for

  • 短任务和一次性问答,维护三个计划文件的开销大于收益
  • 不接受助手在仓库里自动写入计划文件或自动执行 hook 的团队

Change log

Catalog update

2026-09-03

Last verified

2026-09-03

Review note

目录记录的 skills.sh 条目页只提供说明、安装命令、42.4K 安装数和「含 Hooks」提醒,没有许可和适配客户端,因此转到该页给出的 GitHub 仓库核对:已确认 MIT 许可、task_plan.md/findings.md/progress.md 三文件结构、各宿主 3 至 8 个 hook 的作用、SHA-256 计划篡改标记和并行写入告警;README 自述 96.7% 通过率只来自 v2.21.0 在 claude-sonnet-4-6 上的单次运行且只衡量文件格式一致性,5.0 对 13.3 轮的恢复对比为作者自测、未在当前默认行为下重测,均未作为效果结论采用。skills.sh 页面标注的 26.6K 星标未与仓库交叉核对。

FAQ

它怎么做到「崩溃后可续跑」?

把阶段与勾选项写入 task_plan.md、把研究结论写入 findings.md、把会话日志写入 progress.md,hook 会在每轮开始时重新注入计划内容,因此上下文被清空后仍能定位续跑点。

安装方式有区别吗?

有。README 说明只有 Claude Code 插件方式会带齐全部 hook,技能方式可能在未接受项目信任时静默失效,建议安装后用 /plan-doctor 校验。

计划文件会进版本库吗?

不会。README 说明计划文件默认被 gitignore,属于工作内存而非交付物,会被下一个任务覆盖,需要留存要自行归档。

Similar tools and resources

Selected by use case