长任务按依赖拆,而不是平均切成几段。“先整理文件,再修链接”仍太粗:不知道旧路径在哪里被引用,就不能确定迁移方案。
把同一个目标写成具体材料
以下是教学练习。新建一个副本目录,包含 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/ 的错误。
需求临时增加“顺便重写费用介绍”时,把它记成独立待办;它需要价格依据,不能混入只移动文件的阶段。
下一步
继续阅读与你当前问题相关的教程:


