Codex 教程 01：写出可执行的任务描述（目标/约束/验收）

把需求从“想法”变成“可交付任务”：目标、边界、输出格式与验收标准一并写清。

你将学到什么

本篇把Codex 教程 01：写出可执行的任务描述（目标/约束/验收）拆成可复用模板：目标、范围、约束、输出格式、验收标准。只要按这个结构写，你就能把任务从“聊天”变成“工程交付”。

你将获得

可复用的模板
可执行的步骤
可验证的清单
可回滚的策略

适合人群

希望把 AI 变成稳定生产力的开发者
需要为团队沉淀规范的人
正在做多页面内容站/工程项目的人

任务描述五件套

目标：做什么？最终用户价值是什么？
范围：改哪些、不改哪些（目录/模块/页面）
约束：风格、依赖、性能、安全、时间
输出：要交付哪些文件/哪些页面/哪些命令
验收：如何证明完成（清单/测试/截图/对比）

高质量提示词示例

背景：这是一个多页面静态内容站（HTML + Tailwind），已完成首页。
任务：新增“下载中心”页面，包含 Windows/macOS/Linux 下载入口与 CLI 安装命令。
约束：保持现有配色与组件；图片只用本地 webp；所有新增页面必须有独立 SEO meta；不得引入新依赖。
输出：1) 新页面的结构与内容（含下载链接） 2) 导航与站点地图更新 3) 校验清单。
验收：点击导航到下载页可访问，SEO meta 齐全，链接可打开，图片启用懒加载。

把验收标准写成脚本

最稳的做法是把验收清单写成脚本（构建期检查每页 meta、链接存在、站点地图生成）。这样每次改动都能自动发现“缺 meta / 断链 / 重复页面”等问题。

常见错误与修正

错误 1：目标模糊

“做得更好看/更丰富”没有边界，导致输出飘。

修正：写成可量化

“每页≥10个段落、≥2个表格/卡片模块、含FAQ与相关链接”。

检查清单

通用验收清单

导航链接：点击可达、无同内容页面、无死链
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、检查链接与内容密度，并持续扩展长尾专题。

Codex 教程 01：写出可执行的任务描述（目标/约束/验收）