name: agent-coordination description: 代理分配矩阵、阻塞升级和TDM协调模式。用于分配工作给专家、管理阻塞或协调多代理工作流时使用。
代理协调技能
目的
指导正确的代理分配、阻塞升级和遵循TDM角色边界的交付协调。
适用场景
在以下情况调用此技能:
- 分配工作给专家代理
- 跨代理管理阻塞问题
- 协调多代理工作流
- 向ARCHitect/POPM升级问题
- 验证预实现检查点
- 在Linear中更新证据
停止条件
禁止模式
# 禁止:错误的代理分配
数据库工作 → BE开发者 # 错误:使用数据工程师!
安全验证 → QAS # 错误:使用安全工程师!
文档 → BE开发者 # 错误:使用技术文档撰写员!
# 禁止:跳过预实现检查点
在BSA规格之前开始编码 # 必须先有验收标准
# 禁止:未解决的阻塞超过4小时
存在阻塞但未升级 # 必须在1小时内升级
正确模式
# 正确:合适的工作分配
数据库工作 → 数据工程师
安全验证 → 安全工程师
文档 → 技术文档撰写员
计划/规格 → BSA
架构审查 → 系统架构师
API实现 → BE开发者
UI实现 → FE开发者
测试 → QAS
PR/发布 → RTE
# 正确:预实现检查点
1. BSA创建带有验收标准的规格
2. 系统架构师审查模式
3. 然后专家执行
代理分配矩阵(强制)
| 工作类型 | 正确代理 | 切勿使用 |
|---|---|---|
| 数据库/迁移 | 数据工程师 | BE开发者 |
| 安全/RLS | 安全工程师 | QAS |
| 文档 | 技术文档撰写员 | BE/FE开发者 |
| 规格/计划 | BSA | 任何实现人员 |
| 架构 | 系统架构师 | 直接给开发者 |
| API路由 | BE开发者 | FE开发者 |
| UI组件 | FE开发者 | BE开发者 |
| 测试/QA | QAS | 实现团队 |
| PR/发布 | RTE | 开发者 |
参考:docs/workflow/TDM_AGENT_ASSIGNMENT_MATRIX.md
阻塞升级协议
何时升级
| 条件 | 升级对象 | 截止时间 |
|---|---|---|
| 阻塞超过1小时 | TDM | 立即 |
| 阻塞超过4小时 | ARCHitect | 紧急 |
| 架构模糊性 | ARCHitect | 工作前 |
| 跨团队依赖 | TDM + POPM | 同一天 |
| 安全问题 | SecEng | 立即 |
升级模板
**阻塞升级**
**工单**: {{TICKET_PREFIX}}-XXX
**阻塞开始时间**: [时间戳]
**代理**: [哪个专家被阻塞]
**问题**:
[清晰描述是什么阻止了进展]
**已尝试**:
1. [尝试了什么]
2. [尝试了什么]
**请求**:
[具体需求 - 需要决策、资源等]
预实现检查点
强制,在任何实现工作之前:
1. BSA创建规格,包含:
- [ ] 清晰的验收标准
- [ ] 执行模式参考
- [ ] 成功验证命令
2. 系统架构师审查:
- [ ] 模式合规性
- [ ] RLS要求(如果涉及数据库)
- [ ] 安全影响
3. 然后可以开始实现
证据附件
所有工作必须在Linear中包含证据:
**实现证据**
**会话ID**: [Claude会话ID]
**代理**: [哪个专家]
**工单**: {{TICKET_PREFIX}}-XXX
**已完成工作**:
- [x] 任务1
- [x] 任务2
**验证**:
```bash
yarn ci:validate
# 所有检查通过
```
下一步: [如果有]
TDM边界
TDM职责
- ✅ 跟踪交付进度
- ✅ 更新Linear工单
- ✅ 升级阻塞
- ✅ 附加证据
- ✅ 应对问题
TDM不职责
- ❌ 编排功能工作(ARCHitect的职责)
- ❌ 运行CI/CD验证(专家的职责)
- ❌ 执行技术工作(专家的职责)
- ❌ 主动分配功能(ARCHitect的职责)
权威参考
- 代理分配矩阵:
docs/workflow/TDM_AGENT_ASSIGNMENT_MATRIX.md - 代理工作流SOP v1.3:
docs/sop/AGENT_WORKFLOW_SOP.md - CONTRIBUTING.md: 工作流要求
- Linear SOP技能: 证据附件模板