浏览 AI 使用教程
操作教程

Codex拆分长任务:用文件迁移示例区分依赖和并行

从三个文档的迁移练习开始,明确前置材料、可并行工作、阻断条件和最后交接,避免把长任务拆成互不衔接的待办。

Codex项目开发与自动化工作流主视觉
本文目录 · 跳到当前步骤

长任务按依赖拆,而不是平均切成几段。“先整理文件,再修链接”仍太粗:不知道旧路径在哪里被引用,就不能确定迁移方案。

把同一个目标写成具体材料

以下是教学练习。新建一个副本目录,包含 docs/start.md、docs/fees.md 和 index.md。前两份可先写任意一句说明,index.md 写两条相对链接:

markdown
[开始](docs/start.md)
[费用](docs/fees.md)

目标是将两份文档移到 guides/ 下,首页链接继续可用。不改文件内容,不增加新栏目。最终交付是两个新路径、改好的 index.md 和旧新路径映射。

四个阶段为什么要这样衔接

阶段 必须已有的输入 本阶段产物 后续使用者
A 盘点 三个实际文件 旧路径、全部引用位置 B 和 C
B 拟迁移映射 A 的旧路径 docs/start.md → guides/start.md;fees 同理 D
C 定义检查 A 的引用位置与原文件内容 两个链接可打开、正文内容不变 D
D 执行与验证 B 映射、C 检查要求 迁移后的副本和检查记录 交接

B 与 C 可以并行,因为双方只读取 A 的结果。D 依赖两者,不能边猜新路径边执行。若 A 发现 guides/start.md 已存在,B 必须先说明冲突;这时不进入 D,也不擅自覆盖。

发给 Codex 的第一轮任务

text
只读当前练习目录。目标:把 docs/start.md 与 docs/fees.md 移至 guides/,保持首页链接有效。
先列文件及引用;输出 plan.md,包含旧新路径映射、冲突、可并行步骤与完成条件。
本轮只允许新增 plan.md,不移动原文件。若目录与描述不符,报告实际差异。

检查 plan.md 的每个新路径是否唯一、两个旧路径是否都有引用处理。随后可给出第二轮明确任务:“按已确认映射修改这个练习副本,同步首页链接,逐个打开链接并比较迁移前后正文;不发布。”

阶段完成要留下什么

教学预期:index.md 两条链接分别变为 guides/start.md 与 guides/fees.md;两份正文和迁移前一致。实际交付应记录检查方式与失败项。若只写“文件数仍为3”,无法发现链接仍指向 docs/ 的错误。

需求临时增加“顺便重写费用介绍”时,把它记成独立待办;它需要价格依据,不能混入只移动文件的阶段。

下一步

继续阅读与你当前问题相关的教程: