新增页面特别容易出两个问题:任务太空导致 Codex 乱补东西,以及路由、入口、样式范围没说清。本模板库直接给你能复制的文案。

> 前置教程:怎样写一个合格的 Codex 任务

> 如果你还没有建立目标、范围、禁止事项和汇报格式的基本意识,先完成前置教程。

核心原则

新增页面任务的基石:明确路径、明确内容、复用组件、控制范围

1. 通用新增页面模板

适合静态介绍页、教程详情页、帮助页等。

``markdown

请完成一个“新增页面”任务。

任务目标

请新增一个页面,页面名称是:【这里写页面名称】。

页面用途是:【这里写用途】。

预期结果

完成后,我希望看到:

  1. 页面可以正常访问。
  2. 2. 页面包含这些内容:【这里写模块或文案要点】。

    3. 页面风格应当与现有站点保持一致。

    修改范围

    1. 请优先只修改与该页面直接相关的文件。
    2. 2. 如果需要新增路由或导航入口,请先说明会改哪些文件。

      3. 不要顺手重构全站布局,不要修改无关页面。

      4. 不要安装新依赖,除非先说明原因。

      禁止事项

      1. 不要提交 Git。
      2. 2. 不要修改无关组件,不要顺手优化整个样式系统。

        3. 不要改数据库、接口和鉴权逻辑。

        不确定时

        如果你不确定目录、路由或需要修改多个共享文件,请先停下来告诉我,不要猜。

        完成后汇报格式

        修改摘要

        • 新增/修改的文件及作用:
        • 页面结果

        • 访问路径:
        • 主要内容:
        • 是否新增了导航入口:
        • 检查结果

        • Git 状态与 diff 总结:
        • 风险提示

        • 还需要我人工确认什么:
        • `

        2. 静态/教程类页面模板

        适合 Astro、Nuxt 静态页任务。

        `markdown

        请新增一个静态页面。

        任务目标:

        新增页面【名称】,访问路径希望是【路径】。

        页面内容要求:

        1. 标题:【标题】
        2. 2. 副标题:【副标题】

          3. 主体区块:【逐条写】

          4. 文案先按我给的内容来,不要自行扩写太多。

          范围限制:

          1. 优先只新增该页面及必要的最小入口。
          2. 2. 不要重做首页,不要调整全站头尾或主题系统。

            `

            3. 后台/内容管理页面模板

            适合列表页、说明页、简单表单页。

            `markdown

            请新增一个后台页面。

            任务目标:

            新增【页面名称】页面,用于【用途】。

            页面要求:

            1. 页面包含区域:【逐条写】
            2. 2. 保持和现有后台页面一致的布局和风格。

              3. 优先参考现有实现方式,复用现有布局和组件。

              范围限制:

              1. 不要引入新的设计风格。
              2. 2. 不要修改无关菜单。

                `

                写任务时最容易漏掉的 5 件事

                1. 访问路径 (Route)

                尽量明确:访问路径希望是 /about

                2. 导航入口 (Entry)

                明确是只增页面,还是同时要把入口加到菜单。

                3. 内容模块 (Modules)

                告诉 Codex 页面里至少该有什么(标题、简介、CTA 按钮等)。

                4. 视觉参考 (Visual Ref)

                明确要求风格与现有首页或文档系统一致。

                5. 确认不确定的点 (Clarification)

                要求 Codex 在不确定复用哪个组件时先提问。

                进阶技巧:先分析,后施工

                第一步先让它只读分析:

                请先只读分析当前项目里新增页面通常放在哪个目录、路由组织方式、是否有可复用布局。不要修改文件。`

                第二步再让它真正新增页面。

                总结

                做到这里,满足下面 3 条就说明你会用模板了:

                1. 写清访问路径、内容范围和导航要求。
                2. 2. 明确了可修改文件、禁止事项和视觉参考。

                  3. 包含构建、访问和移动端等验收要求。