Block/Goose项目：创建可共享会话配方的最佳实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00918/article/details/148392399

Block/Goose项目：创建可共享会话配方的最佳实践

goose an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM 项目地址: https://gitcode.com/gh_mirrors/goose3/goose

引言

在现代开发工作流中，我们经常需要重复执行某些特定任务或工作流程。Block/Goose项目提供的"会话配方"功能，允许开发者将精心设计的会话设置（包括工具组合、目标定义和操作指南）打包成可复用的模板，极大提升了团队协作效率和个人工作流的复用性。

什么是会话配方？

会话配方是Block/Goose中的一种特殊配置模板，它封装了以下核心元素：

任务目标：明确定义该配方要解决的问题或完成的任务
工具组合：预先配置好的一组扩展工具
操作指南：AI代理的行为准则和任务执行逻辑
示例活动：提供给用户的典型使用场景建议

创建配方的两种方式

桌面端创建流程

启动基础会话：首先完成一个典型工作流程的会话
转换为配方：通过右上角菜单选择"从当前会话创建代理"
配置配方参数：
- 命名并描述配方用途
- 检查自动生成的活动建议
- 完善AI代理的指令集
获取分享链接：生成可直接分发的配方URL

命令行创建流程

生成配方文件：在会话中使用/recipe命令创建YAML/JSON文件

编辑配方内容：自定义以下关键部分：

version: 1.0.0
title: "代码审查配方"
description: "自动化代码质量检查工作流"
instructions: |
  您是一个专业的代码审查助手，专注于{{ language }}项目。
  请按照以下标准执行审查：
  - 复杂度阈值: {{ complexity_threshold }}
  - 测试覆盖率: {{ test_coverage }}%
activities:
- "执行{{ language }}代码复杂度分析"
parameters:
- key: language
  input_type: string
  requirement: required

参数化设计：使用{{ variable }}语法创建可配置参数
验证配方：使用goose recipe validate命令检查语法

高级配方设计技巧

参数化设计模式

必需参数：确保关键变量必须提供值
```
- key: project_name
  requirement: required
```
默认参数：为可选参数提供后备值
```
- key: test_coverage
  default: 80
```

交互式参数：运行时提示用户输入

- key: style_guide
  requirement: user_prompt

配方组织结构

专业团队应建立配方仓库，建议采用以下结构：

recipes/
├── code-review/
│   ├── recipe.yaml
│   └── README.md
├── setup-project/
│   └── recipe.yaml
└── docs/
    └── standards.md

使用配方的实践建议

桌面端使用场景

快速启动：直接点击配方链接自动加载完整环境
团队协作：将配方URL嵌入文档或聊天工具中共享
标准化流程：为重复性任务创建专用配方

命令行高效用法

本地配方：

goose run --recipe ./qa-review.yaml --params language=Go

远程配方（需预先配置仓库）：

goose run --recipe security-scan --interactive

配方预览：
```
goose recipe explain code-review
```

安全与隔离机制

Block/Goose在设计上确保了配方使用的安全性：

数据隔离：每个会话独立运行，互不影响
隐私保护：配方不包含以下敏感信息：
- 用户凭证和API密钥
- 本地系统配置
- 会话历史记录
可控共享：开发者可以精确控制配方包含的内容

典型应用场景

标准化代码审查：为不同语言项目创建专用审查配方
项目初始化：封装复杂的项目脚手架流程
故障排查：构建常见问题的诊断工作流
团队知识传承：将专家经验转化为可执行配方

结语

Block/Goose的会话配方功能将临时性的问题解决方案转化为团队的可复用资产。通过合理设计参数化配方，开发者能够构建出既灵活又标准化的智能工作流。建议团队建立配方知识库，并定期优化常用配方，这将显著提升整体开发效率和质量一致性。

goose an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM 项目地址: https://gitcode.com/gh_mirrors/goose3/goose

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考