name: 列出团队 description: 从团队组件映射中列出所有团队
列出团队
这个技能提供从团队组件映射中列出所有团队的功能,包括每个团队的丰富元数据(组件、描述、仓库、团队大小、Slack频道)。
何时使用这个技能
在需要时使用此技能:
- 显示所有可用团队名称
- 在使用其他命令之前验证团队名称
- 获取带有OCPBUGS组件的完整团队列表
- 统计系统中的团队数量
- 查找用于团队分析的团队名称
前提条件
-
Python 3 安装
- 检查是否已安装:
which python3 - 需要Python 3.6或更高版本
- 检查是否已安装:
-
团队组件映射文件
- 映射文件应在仓库中
- 位置:
plugins/teams/team_component_map.json - 此文件已提交到仓库
实施步骤
步骤 1: 运行 list-teams 脚本
python3 plugins/teams/skills/list-teams/list_teams.py
步骤 2: 处理输出
脚本以两种格式之一输出JSON:
新格式(使用更新脚本重新生成后):
{
"total_teams": 29,
"teams": {
"API Server": {
"components": ["kube-apiserver", "openshift-apiserver", "..."],
"description": "负责API服务器组件的团队",
"team_size": 15,
"repos": ["openshift/origin", "openshift/kubernetes"],
"slack_channels": ["forum-apiserver"]
},
"Authentication": {
"components": ["oauth-apiserver", "..."],
"description": "...",
"team_size": 10,
"repos": ["..."],
"slack_channels": ["..."]
}
}
}
旧格式(重新生成前):
{
"total_teams": 29,
"teams": [
"API Server",
"Authentication",
"..."
]
}
步骤 3: 向用户显示
重要:当通过/teams:list-teams命令向用户显示结果时:
- 只显示简洁的团队名称列表
- 除非用户特别要求,否则不要显示完整的团队元数据
- 保持输出简短且易于扫描
对于AI代理使用:
- 完整团队元数据可用于回答后续问题
- 可以使用组件、仓库、slack_channels提供上下文
- 可以使用团队大小和描述提供额外见解
示例
示例 1: 列出所有团队
python3 plugins/teams/skills/list-teams/list_teams.py
示例 2: 统计团队数量
python3 plugins/teams/skills/list-teams/list_teams.py | jq '.total_teams'
备注
- 团队数据提取自已提交的映射文件
- 团队名称区分大小写
- 团队按名称字母顺序返回
- 执行速度非常快(< 100毫秒)
- 典型数量:约29个团队(仅限带有OCPBUGS组件的团队)
- 脚本自动检测格式(新旧)并处理两者
- 丰富元数据包括:
- components: 团队拥有的OCPBUGS组件列表
- description: 团队的目的/职责
- team_size: 团队成员数量(仅计数,无个人信息)
- repos: 团队拥有的GitHub仓库
- slack_channels: 论坛式Slack频道(仅名称)
数据源
团队和组件映射数据来源于:
- 来源: https://gitlab.cee.redhat.com/hybrid-platforms/org
- 访问: 需要Red Hat VPN连接
- 隐私: 完整组织数据被视为部分私有,因此此项目仅提取团队和组件映射
如果数据看起来错误或缺失:
- 提交PR到 https://gitlab.cee.redhat.com/hybrid-platforms/org 以更正源数据
- PR合并后,在此仓库中重新生成映射文件:
python3 plugins/teams/generate_team_component_map.py - 提交更新后的
team_component_map.json文件
另请参阅
- 相关技能:
plugins/teams/skills/list-components/SKILL.md - 相关命令:
/teams:list-teams - 映射文件:
plugins/teams/team_component_map.json - 生成器脚本:
plugins/teams/generate_team_component_map.py