任务模板:用自然语言交代成品

下面的模板可以直接提交给 Codex 或同类本地编码 Agent。实际使用时,替换方括号中的内容,并删除不适用部分。

请把 [项目名称] 整理为一个 Quarto website,并发布到 GitHub Pages。

项目目标:
- 读者是谁:[例如招聘方、课程同学或行业研究读者]
- 首页应在一分钟内说明:[问题、材料、方法、主要结果或下载入口]
- 参考网站:[URL]。只参考导航和信息密度,不复制文字、图片、Logo 或 CSS。

我提供的材料:
- 正文或项目说明:[文件路径]
- 代码和已生成图表:[文件路径]
- 可公开的数据或数据字典:[文件路径]
- 不得公开的内容:[具体说明]

网站结构:
- 首页:[内容]
- 方法或工作流页:[内容]
- 数据或材料页:[内容]
- 结果、下载或参考资料页:[内容]

技术与发布约束:
- 使用 Quarto website;渲染输出到 docs/。
- 所有链接和资源使用相对路径;不要写入本地绝对路径、Token 或个人信息。
- 先本地渲染并检查桌面端、手机端、内部链接和下载链接。
- 创建 Git 仓库、提交并推送前,检查公开文件中没有受限数据、密钥、缓存和日志。
- GitHub Pages 需要我在网页端设置时,明确暂停并告诉我具体操作。

验收标准:
- 本地 quarto render 成功;docs/ 中有首页和全部子页。
- 远程仓库结构完整,README 说明如何复用。
- Pages 上线后,首页、子页面、GitHub 链接与下载链接均可访问。
- 请记录真实执行时间、失败项和需要我人工确认的节点;不要编造已完成的线上验证。

完整模板文件也可直接下载:Agent 建站任务书

为什么任务书比命令更重要

Agent 可以生成 git、Quarto 和 HTML 的技术步骤,但无法替作者决定研究结论、数据权限或公开范围。任务书把这些决定提前写明,才能让自动化有边界,也让后续维护者知道应该检查什么。