用途：列出组织内的工作区。工作区名称是几乎所有连接器命令所需的标识，因此通常是一次会话中的第二个命令（在 airbyte-agent enroll 之后）。
前提：需要 airbyte-agent CLI 位于 PATH 中，可通过 brew install airbytehq/tap/airbyte-agent 安装，或参见项目 README。
用法与参数：始终以 --json '{...}' 形式传参（不带筛选时用 --json '{}'），不要使用逐参数标志。示例： airbyte-agent workspaces list --json '{}' airbyte-agent workspaces list --json '{"name_contains": "production"}' airbyte-agent workspaces list --json '{"status": "active"}' 完整参数模式可运行 airbyte-agent schema workspaces list 查看。
输出筛选：已知所需字段时始终传 --fields，避免无用数据占用上下文。因列表响应被包装为 {"data": [...]}，CLI 会自动广播行级路径，短形式与长形式均可： airbyte-agent workspaces list --fields name,status --json '{}' airbyte-agent workspaces list --fields data.name,data.status --json '{}' 混用顶层与行级路径时，行级字段需用长形式，如 --fields data.name,next。
发现流程：先列出全部工作区，记下准确的 name 值；随后可在各命令中传入 --json '{"workspace": "<name>"}'，或用 airbyte-agent workspaces use --json '{"name": "<name>"}' 持久化为默认值，后续命令省略 workspace 时会回退到该默认值。
限制与注意：分页自动处理，所有工作区在单个响应中返回，与服务器端分页大小无关；limit 控制服务器端分页大小，结果仍完整返回。若仅有一个工作区，直接使用，不要提示用户选择。不要假设工作区名称，务必先发现；不要向接受 workspace 的命令传 UUID，CLI 期望可读名称。名称不确定时可用 name_contains 做部分匹配。