planning-with-files 怎么安装？Codex/Claude Code 长任务规划教程

安装 planning-with-files 先选范围：团队共享装到项目 .codex/，个人长期用装到 ~/.codex/。官方 Codex 文档给了两条路线，区别不在命令长短，而在谁能复用。项目安装会把 .codex/ 提交进仓库，团队成员拉代码就能看到同一套 Skill 和 hooks；个人安装只影响本机，适合自己在多个项目之间复用。

团队项目怎么装

在项目根目录执行官方文档里的流程：git clone OthmanAdi/planning-with-files 到 /tmp/planning-with-files，再 cp -r /tmp/planning-with-files/.codex .，随后 git add .codex/，提交并推送。这个路径的检查点是仓库里出现 .codex/skills/planning-with-files/、.codex/hooks.json 和 .codex/hooks/。装完先看 Git Diff，确认没有覆盖业务文件。

个人安装步骤

1. 克隆官方仓库到 /tmp/planning-with-files。
2. 复制 .codex/skills/planning-with-files 到 ~/.codex/skills/。
3. 复制 .codex/hooks/ 到 ~/.codex/hooks/。
4. 已有 ~/.codex/hooks.json 时手动合并，不要直接覆盖。
5. 在 ~/.codex/config.toml 的 features 下启用 hooks = true。

验证时看三处：codex --version 能运行，codex features list 能看到 hooks 或旧别名 codex_hooks，ls 能找到 ~/.codex/skills/planning-with-files/SKILL.md 和 hooks 文件。若某一步不一致，先回官方 docs/codex.md 对照，版本要求以官方文档为准。

安装失败常见原因

最容易出错的是把全局 hooks.json 覆盖掉，导致原有自动化失效；其次是忘记重启 Codex，hooks 没有重新加载；还有一种是项目和全局都装了一份，提醒消息重复出现。遇到这种情况，按文档保留一个入口，再用 Git Diff 和 ls 检查文件位置。

Claude Code 的路径又不同。README 给出的 plugin 方式会带来 /plan、/plan:status 等命令入口；npx skills add 更像通用 Skill 安装，不一定带 commands/ 文件夹。你要的是自动补全，就看 plugin；只想让 Agent 按 SKILL.md 工作，就按 Skills CLI。两条路不要混着猜，命令和可用功能以官方 README 为准。

装好后做一次小任务更可靠：让 Agent 为一个安全分支写计划、改一行无害文件、更新 progress.md，再撤回测试改动。这个动作能同时验证 Skill、hooks、文件权限和 Git 检查点。若计划文件没变化，说明安装存在问题，不要直接交给它跑大规模重构。团队仓库还要把新增配置走一次代码评审，防止 hooks 影响其他人的本地流程。