新增页面任务模板

很多用户第一次让 Codex 做“稍微大一点”的事，通常就是新增一个页面。

但新增页面特别容易出两个问题：

任务说得太空，Codex 自己补了很多你没要的东西。
页面做出来了，但路由、入口、文案、样式范围没有说清楚。

所以这一篇不给你讲抽象原则，直接给你能复制的模板。

前置教程：怎样写一个合格的 Codex 任务
如果你还没有建立目标、范围、禁止事项和汇报格式的基本意识，先完成前置教程，再回到本篇。

依据来源：OpenAI Codex 官方手册中关于任务描述、范围控制、结果汇报和最小修改原则的说明。

什么时候用这份模板

适合这些场景：

新增一个静态介绍页
新增一个教程详情页
新增一个简单后台内容页
新增一个帮助页、关于页、说明页

不适合这些场景：

新增复杂登录注册流程
新增整套权限系统
新增多接口联动的大功能
一次做完整商城页面群

如果你的任务已经涉及多个页面、多个接口、多个状态流，就不该用单页模板了。

模板 1：最通用的新增页面模板

直接复制，替换中括号里的变量：

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

## 任务目标
请新增一个页面，页面名称是：【这里写页面名称】。
页面用途是：【这里写用途，例如“展示课程介绍”“展示关于我们”“新增帮助页”】。

## 预期结果
完成后，我希望看到：
1. 页面可以正常访问。
2. 页面包含这些内容：【这里写模块或文案要点】。
3. 页面风格应当与现有站点保持一致。

## 修改范围
1. 请优先只修改与该页面直接相关的文件。
2. 如果需要新增路由或导航入口，请先说明会改哪些文件。
3. 不要顺手重构全站布局。
4. 不要修改无关页面。
5. 不要安装新依赖，除非你先说明原因。

## 禁止事项
1. 不要提交 Git。
2. 不要修改无关组件。
3. 不要顺手优化整个样式系统。
4. 不要改数据库、接口和鉴权逻辑，除非本任务明确要求。

## 不确定时
如果你不确定页面应该放在哪个目录、是否需要路由入口，或者需要修改多个共享文件，请先停下来告诉我，不要猜。

## 完成后请按下面格式汇报
### 修改摘要
- 新增了哪些文件：
- 修改了哪些已有文件：
- 每个文件的作用是什么：

### 页面结果
- 页面访问路径：
- 页面包含哪些主要内容：
- 是否新增了导航入口：

### 检查结果
- Git 状态：
- diff 大意：
- 是否存在超出任务范围的改动：

### 风险提示
- 还需要我人工确认什么：

模板 2：静态站点新增页面

适合 Astro、Nuxt 静态页、Vite 静态内容页这类任务。

请新增一个静态页面。

任务目标：
新增页面【这里写名称】，访问路径希望是【这里写路径】。

页面内容要求：
1. 页面标题是：【这里写标题】
2. 页面副标题是：【这里写副标题】
3. 页面主体包含这些区块：【这里逐条写】
4. 页面文案先按我给的内容来，不要自行扩写太多营销内容

范围限制：
1. 优先只新增该页面及必要的最小入口。
2. 不要重做首页。
3. 不要顺手调整全站头部、底部或主题系统。
4. 如果必须复用现有组件，请先说明会用哪个组件。

完成后请汇报：
1. 页面路径
2. 新增或修改的文件
3. 页面结构说明
4. Git diff 总结

模板 3：后台普通内容页

适合“新增一个列表页”“新增一个说明页”“新增一个简单表单页”。

请新增一个后台页面。

任务目标：
新增【这里写页面名称】页面，用于【这里写用途】。

页面要求：
1. 页面包含这些区域：【逐条写】
2. 保持和现有后台页面一致的布局和风格
3. 如果现有项目已有相似页面，请优先参考现有实现方式

范围限制：
1. 优先复用现有布局和组件。
2. 不要引入新的设计风格。
3. 不要修改无关菜单。
4. 如果需要新增路由或菜单项，请先说明改动位置。

完成后请汇报：
- 页面入口
- 涉及文件
- 是否复用了现有组件
- 当前是否只完成静态页面，还是已接真实数据

写新增页面任务时，最容易漏掉的 5 件事

1. 没写访问路径

如果你不写，Codex 可能自己决定页面位置。

所以尽量明确：

访问路径希望是 /about

或者：

新增到课程模块下的某个子路由

2. 没写是否要加导航入口

新增页面和“新增页面入口”不是一回事。

你要明确：

本次只新增页面，不新增导航入口

或者：

本次需要同时把入口加到顶部导航

3. 没写页面内容范围

你要告诉 Codex 页面里至少该有什么。

比如：

页面包含标题、简介、三段教程说明和一个 CTA 按钮

不要只说“新增一个页面”，太空了。

4. 没写风格参考

新增页面最怕风格跑偏。

你可以直接写：

页面风格请保持与现有首页或当前文档系统一致。

5. 没写“不确定时先问”

这个在新增页面任务里尤其重要。

因为它经常会涉及：

路由
组件复用
导航入口
布局继承

所以一定补一句：

如果你不确定该复用哪个组件或是否需要改导航，请先问我。

一个更专业的小习惯

如果你是第一次让 Codex 新增页面，可以先分两步：

第一步先让它只读分析：

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

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

这样成功率会高很多。

下一步该看什么

建议接着看：

这样你就能把“模板”和“真实案例”连起来用。