关于 gauntlet-loop
gauntlet-loop 是一项 Agent 技能,可将目标或计划转为可直接粘贴的系统提示词,组织角色分离、以证据为依据的工作循环。它适合需要委派复杂任务但不在此技能中执行计划的场景。
主要功能
- 01处理目标与计划输入
- 02提取验收标准和证据
- 03分离实施者与盲审者
- 04设置人工关卡与安全停止规则
- 05按指定模板生成提示词
适用场景
- 01根据项目计划生成工作提示词
- 02为目标设定可衡量的审查标准
- 03将实施与评估分开
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nicholasspisak/ gauntlet-loop --skill gauntlet-loop安装后在 Claude Code 中输入/gauntlet-loop确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/critic-contract.mddelegation-contract.mdprompt-template.md详细介绍
Gauntlet Loop
概述
Gauntlet Loop 可将任意目标或计划文档转换为经过全面优化、可直接复制粘贴的系统提示词,通过三个彼此分离的角色来执行任务:
- 编排者/批评者(Claude):拆解任务、分派工作、裁定证据——绝不负责实现。
- 实现者(Codex):通过块结构的委派契约产出所有成果。
- 盲审者(新上下文子 Agent):严苛的审查者,绝不会看到实现者的自我评估;他们会反复循环审查工作,直到证据——而非说法——达标。
核心原则:**负责实现的 Agent 绝不评判自己的工作;看过先前草稿的批评者绝不评判重试稿;标准必须切实可行——批评者能够据此评判工作,而不是“把它做得很棒”。**该模式扩展自 Matt Shumer 的 Gauntlet Loop(somethingbig.ai/gauntlet-loop)。
输出内容就是生成的系统提示词本身,放在一个围栏代码块中,可直接粘贴到新的会话中。不要执行计划。
输入处理
只接受一个输入,形式可以是以下三种之一:
- 内联目标——命令后的自由文本。直接将其作为任务目标。
- Markdown 文件——读取文件,并将其视为唯一事实来源计划。
- HTML 文件——读取文件并提取有意义的内容(标题、列表、表格、检查清单);忽略标记、导航和样式。
如果未提供输入,请索要一个——这是唯一可以提出的问题。
分析阶段(编写提示词之前)
按以下顺序从输入中提取:
- 任务目标——用一段话说明最终目标,并将源文档指定为唯一事实来源。说明要做什么,绝不说明如何做:架构由实现者负责。
- 验收标准/证据——列出每个复选框、关卡、SLA、指标或“完成意味着”的声明。这些将成为批评者的评判标准。如果输入中没有,则根据目标推导出 3–7 条可衡量的标准,并标记为
DERIVED — confirm before running。 - 参考标准——用于并排比较的具体范例:生产应用、已发布的竞品、基准截图、典范文档。只要质量有一部分偏主观(UI、写作、设计),就必须提供。模糊的目标不合格。如果输入中没有提及,则选择最强的真实范例类型,并标记为
DERIVED。 - 人工关卡——审批、签核、供应商合同、凭据配置、支出、上线发布、不可逆变更。这些都是循环绝不能越过的硬性停止点。
- 安全不变量——机密信息/PII 规则、范围边界、绝不能触碰的系统,以及任何使用“绝不”或“不要”措辞的内容。
- 执行顺序与并行拆分点——拆解成可以分别改进和评判的最小部分;识别哪些必须按关卡顺序执行,哪些可以并行独立验证(逐项检查、测试矩阵、逐主机部署)。
输出约定
输出一个代码围栏,其中包含根据 references/prompt-template.md 中的规范模板组装而成的完整系统提示词,并按以下顺序包含这些部分:
- 使命——根据分析 §1 填写(目标,而非实现方式)。
- 标准——验收标准(§2)加上参考标准(§3):批评者要与什么进行比较,采用并排、盲审的方式。
- 角色划分——硬性边界——协调者绝不实现;Codex 是唯一的实现者;批评者须盲审。
- 循环——6 步循环(约定 → 实现 → 盲审 → 使用
task --resume-last迭代,并启用全新批评者 → 对高风险事项征求对抗性第二意见 → 标记并记录),并以标准为依据。不得任意限制迭代次数。 - Codex 委派约定——采用 references/delegation-contract.md 中的 XML 模板,并根据分析 §5 填写
<action_safety>,根据分析 §4 填写<default_follow_through_policy>中的 STOP 列表。 - 批评者约定——采用 references/critic-contract.md 中的内容,并以标准为依据。
- 分流图——根据分析 §6 列出顺序门槛和并行面。
- 进度台账——协调者维护实时的
workbench.md(或 HTML 页面),记录各事项的状态和评审结论,以便人工监控而不打断流程。 - 硬性停止条件——列出分析 §4 和 §5 中的内容,并说明它们的优先级高于循环。
- 完成定义——每项标准都经批评者验证;仓库检查全部通过;对集成后的整体进行最后一轮润色;并列出所有仍待人工处理的门槛。
代码块后最多添加三个项目符号,指出发现的缺口(验收标准缺失、门槛含糊、推导出的假设)。除此之外不添加任何内容——不重述提示词,不提出代为执行。
快速参考
| 输入 | 操作 |
|---|---|
/gauntlet-loop build X to Y standard | 行内目标 → 推导标准,并标记为 DERIVED |
/gauntlet-loop docs/plan.md | 读取文件,逐字提取门槛和证据 |
/gauntlet-loop spec.html | 读取文件,剥除标记,然后按上述方式处理 |
| 无参数 | 仅在此时询问目标或文件 |
常见错误
- 执行计划,而不是输出提示词。 交付内容是可供复制粘贴的文本。
- 让循环凌驾于人工门槛之上。 “持续推进,直到完美”绝不能自行批准签字;硬性停止条件的优先级高于持续推进。
- 质量标准过于概括。 “高质量”不算标准。应让批评者依据文档自身的核对项、数字和 SLA,以及具体的主观质量参考范例进行评判——标准必须具体到 Agent 无法靠说辞蒙混过关。
- 在使命中规定实现方式。 使命说明目标;架构应由实现者决定。
- 让批评者看到实现者的总结。 盲审意味着只能看到制品和逐字呈现的标准;每次重试都必须使用全新的批评者实例。
- 将源文档中的秘密复制到提示词中。 如果提示词可能离开私密上下文,应通过引用来指明内部 ID/凭据,不得直接填写其值。
评论
支持 Markdown