项目规划 27.8k 仓库 Star
Planning with Files
让长任务有条理
文件式任务规划是为多步骤工作保存记录的 Skill。它用计划、研究发现和进度文件记录目标、阶段、证据与失败尝试,减少长会话中遗漏前提或重复探索。重新开始时可先读取这些文件,再决定下一步;自动恢复还需配置对应宿主的 hooks。
你需要准备:任务目标、已有材料与工作目录
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
Planning with Files 能帮你做什么?
保存任务计划
把目标、阶段、关键决定和待处理事项写进计划文件,执行时按实际进展维护状态。
积累发现与证据
把调研结论、文件入口和错误尝试保存在独立记录中,便于后续判断从哪里继续。
恢复项目上下文
从同一项目的规划文件恢复工作;配置完成后可用 hooks 在合适时机提示或注入规划信息。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
分几天完成一个功能
例如记录已改模块、尚未解决的测试失败和下一步,下一次会话先核对文件再继续。
持续整理研究材料
例如分别保存研究问题、已读来源和待验证结论,避免随着对话变长反复查询同一内容。
怎么开始使用?
复杂任务与材料
准备这些材料多步骤任务规划
任务目标、已有材料与工作目录
持续可接续的计划
- 01
拆分目标与步骤
- 02
记录发现与进度
- 03
按当前计划继续
准备什么,会得到什么?
- 准备的材料
- 任务目标、已有材料与工作目录
- 交付的结果
- 记录阶段与状态的任务计划,以及独立的发现、进度文件。
- 能够追溯关键决定、错误尝试和下一步的项目工作记录。
使用前要知道
基础用法需要文件读写和完整模板资源;自动注入、恢复还需按 Codex Setup 配置并审核 hooks。它不会自动还原全部聊天,显式读取会话记录与基础文件恢复是不同功能。
常见问题
换一个会话后会恢复全部聊天吗?
默认依靠项目规划文件恢复目标和进度。额外读取本地会话记录需要使用上游明确的方式,不能把摘要记录等同完整聊天备份。
已有项目配置会被覆盖吗?
应保留现有计划与 hooks 配置,按上游说明合并必要内容。Windows 的自动化还需核对 Python、Git Bash 与脚本路径。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- planning-with-files · SKILL.md ↗2026-10-31 核对
- Planning with Files · Codex Setup ↗2026-10-31 核对
来源与使用条件
- 原始项目
- OthmanAdi/planning-with-files ↗
- Skill 名称
planning-with-files- Skill 目录
.agents/skills/planning-with-files- 仓库 Star
- 27,786 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- 以原项目许可为准
- 使用条件
- 基础规划需要可读写项目文件的 Codex 环境;完整目录包含脚本、模板及参考资料。自动注入与恢复需按 Codex Setup 合并 .codex/hooks.json 和相关脚本并审核 hooks,Windows 适配还使用 Python 与 Git Bash。
- 注意事项
- MIT 许可。用户指定的 .agents 目录已核到完整 scripts/templates 资源。已有计划和 hooks 配置须保留;基础文件规划与 hooks 自动恢复应分别检查。当前站点未安装或运行验证。
查看安装与使用提示词
请帮我准备并使用 Planning with Files Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/OthmanAdi/planning-with-files 所选目录:.agents/skills/planning-with-files 参考分支:master 原始目录 frontmatter name:planning-with-files 安装后的目标调用名:planning-with-files 来源页面:https://github.com/OthmanAdi/planning-with-files/tree/master/.agents/skills/planning-with-files 安装路线核对日期:2026-11-01 planning-with-files:当前源 SKILL.md:https://github.com/OthmanAdi/planning-with-files/blob/master/.agents/skills/planning-with-files/SKILL.md Planning with Files:当前 Codex 安装与 Hooks 适配:https://github.com/OthmanAdi/planning-with-files/blob/master/docs/codex.md OpenAI:Build skills(Skill目录、发现和插件):https://learn.chatgpt.com/docs/build-skills 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是上游专用安装路线。按下列说明保留完整仓库布局、关联 Skill 和运行资源;不要退回到只下载 SKILL.md。只有任务需要且上游要求时才安装整包,并说明实际包含的范围。 所选 Skill 的具体安装步骤: 1. 先读上游 docs/codex.md,选「项目独立安装」或「完整插件安装」一条路线;不叠加 standalone 和 plugin 两套生命周期 Hooks。 2. 项目独立路线:用系统 skill-installer,参数 --repo OthmanAdi/planning-with-files --path .agents/skills/planning-with-files --ref master --name planning-with-files --dest <项目根目录>/.agents/skills,保留完整目录。 3. 完整自动恢复需要同时按文档放置仓库 .codex/hooks/ 的内容到项目 .codex/hooks/,避免产生 .codex/hooks/hooks/ 多嵌套;先比较同名脚本,再把 .codex/hooks.json 的配置合并进现有文件,不覆盖已有 Hooks。 4. Windows 先检查可用 Bash/Git Bash、Python,以及文档的 PowerShell/薄适配脚本;按当前 Codex 原生 Hooks 信任界面检查来源与实际命令,不直接把 Claude frontmatter Hooks 当作 Codex 配置。 5. 只需文件式规划时可先仅安装核心目录,但须明确没有完成 Hooks 自动恢复;采用插件路线则按当前文档保留整插件及其 hooks/codex-hooks.json,不再安装独立 Hook。 6. Skill 目录变更会自动检测,未出现才开新聊天/重载;实际修改 Hooks 或宿主配置后按文档重载并检查 /hooks。不执行文档示例中的 git add、commit 或 push。 必须保留的资源: - .agents/skills/planning-with-files/(SKILL.md、templates/、scripts/、reference.md、examples.md、plan-inventory.md,完整保留) - .codex/hooks.json 与 .codex/hooks/(仅独立 Hooks 路线,须合并) - .codex-plugin/plugin.json 与 hooks/codex-hooks.json(插件替代路线,保留插件包) 已知依赖:基础规划需要可读写项目文件的 Codex 环境;完整目录包含脚本、模板及参考资料。自动注入与恢复需按 Codex Setup 合并 .codex/hooks.json 和相关脚本并审核 hooks,Windows 适配还使用 Python 与 Git Bash。 原项目许可:以原项目许可文件为准 特别条件:MIT 许可。用户指定的 .agents 目录已核到完整 scripts/templates 资源。已有计划和 hooks 配置须保留;基础文件规划与 hooks 自动恢复应分别检查。当前站点未安装或运行验证。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 核对 name=planning-with-files、templates/ 和 scripts/ 完整,逐个检查 JSON 配置可解析、Hook 命令解析到实际文件。 2. 检查 python --version、Bash/Git Bash 可用性和实际脚本位置;读取 /hooks 中的来源与 matcher,不为了验收触发生命周期任务。 3. 不要用 init-session.sh --help 作为安装检查,它可能被当作任务名称并创建规划文件;此阶段不新建或改写用户规划。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $planning-with-files;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 提供真实复杂任务和项目路径,先查已有 task_plan.md、findings.md、progress.md;能续接则先读再继续,不能把已有文件清空。 - 实际需要新计划时才运行当前文档的初始化脚本,规划放任务目录而非 Skill 安装目录;一个工作目录避免多个执行者同时改计划。 我想完成的任务: 把我的复杂任务拆成可执行计划,持续记录发现、进度和下一步。先按 Codex Setup 检查完整 Skill 目录及项目文件;基础规划先以本地文件开展。确需生命周期自动恢复时,再检查并合并现有 hooks 配置,不能直接覆盖。保留已有计划,不自行读取其他任务或本地会话记录。 需要我提供的材料: 任务目标、已有材料与工作目录 期望得到: 与当前任务对应的计划、发现和进度文件,清楚说明已完成步骤、未解决事项及下一步;区分手动文件恢复与实际已配置的 hooks 自动恢复。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。