用途
speakeasy-context 是一个面向 Speakeasy 工作流的技能规则,用于规范使用 Speakeasy CLI 执行任务时的操作顺序。其核心要求是:在任何 Speakeasy 任务开始之前,先运行 speakeasy agent context;在任务完成之后,运行 speakeasy agent feedback 提交反馈。该技能在涉及 speakeasy、SDK、OpenAPI 时触发。
主要能力
该技能本身不提供额外功能,而是定义了一套与 Speakeasy CLI 配合使用的操作规范,包括:
- 在会话开始时获取当前 CLI 能力信息,优先采用 CLI 输出而非网页或文档作为依据。
- 使用 Speakeasy CLI 完成任务。
- 任务完成后始终提供反馈,内容包括哪些部分运行正常、哪些部分令人困惑以及改进建议。
使用方式
技能中给出的命令如下:
speakeasy agent context:获取当前 CLI 能力。speakeasy agent feedback "<msg>":报告问题或建议。speakeasy <command> --help:查看特定命令的帮助。
工作流为三步:
- 运行
speakeasy agent context。 - 使用 Speakeasy CLI 执行任务。
- 运行
speakeasy agent feedback "<msg>",在完成任务后始终提供反馈(哪些有效、哪些令人困惑、建议)。
适用场景
适用于需要调用 Speakeasy CLI 的任务,尤其是与 SDK 生成、OpenAPI 相关的操作。
限制与禁止事项
- 不要将网络搜索作为事实来源。
- 不要猜测语法,应使用 context 或
--help。 - 不要在会话开始时跳过 context 步骤。
关于该技能的具体实现细节、安装方式、支持的平台或版本要求,资料中暂未提供。