Codex 教程 07：重构与技术债治理（分批/对比/风险控制）
重构不是“变漂亮”，而是可维护性工程：分批交付、对比证明、风险可控。
你将学到什么
重构的精髓是“分批交付 + 可回滚 + 有对比”。本篇给你一套把大改拆成小 PR 的方法，并告诉你怎么证明重构是值得的。
你将获得
- 可复用的模板
- 可执行的步骤
- 可验证的清单
- 可回滚的策略
适合人群
- 希望把 AI 变成稳定生产力的开发者
- 需要为团队沉淀规范的人
- 正在做多页面内容站/工程项目的人
分批策略
- 1) 先统一目录与命名
- 2) 抽公共布局（header/footer）
- 3) 把重复内容变成数据驱动
- 4) 最后再优化样式与体验
前后对比怎么写
Before
模板化页面多、内容同质、修改成本高
After
多模板布局 + 数据驱动内容 + 构建期校验
检查清单
通用验收清单
- 导航链接：点击可达、无同内容页面、无死链
- SEO：每页独立 title/description/keywords/canonical/og/robots
- 结构：H1 仅一个，H2/H3 语义清晰，段落足够长
- 性能：图片本地 webp + lazy-load + decoding=async
- 可维护：内容/模板集中管理，支持批量重建
前置条件与准备
- 明确当前页面/功能的‘唯一主题’（避免同质化）
- 准备一份验收清单（SEO/链接/内容/性能）
- 所有外链优先指向官方或可验证来源
- 每次改动都能重新生成并抽样检查关键页面
练习与作业
练习 A（10 分钟）
为站点新增一个‘专题页’，要求包含：表格 + FAQ + 相关链接。
练习 B（30 分钟）
为该专题页补齐 SEO meta，并将其加入站点地图与教程中心的相关链接。
相关链接
高频问答
如何判断页面内容是否足够‘丰富’？
至少包含：清晰的 H2/H3、多个段落、可执行步骤、示例/命令/表格/FAQ，并且与主题强相关。
为什么布局要做差异化？
布局差异化能降低模板感，提升阅读体验；同时让搜索引擎更容易区分页面意图与主题。
如何保持资料‘最新’？
关键链接与规格尽量指向官方来源；页面标注更新时间，并定期检查外链与版本信息。
如何避免‘越写越宽、越看越累’？
用更窄的内容容器（max-w-6xl/5xl）、更好的行高、更多分段与模块化卡片，让长文更精致。
进阶扩展
下一步建议：把本教程里的‘模板/清单/示例’固化为仓库内的文档与脚本。这样任何人接手都能按同一标准生成页面、校验 SEO、检查链接与内容密度，并持续扩展长尾专题。
