Planning with Files
OthmanAdi/planning-with-filesAI 已审核
RepoPicks Radar 检查于
Planning with Files 是什么?
Planning with Files 是一个加到 AI 编程助手上的 skill。它把当前工作的计划保存在项目里三个纯文本文件中(task_plan.md、findings.md、progress.md),并在每一轮开始时把内容交还给助手,这样工作在 /clear、崩溃或上下文重置之后还能继续。它还能在计划没有标记完成之前,拦住助手不让它宣布任务结束。一条命令就能把它装进 Claude Code、Codex、Cursor、Copilot 和几十个其他助手里。这个 skill 是免费的,但助手本身通常不是。
Planning with Files 安装有多容易?
C · 需要安装 1–2 个工具 · Windows
- Windows C
- macOS C
- Linux C
三个系统都是 C 级:你本来就要先装好一个 AI 编程助手,然后运行一条命令,`npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g`,这需要 Node.js。真正干活的部分是 shell 脚本(这个仓库的主要语言是 Shell,完成的判定由 `check-complete.sh` 用 `grep -F` 做匹配),所以在 Windows 上它们期望有一个 Bash 环境;Qoder 这条路径的文档里写明需要 "Bash and Python 3.10+"。
Planning with Files 的 GitHub 数据
- 星标
- 27,9892026年11月10日
- 下载量
- —所有发布版本
- 增长
- +1056 天内新增星标
星标变化
事实
- 可运行于
- Windows, macOS, Linux
- 需要安装
- Node.js, 其他工具
- 磁盘空间
- 未确定
- 账号或密钥
- 无
- 费用
- 免费,API 另行收费 · 这个 skill 在 MIT 许可证下是免费的。它只能在像 Claude Code、Codex 或 Cursor 这样的 AI 编程助手里面起作用,而这些助手通常需要付费套餐或付费的 API 用量。
- 许可证
- MIT (宽松型)
- 可以替代
- Manus
- GitHub 上的最近改动
- 2026年11月10日
Planning with Files 的风险信号 (7)
- 注意装上之后每个会话都会自己运行脚本
快速安装方式是 `npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g`,直接从 GitHub 仓库做全局安装,项目对自己的描述是 "Not a prompt it might follow. A hook that fires every turn"。仓库里有 `hooks/` 和 `scripts/` 文件夹,外加 17 个助手的插件文件夹,所以执行完一条命令之后,这些脚本就会自动在你助手的会话里运行,处理你的文件。
AI 审核
- 信息基准测试的数据来自作者自己
"benchmark-96.7% pass (29/30)" 和 "blind A/B 3/3 wins" 这两个徽章,以及计划 "turned a 13.3-turn re-orientation into 5.0 turns"、"One hook fire measures 289ms wall-clock" 这些说法,全部都来自项目自己的 docs/evals.md。README 本身也只是指向 "numbers and limits",并没有引用任何独立测试。
AI 审核
- 信息README 里推广一个付费赞助商来接入你的智能体
README 靠前的位置有一个 Sponsor 区块,宣传 "Scrape.ly by evomi",带有追踪链接(scrape.ly/?utm_source=github&utm_medium=readme&utm_campaign=planning-with-files),邀请你 "Connect the Scrape.ly MCP server to Claude Code, Cursor or any MCP client"。另外还有一个给 CodeRabbit 的 "OSS code review support" 区块。这些推荐和安装步骤写在同一份 README 里。
AI 审核
- 信息计划文件设计上就是用完即丢
FAQ: "They are working memory, not a tracked deliverable. `task_plan.md`, `findings.md`, `progress.md`, and the `.planning/` directory are gitignored by default and are not archived automatically: the next task overwrites the root plan." 想保留的笔记需要手动挪到别处,或者用 `set-active-plan.sh --archive <slug> --yes` 来归档。
AI 审核
- 信息你能用到的功能取决于你用的助手
README 写道 "Commands and model-callable tools depend on the host; Qoder CLI loads the skill and lifecycle hooks without the Claude-specific command prompts",列出了 13 个带原生插件的宿主,并通过 Agent Skills 文件标准达到 "60+" 和 "70+ others" 这些数字,"the `npx skills` installer alone targets 71 agents"。其中只有一部分是经过测试的集成。
AI 审核
- 信息发布节奏非常快
仓库创建于 2026-01-03,已经有 127 个发行版,最新的 v3.28.1 发布于 2026-11-07(本次检查前一天),README 里记录了在 v3.6.0、v3.7.0、v3.10.0、v3.11.0 和 v2.36.0 中发生变化的行为。27953 个星标和 17 个未关闭的 issue 说明这个项目很活跃,但一个会全局重装自己的 skill 变动得也很频繁。
AI 审核
- 信息项目网站用的是自动生成的地址
仓库的主页字段是 https://gilded-laurel-c7nj.here.now/,这是一个看起来随机生成的托管子域名,而不是属于项目自己的名字,安装次数则是通过第三方徽章服务(skills.sh、skillsplayground.com、skill-history.com)展示出来的。
AI 审核
证据以原始语言显示。
Radar 无法验证的 Planning with Files 相关内容
- 计划是否真的能在你的助手里撑过 /clear 和压缩,因为每个宿主的集成方式都不一样
- 这些 hook 在实际使用中是否会拖慢你的会话速度,因为 289 毫秒这个数字是作者自己测的
- 全局安装会往你的主目录写入什么内容,每个助手最终又会运行哪些 hook 文件
- README 自己都留有余地的那 60 多个受支持的智能体是否真的都像描述的那样表现
- 每一轮都注入的额外文字会给一个付费助手增加多少成本