工作流

把指令、参数与设置打包成可复用、可分享的一键工作流。

什么是工作流

工作流（Recipe）是一份可复用的任务配置文件（.yaml / .json），把指令、参数、扩展与模型设置打包在一起——把重复的多步任务变成一键运行，也可以分享给他人使用。

获取与安装

从链接安装：他人分享的工作流以 goose://recipe?config=… 深链形式分发，点击后应用会显示安装确认，接受后即入库存放。
存放位置：在应用里创建的工作流保存在应用数据目录下。项目也可以把工作流放在项目内的 .agents/recipes/ 目录（旧位置 .goose/recipes/ 仍会读取）。

运行工作流

打开侧栏「工作流」，选择一个工作流查看详情。

若定义了参数，会弹出参数填写框（必填 / 可选 / 默认值）。

运行后 Agent 按指令自主执行；定义了活动气泡（activities）的工作流会在顶部显示建议操作，点击即可继续。

安全提示：工作流包含可执行的指令与扩展配置——运行不认识的工作流前请先阅读其内容。首次运行未确认过的工作流时，应用会提示你确认。

创建自己的工作流

常用字段速查（完整字段以上游格式为准，均可在桌面端使用）：

字段	作用
`title` / `description`	名称与说明
`instructions`（或 `prompt`）	任务指令模板，可用 `{{参数}}` 占位
`parameters`	参数定义（键名、类型、必填/可选、默认值）
`activities`	运行页顶部的建议操作气泡（`message:` 前缀为提示文案）
`extensions`	本工作流需要的扩展配置
`settings`	指定模型 / 提供商等运行设置

最小示例：


version: "1.0.0"
title: "代码审查助手"
description: "按指定重点审查代码"
parameters:
  - key: focus
    input_type: string
    requirement: optional
    default: "最佳实践"
    description: "审查重点"
instructions: >
  请审查当前项目的代码，重点关注 {{ focus }}，
  输出问题清单与改进建议。
activities:
  - "message: 选择一个重点，开始审查。"
  - "审查当前打开文件的安全性"
  - "总结最近一次提交的质量风险"

进阶

定时运行：把工作流交给「调度」，按 cron 规则自动执行——见调度。
子工作流（sub-recipes）：一个工作流可以把子任务委托给其他工作流，适合拆解复杂流程。
参数占位：{{参数}} 在指令、活动气泡中统一替换，一套工作流适配多种场景。

本页基于上游开源文档（Apache-2.0）改写，已修改；来源与变更见 /legal/provenance。