yumoqing
17ad169829
团队角色/问题类型/冒泡路径不再用 DB 表 + CRUD，改为 team-communication skill （产线默认规范，项目可覆盖）： - 删 pipeline_team_roles/pipeline_problem_types 两表 model+json+api dspy - 回退 pipeline_core/init.py CRUD 函数 + load_path.py 路段 - 重写 team-communication SKILL.md 为分层可覆盖规范文档
3.6 KiB
3.6 KiB
| name | description |
|---|---|
| team-communication | 团队沟通规范（问题冒泡）——定义团队角色、问题类型、冒泡路径，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 侧）
- 我发现问题 →
raise_problem，按问题类型 + 冒泡路径指定首处理方。 - 我可能被指派处理问题 →
list_problems_for(我的角色, 我的 agentid)查待办， 不要只报统计数字，逐条读。 - 我能解决 →
resolve_problem（任务自动恢复，冒泡停止）。 - 我答不了 →
escalate_problem，沿冒泡路径转给下一个处理方。
六、分层与覆盖
- 本 skill 是产线级默认规范（skills_library 模板）。
- 项目可用同名 team-communication skill 放在项目 skills 目录覆盖： 同名问题类型 → 项目覆盖；新增 → 追加；未定义 → 兜底到产线级。
- 加载顺序：项目级 → 产线级 → 全局兜底。
七、状态与归属
- 状态只有
pending（冒泡中）/answered（已解决）。 - 归属 =
current_handler_role+current_handler_agentid两列， 由工具维护，查询走确定性 SQL，不靠 LLM 扫全文。