新增页面特别容易出两个问题:任务太空导致 Codex 乱补东西,以及路由、入口、样式范围没说清。本模板库直接给你能复制的文案。
> 前置教程:怎样写一个合格的 Codex 任务
> 如果你还没有建立目标、范围、禁止事项和汇报格式的基本意识,先完成前置教程。
核心原则
新增页面任务的基石:明确路径、明确内容、复用组件、控制范围。
1. 通用新增页面模板
适合静态介绍页、教程详情页、帮助页等。
``markdown
请完成一个“新增页面”任务。
任务目标
请新增一个页面,页面名称是:【这里写页面名称】。
页面用途是:【这里写用途】。
预期结果
完成后,我希望看到:
- 页面可以正常访问。
- 请优先只修改与该页面直接相关的文件。
- 不要提交 Git。
- 新增/修改的文件及作用:
- 访问路径:
- 主要内容:
- 是否新增了导航入口:
- Git 状态与 diff 总结:
- 还需要我人工确认什么:
- 标题:【标题】
- 优先只新增该页面及必要的最小入口。
- 页面包含区域:【逐条写】
- 不要引入新的设计风格。
- 写清访问路径、内容范围和导航要求。
2. 页面包含这些内容:【这里写模块或文案要点】。
3. 页面风格应当与现有站点保持一致。
修改范围
2. 如果需要新增路由或导航入口,请先说明会改哪些文件。
3. 不要顺手重构全站布局,不要修改无关页面。
4. 不要安装新依赖,除非先说明原因。
禁止事项
2. 不要修改无关组件,不要顺手优化整个样式系统。
3. 不要改数据库、接口和鉴权逻辑。
不确定时
如果你不确定目录、路由或需要修改多个共享文件,请先停下来告诉我,不要猜。
完成后汇报格式
修改摘要
页面结果
检查结果
风险提示
`
2. 静态/教程类页面模板
适合 Astro、Nuxt 静态页任务。
`markdown
请新增一个静态页面。
任务目标:
新增页面【名称】,访问路径希望是【路径】。
页面内容要求:
2. 副标题:【副标题】
3. 主体区块:【逐条写】
4. 文案先按我给的内容来,不要自行扩写太多。
范围限制:
2. 不要重做首页,不要调整全站头尾或主题系统。
`
3. 后台/内容管理页面模板
适合列表页、说明页、简单表单页。
`markdown
请新增一个后台页面。
任务目标:
新增【页面名称】页面,用于【用途】。
页面要求:
2. 保持和现有后台页面一致的布局和风格。
3. 优先参考现有实现方式,复用现有布局和组件。
范围限制:
2. 不要修改无关菜单。
`
写任务时最容易漏掉的 5 件事
1. 访问路径 (Route)
尽量明确:访问路径希望是 /about。
2. 导航入口 (Entry)
明确是只增页面,还是同时要把入口加到菜单。
3. 内容模块 (Modules)
告诉 Codex 页面里至少该有什么(标题、简介、CTA 按钮等)。
4. 视觉参考 (Visual Ref)
明确要求风格与现有首页或文档系统一致。
5. 确认不确定的点 (Clarification)
要求 Codex 在不确定复用哪个组件时先提问。
进阶技巧:先分析,后施工
第一步先让它只读分析:
请先只读分析当前项目里新增页面通常放在哪个目录、路由组织方式、是否有可复用布局。不要修改文件。`
第二步再让它真正新增页面。
总结
做到这里,满足下面 3 条就说明你会用模板了:
2. 明确了可修改文件、禁止事项和视觉参考。
3. 包含构建、访问和移动端等验收要求。