testany-workspace git:20260914.a55b8c5A

Immutable. This exact content is served forever at /api/v1/blob/647de6bfad3016c3.

---
name: testany-workspace
description: 管理 Testany 工作空间 - 成员管理、权限配置、团队组织
---

# Testany 工作空间管理

管理 Testany 工作空间和团队成员。

用户输入: $ARGUMENTS

## 职责范围

- 管理工作空间
- 添加/移除团队成员
- 配置成员角色和权限

## 核心知识

### 工作空间概念

工作空间是 Testany 中的资源隔离单元，用于：
- 组织团队的测试资源
- 控制访问权限
- 隔离不同项目/团队

### 角色权限

| 角色 | 权限 |
|------|------|
| **Admin** | 管理成员，编辑所有资源 |
| **Member** | 创建和编辑自己的资源 |

## 常用操作

### 查看我的工作空间
```
testany_get_my_workspaces
testany_get_my_workspaces_with_roles  # 包含角色信息
```

### 添加成员
```
testany_list_users → 查找用户
testany_assign_user_to_workspace → 添加单个用户
testany_assign_users_to_workspace → 批量添加
```

### 修改成员角色
```
testany_find_workspace_users → 查找工作空间下所有用户
testany_assign_user_to_workspace → 修改单个用户
```

### 获取工作空间成员列表
```
testany_find_workspace_users → 查找工作空间下现有成员
```

### 移除成员
```
testany_remove_user_from_workspace → 从工作空间移除用户
```

### 申请新工作空间
```
testany_check_workspace_key → 检查 workspace key 是否可用
testany_request_workspace → 提交申请
```
注意：申请前需先调用 testany_check_workspace_key 检查 key 是否已被占用。

## 工作流程

遵循 [交付与读回验证](../testany-guide/references/delivery-verification.md)，已知目标无需重复确认，只操作授权的 workspace/成员/角色。

1. **确认目标**：操作哪个工作空间？
2. **获取当前状态**：`testany_get_my_workspaces_with_roles`
3. **执行操作**：添加成员、修改角色等
4. **读回验证**：成员/角色变更后用 `testany_find_workspace_users` 核对相关成员；申请后用实际可用的申请状态或 workspace 列表核对。申请已受理/待审批不等于已批准可用，成员写请求成功不等于角色已生效
5. **保留部分结果**：读回缺失或不一致时返回真实 key、已提交动作和限制，不自动重试、重复申请、增加其他成员或回滚删除

## 返回格式

任务完成后，向用户汇报：
- 操作结果
- 受影响的成员/工作空间
- 当前权限状态

## 参考文档

详细概念请参考：
- [核心概念](../testany-guide/references/concepts.md)