---
name: team-communication
description: 团队沟通规范（问题冒泡）——定义团队角色、问题类型、冒泡路径，agent 有问题时据此处理（提问题/找自己要处理的/回答/转交）。产线定义默认规范，项目可用同名 skill 覆盖。触发：agent 发现问题、角色缺信息、PM 退回、故障上报、客户提问、待处理问题>0。
---

# 团队沟通（问题冒泡）规范

本 skill 是**规范**（团队结构 + 问题类型 + 冒泡路径）。问题操作的工具由系统固化，
agent 读本 skill 理解规范后，用工具执行。

## 一、核心模型

- **团队** = 一组不同角色的 agent + 人。多 agent 存在：同一角色可有多个 agent，
  处理方必须精确到 `角色 + agentid`（agentid 空 = 该角色任意 agent）。
- **问题类型** = 一种问题 + 一条冒泡路径（处理方序列）。
- **冒泡规则**：问题产生后从路径第一个处理方开始；处理方解决了→停（answered）；
  没解决→沿路径转给下一个处理方；路径尽头通常是「人」兜底。

## 二、团队角色（产线默认）

| 角色 | 类型 | 职责 |
|---|---|---|
| main_agent | agent | 用户面对话 agent，回答问题、路由到客户 |
| pm | agent | 项目经理，审核交付件、退回意见 |
| requirement | agent | 需求分析师 |
| design | agent | 系统设计师 |
| develop | agent | 开发工程师 |
| test | agent | 测试工程师 |
| deploy | agent | 部署运维 |
| customer | human | 人类客户，最终兜底 |

## 三、问题类型与冒泡路径（产线默认）

| 问题类型 | 冒泡路径 | 说明 |
|---|---|---|
| need_info | main_agent → customer | 角色缺信息向上提问，主 agent 答 / 转客户 |
| review_reject | 被退角色 → pm | PM 退回，被退角色响应后复审 |
| fault_report | main_agent → customer | 任务失败报障，主 agent / 客户人工介入 |

冒泡路径是**规范**，由 agent 读后决策「下一个转给谁」，系统不把路径存进数据。

## 四、工具（系统固化，产线无关）

| 工具 | 作用 |
|---|---|
| raise_problem(problem_type, question, first_handler_role, first_handler_agentid) | 提问题，显式指定首处理方 |
| list_problems_for(role, agentid) | 查「当前该我处理」的问题（确定性过滤） |
| resolve_problem(question_id, answer) | 解决 → 停止冒泡 |
| escalate_problem(question_id, next_handler_role, next_handler_agentid) | 没解决 → 显式转给下一个处理方 |

cockpit 侧包装：`list_questions`（查待我处理的）、`answer_question`（回答）、
`escalate_question`（转给客户）。

## 五、处理流程（agent 侧）

1. 我发现问题 → `raise_problem`，按问题类型 + 冒泡路径指定首处理方。
2. 我可能被指派处理问题 → `list_problems_for(我的角色, 我的 agentid)` 查待办，
   不要只报统计数字，逐条读。
3. 我能解决 → `resolve_problem`（任务自动恢复，冒泡停止）。
4. 我答不了 → `escalate_problem`，沿冒泡路径转给下一个处理方。

## 六、分层与覆盖

- 本 skill 是**产线级默认规范**（skills_library 模板）。
- 项目可用**同名 team-communication skill** 放在项目 skills 目录覆盖：
  同名问题类型 → 项目覆盖；新增 → 追加；未定义 → 兜底到产线级。
- 加载顺序：项目级 → 产线级 → 全局兜底。

## 七、状态与归属

- 状态只有 `pending`（冒泡中）/ `answered`（已解决）。
- 归属 = `current_handler_role` + `current_handler_agentid` 两列，
  由工具维护，查询走确定性 SQL，不靠 LLM 扫全文。