planning-with-files 官方入口：让 AI 任务计划持久保存的安装指南

planning-with-files 官方入口是 GitHub 仓库 OthmanAdi/planning-with-files。README 给出 Quick Install、Claude Code Plugin 和多语言 Skill 名称；Codex 安装细节在 docs/codex.md。不要从第三方下载站拿压缩包，尤其是带 hooks 的工具，来源不清会直接影响本地 Agent 执行流程。

官方安装入口看哪里

README 的 Quick Install 写的是 npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g。需要中文 Skill 时，README 也列出 planning-with-files-zh；是否选择中文版本，看你的团队提示词和文档语言。Claude Code 想要 /plan 自动补全，要走 plugin 路线：/plugin marketplace add OthmanAdi/planning-with-files，再安装 planning-with-files@planning-with-files。

Codex 安装要点

1. 团队共享：复制官方仓库里的 .codex 到项目根目录并提交。
2. 个人使用：复制 skill、hooks 和 hooks.json 到 ~/.codex/ 对应目录。
3. 配置文件：在 ~/.codex/config.toml 的 features 下写 hooks = true。
4. 检查命令：codex features list | rg '^(hooks|codex_hooks)\s'。
5. 已有 hooks.json 时只合并条目，不整文件覆盖。

docs/codex.md 还说明了 Codex 会从 .codex/skills/ 发现 Skill，从 .codex/hooks.json 或 ~/.codex/hooks.json 读取 hooks。它的实际手感像本地 AI 求职、重构或研究任务的“指挥中心”：计划在文件里，提醒和恢复由 hooks 接住。

安装后别立刻交给 Agent 跑大任务。先建一个测试分支，让它创建 task_plan.md、findings.md、progress.md，完成一小段任务后看 Git Diff。能看到计划、发现、进度都有同步，才算入口和 hooks 真正跑通。

如果你只想临时审查代码，不希望当前目录的计划被注入到一次性任务里，官方 Codex 文档写了 PLANNING_DISABLED=1 的绕开方式。这个变量适合 CI、只读研究、嵌套 Agent 调用，日常交互会话不用长期打开。安装指南里把这点看清，后面排查会省很多时间。

判断官方入口还有一个简单标准：页面要能回到仓库 README、docs 目录、SKILL.md 或 release 记录。只有这些位置能说明命令、目录和版本变化。搜索结果里出现的镜像包、网盘包、二次打包页都不要当下载源，尤其不要把里面的 hooks.json 复制到本机。带自动化钩子的工具，本质上会参与本地 Agent 回合，来源比界面好不好看更重要。安装记录也建议写进项目说明，方便以后回溯和复查。