Skip to content

自主循环 Prompt

这类 prompt 不是普通的问答模板,而是给高自主代理使用的“工作协议”。

它的目标通常是让代理在没有人持续盯着的情况下,按固定节奏处理 PR、issue、验证和提交流程。

什么时候需要这种 prompt

  • 你希望代理按迭代节奏持续推进仓库任务
  • 你需要它先处理存量 PR,再接新 issue
  • 你需要它遵守明确的安全边界和停止条件

如果只是一次性的代码生成或文档整理,不需要上这种重量级模板。

一个好的自主循环 prompt 应该约束什么

1. 回合预算

要明确每次迭代能花多少步,不允许无限试错。

2. 安全边界

至少要写清这些事情:

  • 不能直接改主分支
  • 不能跑破坏性命令
  • 哪些文件或配置不能碰
  • 什么时候必须停下来交还控制权

3. 固定执行顺序

顺序通常比“让模型自己想”更重要。例如:

  1. 先看 PR
  2. 再看 CI
  3. 再处理 review
  4. 最后才接新 issue

4. 验证门槛

要写明:

  • 本地要跑哪些测试
  • 最多允许几轮修复
  • 什么时候需要标记人工介入

5. 输出动作

代理在没做完时,至少应该留下:

  • 进展说明
  • 阻塞原因
  • 下一轮从哪里继续

一个可复用骨架

text
你是一个在仓库中自主工作的代理。

回合预算:
- 每轮最多 25 步
- 到预算时必须总结剩余工作并退出本轮

安全约束:
- 不直接推 main
- 不运行破坏性命令
- 不修改核心架构规则和 CI 配置

每轮顺序:
1. 先检查未完成 PR
2. 优先修复失败检查
3. 处理 review 反馈
4. 再选择一个新问题推进
5. 完成后运行验证并提交 PR

停止条件:
- 发现安全约束冲突
- 仓库处于无法恢复的损坏状态
- 需要人类做架构决策

设计这类 prompt 的实战原则

  • 不要把规则写成一大坨背景介绍,优先写成可以执行的流程
  • 不要假设代理“知道什么时候该停”,停止条件必须显式写出
  • 不要让它同时追太多目标,一轮只推进少量事项更稳

适合继续补充的内容

  • PR review 处理规范
  • CI 失败分类与修复策略
  • 需要人工升级的问题清单
  • 不同仓库类型的专用版本

Built with VitePress and deployed via GitHub Actions.