成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Shopify Roast:把 Agent 工作流写成可测 YAML

对照 Shopify 工程实践:用约定式 workflow.yml + 提示词步,交织确定性命令与 CodingAgent,会话可回放;不代在生产仓库裸跑改码。

场景说明

面向独立开发者与平台 DX:把「别让 Agent 在巨型仓库里乱跑」写成结构化工作流,区别于单次提示修 bug 与示教录屏壳。

案例叙事

01他们做了什么

Shopify Engineering《Introducing Roast: Structured AI workflows made easy》(Obie Fernandez,页内 Published on Jun 18, 2025 可核)写明:Augmented Engineering DX 团队在用 Agent 做脆测治理、测试覆盖等时发现——复杂提示塞进一次「满仓库乱逛」几乎不可靠;必须把任务拆成离散步骤,并让 AI 步与普通代码步交织。他们抽出并开源 Roast:约定优于配置的工作流框架,用 workflow.yml + markdown 提示词声明步骤,支持目录步、$() 命令步、内联提示、^CodingAgent(接 Claude Code)、自定义 Ruby 步与并行嵌套数组;步之间共享对话上下文;提供 session replay,可从任一步续跑以免反复烧昂贵 AI 步。

内部案例包括:规模化测质量分析、Boba 工作流(sed/清理→Sorbet 自动更正→剩余交 CodingAgent 迭代)、SRE 扫内部频道做早期信号、竞品情报聚合、「切斯特顿栅栏」式提交/PR 溯源解释。本场景据此输出「结构化 AI 工作流」提纲。禁止声称「已在你的 monorepo 跑完全库烤肉」。

02实际效果

  • 源描述内部已用于数千测试文件分析、类型补全、SRE 信号与情报聚合等;未给可直接套用的统一 ROI 百分比。
  • 能把「一条超长提示碰运气」与「YAML 步 + 可回放 + 确定性/Agent 混编」拆开。
  • 为第一步该确定性还是该 Agent、如何回放省钱提供提问清单。

03值得知道

  • Roast 本身是 Ruby CLI,工作流可服务多语言,但引入成本与团队栈有关。
  • CodingAgent 仍可能改错文件;生产路径须人工 diff 与测试门禁。
  • 上面写的是 Shopify 公开工程与开源叙述,不是托管 SaaS 承诺。

04可复制提示词

Roast 风格工作流骨架

你是结构化 AI 工作流助手。只设计 workflow 骨架与步类型,不要编造已执行成功。

目标任务:{{task}}
必确定性的步骤:{{deterministic_steps}}
适合 Agent 迭代的步骤:{{agent_steps}}
是否需要回放:{{need_replay}}

输出 Markdown:
1. workflow.yml 步列表(标类型:prompt/cmd/agent/parallel)
2. 每步输入输出约定
3. 失败重试与人工闸门
4. 本地试跑顺序
禁止索要 API Key;禁止声称已分析全仓库。

脆测/补类型工作流选型提纲

想把重复工程杂务做成可版本管理的 Agent 工作流,请写选型提纲。

杂务类型:{{chore}}
现有脚本:{{existing_scripts}}
模型预算:{{budget}}

输出:
1. 哪些先保持 sed/脚本确定性
2. 何处接入 CodingAgent
3. 如何用 replay 降本
4. 合并前验证清单
不要伪造「覆盖率已提升」。

怎么做

  1. 粘贴目标任务(测评级/补类型/扫频道信号等)、是否需版本管理与回放、以及哪些步必须确定性
  2. Agent 按公开实践输出:目录约定→步类型(目录提示/命令/内联/并行/自定义)→CodingAgent 边界→session replay 提问清单
  3. 人工在自有仓库落 workflow;Agent 不代烧生产 token 跑全库

实用提示

  • 源帖核心:非确定性是可靠性的敌人;先拆步,再用 AI 填「尚未理解」的洞,理解后再换成确定性步
  • 与 learn-scripts-from-tools-folder / intent-review-agent-with-tests 不同:本条是 YAML 编排的可回放混合工作流,不是示教录屏或意图评审测试壳
#Shopify#Roast#结构化工作流#YAML#编码 Agent