通宵构建提示词
完整模板位于 references/overnight-build-template.md。在组合之前请先阅读它。 不要凭记忆重新推导规则结构——根据用户的具体情况填写其 [括号] 部分,并保留他们对自身副本所做的任何编辑。
不可妥协的条件
每个输出必须包含规则 8(应对使用额度重置)和启动器部分。它们是使构建可重新启动的关键;缺少它们的提示词会在第一次使用额度重置后默默地从零开始,从而浪费一夜。
组合步骤
- 阅读模板。 如果用户保留了一份编辑过的副本,则以他们的版本为准——保留他们的更改。
- 填写规格说明——构建什么、上下文、设计要求、技术要求、按优先级排序的功能、种子数据、部署、成功标准。这里的详细程度决定了整个夜晚的质量;模糊的规格会带来模糊的一夜。
- 设置阶段——4 到 8 个阶段,每个阶段可独立完成并可验证,且时间分配要总和等于预算。
- 填写 pivot 应对手册,在模板已有条目基础上添加项目特定的阻塞项。
- 询问一次他们想要哪种启动器(A:操作系统调度器 · B:bash 循环 · C:定时任务 MCP),如果请求中没有说明。询问一次——然后继续。
- 输出为一个可复制的代码块,并提醒他们在启动之前将其保存到项目根目录下的
overnight-build-prompt.txt。
完成信号
提示词必须指示构建在其最后一行输出 BUILD_COMPLETE——bash 循环启动器会 grep 该字符串以决定是否退出。在提示词中明确指出:当任何 P0(最高优先级)标准确实未被满足时,不输出 BUILD_COMPLETE 是正确的做法。一个在未完成构建时就退出的启动器比一个持续运行的要糟糕。
安全护栏
一个无人值守的代理没有可以询问的人,因此提示词必须自带边界。
如果目标是现有的生产代码库,则首先推导出文件所有权和禁止修改列表(fleet-brief 技能可同时提供这两者),并将项目的验证检查纳入测试阶段,以便“完成”意味着经过验证,而不仅仅是合并。
永远不要让通宵提示词授权执行数据库迁移、推送 schema、通过托管 CLI 部署、购买或发布电话号码或域名,或向真实联系人发送出站消息。这些操作需要有人在清醒状态下进行。将项目自身的不可逆操作也添加到该列表中。
构建必须生成的交付物
BUILD_LOG.md——包含阶段条目、决策、pivot 应对、已知问题,以及带有确切下一步骤的## CHECKPOINT — <ISO>代码块RESEARCH_NOTES.md——实施开始前的研究发现
在恢复时,构建的第一个操作就是从头到尾读取 BUILD_LOG.md,并从最新的检查点继续——绝不要重新研究、重新搭建或重新开始。