发布流程：Agent 做什么，用户做什么

整个流程可分为六步。自然语言任务书是控制界面；它替代的是逐条手写配置的负担，不替代研究责任。

1. 整理材料：用户提供项目说明、正文、代码、已生成的表图、参考网站和公开边界。
2. 搭建项目：Agent 创建页面、导航、样式、模板和 README.md，并保留可维护的源文件。
3. 本地渲染：Agent 运行 quarto render，检查生成的 docs/、页面标题、链接和资源路径。
4. 人工复核：用户确认内容、数据权限、版权和网站是否准确表达项目。
5. Git 推送：Agent 创建或更新任务指定的仓库，提交源文件及已经渲染的静态网页。
6. Pages 设置与验证：用户在 GitHub 网页端选择 main/docs；部署完成后，Agent 再检查线上网址。

为什么不在 GitHub Actions 中重跑分析

本模板只发布静态结果。对 Stata 项目，估计通常应在本地完成：GitHub Actions 没有你的 Stata 许可证，也不应接触受限数据。R 与 Python 项目可以另行配置可复现环境，但这属于扩展工作，不能用来掩盖本地结果尚未核验的问题。

Website 与 Online book

成品	读者的主要任务	更适合的内容
Website	快速理解一个项目并访问入口	简历作品、行业研究、数据产品、项目展示
Online book	连续阅读一套章节	课程讲义、系统报告、方法教程

可参考 China Policy Shocks 的 website 导航，以及 Stata × AI 的 book 结构。它们适合用来理解信息组织，不应用作复制素材。