准备材料:先把边界说清楚

给 Agent 的材料越具体,后续返工越少。材料不必一次做到完美,但应把事实、版本和公开范围区分开。

必备材料

材料 需要说明的内容 公开前检查
项目说明 研究问题、对象、读者与预期网页 标题和结论是否准确
正文 已完成的报告、方法说明或摘要 引用、版权与事实来源
代码 已运行的脚本与环境说明 是否含路径、密钥或受限数据
图表 最终采用的表图及解释 变量、单位和截图来源
数据字典 字段含义、类型和可公开示例 不上传个人信息或原始敏感数据

参考网站与验收标准

提供 1–3 个参考网站即可。应说明借鉴的是导航、信息密度还是版式,而不是要求复制文字、Logo 或 CSS。还应写明:哪些页面必须有、哪些文件可下载、是否需要手机端检查,以及最终的公开网址规则。

三类不能让 Agent 猜的事情

  1. 内容真实性:结论、样本范围、变量定义和图表数字必须由作者确认。
  2. 公开权限:数据、图片、论文附件与第三方材料能否公开,需要由有权决定的人确认。
  3. 验收边界:GitHub 登录、建仓权限、Pages 设置及最终发布确认属于人工节点。

下载后如何填写

项目说明模板 开始。把项目目标、材料清单、公开边界和验收条件填入同一份文件,再提交给 Agent。数据字段可参照 数据字典模板