8.7 KiB
8.7 KiB
主 Agent 职责边界规则更新
📋 更新概览
为主 Agent（Team Coordinator）添加了禁止自行修复问题的关键规则，明确职责边界和协作流程。
更新时间: 2026-02-14
影响 Agent: Team Coordinator (主 Agent)
规则级别: ⚠️ CRITICAL（关键）
✅ 更新的配置文件
| 文件 | 路径 | 状态 |
|---|---|---|
| OpenCode Team Agent | .opencode/agents/team.md |
✅ 已更新 |
| Antigravity Team Coordinator | .agent/agent_team_coordinator_prompt.md |
✅ 已更新 |
🎯 新增规则内容
核心规则
❌ 禁止主 Agent 自行修复问题
当收到 @code-spec 或 @qa-tester 的问题报告后，主 Agent 禁止自己动手修改代码。
正确流程
1. 收到问题报告（来自 @code-spec 或 @qa-tester）
↓
2. 主 Agent 汇总和分析问题
↓
3. 将问题委派给相应的开发 Agent
- 前端问题 → @frontend
- 服务/数据问题 → @umi-pro
↓
4. 等待开发 Agent 修复完成
↓
5. 重新调用审查/测试 Agent 验证
- @code-spec (代码审查)
- @qa-tester (功能测试)
↓
6. 确认问题解决后才继续
错误做法 ❌
## 错误示例
@code-spec: 发现问题 - ProTable 外层有 Card 包裹
Team Agent (错误): [直接调用 replace_file_content 修改代码]
正确做法 ✅
## 正确示例
@code-spec: 发现问题 - ProTable 外层有 Card 包裹
Team Agent (正确): 收到审查报告，发现双内边距问题。现在委派 @frontend 修复此问题。
@frontend: [收到任务，修改代码]
Team Agent: @frontend 已完成修复。现在重新调用 @code-spec 进行验证。
💡 规则原因
1. 职责分离
- 主 Agent: 协调者、项目经理
- 子 Agent: 专业领域执行者
2. 质量保证
- 确保专业的事由专业的 Agent 完成
- 避免主 Agent 跨界导致质量下降
- 保持代码风格和实现方式的一致性
3. 流程规范
- 明确的责任链
- 清晰的问题解决路径
- 可追溯的修复历史
4. 团队协作
- 保持 Agent 间的协作模式
- 避免主 Agent "大包大揽"
- 确保每个 Agent 发挥专长
📊 适用场景
场景 1: 代码审查发现问题
@code-spec 报告:
- 发现双内边距问题
- i18n 缺少 defaultMessage
- TypeScript 使用了 any
主 Agent 处理:
✅ 汇总问题列表
✅ 分析影响范围
✅ 委派 @frontend 或 @umi-pro 修复
❌ 不要自己修改代码
场景 2: QA 测试发现 Bug
@qa-tester 报告:
- 按钮点击无响应
- 加载状态未显示
- 国际化显示错误
主 Agent 处理:
✅ 分析 bug 性质
✅ 判断由哪个 Agent 修复
✅ 委派相应的开发 Agent
❌ 不要自己修改代码
场景 3: 用户反馈问题
用户反馈:
"页面显示不正常"
主 Agent 处理:
✅ 理解问题描述
✅ 调用 @qa-tester 诊断问题
✅ 根据诊断结果委派修复
❌ 不要直接修改代码
🔄 修复循环流程
┌─────────────────────────────────────┐
│ 1. 实施阶段 │
│ (@frontend / @umi-pro) │
└───────────┬─────────────────────────┘
│
↓
┌─────────────────────────────────────┐
│ 2. 审查阶段 │
│ (@code-spec) │
└───────────┬─────────────────────────┘
│
发现问题？
│
↓ Yes
┌─────────────────────────────────────┐
│ 3. 主 Agent 汇总问题 │
│ (Team Coordinator) │
│ ❌ 不要自己修复 │
└───────────┬─────────────────────────┘
│
↓
┌─────────────────────────────────────┐
│ 4. 委派修复 │
│ → @frontend / @umi-pro │
└───────────┬─────────────────────────┘
│
↓
┌─────────────────────────────────────┐
│ 5. 重新审查 │
│ (@code-spec) │
└───────────┬─────────────────────────┘
│
仍有问题？
│
↓ No
┌─────────────────────────────────────┐
│ 6. 测试阶段 │
│ (@qa-tester) │
└───────────┬─────────────────────────┘
│
发现 Bug？
│
↓ No
┌─────────────────────────────────────┐
│ 7. 任务完成 │
│ (Team Coordinator) │
└─────────────────────────────────────┘
🎓 主 Agent 的正确行为
✅ 应该做的事
- 协调：调用合适的子 Agent
- 汇总：整合各 Agent 的输出
- 决策：何时进入下一阶段
- 沟通：向用户解释进度和问题
- 把控：确保整体质量符合标准
❌ 不应该做的事
- 直接编码：不要调用 write_to_file 或 replace_file_content（除非是创建文档）
- 越俎代庖：不要替代专业 Agent 的工作
- 跳过流程：不要绕过审查或测试环节
- 擅自决定：不要在检查点后不经用户确认就继续
📝 配置文件具体变更
OpenCode (team.md)
位置: 禁止事项部分
添加内容:
- ❌ **不要自行修复问题** ⚠️ **关键规则**:
- 当收到 @code-spec 或 @qa-tester 的问题报告后
- **禁止**主 Agent 自己动手修改代码
- **必须**将问题反馈给相应的开发 Agent (@frontend 或 @umi-pro) 重新修复
- **原因**: 主 Agent 职责是协调，不是执行。确保专业的事由专业的 Agent 完成
- **流程**: 汇总问题 → 交给开发 Agent → 等待修复完成 → 重新审查/测试
Antigravity (agent_team_coordinator_prompt.md)
位置: Prohibited Actions 部分（新增）
添加内容:
- ❌ **Do NOT fix issues yourself** ⚠️ **CRITICAL RULE**:
- When receiving problem reports from @[/code-spec] or @[/qa]
- **FORBIDDEN**: Team Coordinator fixing code directly
- **REQUIRED**: Delegate issues to appropriate development agents (@[/fe] or @[/umi]) for re-implementation
- **Reason**: Team Coordinator's role is coordination, not execution. Ensure professionals handle professional work
- **Process**: Summarize issues → Delegate to dev agents → Wait for fixes → Re-audit/Re-test
🔍 验证清单
团队成员和用户在使用时应验证：
- 主 Agent 收到问题报告后，是否汇总问题
- 主 Agent 是否委派给相应的开发 Agent
- 主 Agent 是否等待修复完成
- 主 Agent 是否重新调用审查/测试
- 主 Agent 是否避免直接修改代码
⚠️ 特殊情况
例外场景（允许主 Agent 编辑）
以下情况下主 Agent 可以使用 write_to_file：
-
创建文档：
- 项目文档
- README
- 配置说明
-
非代码文件：
- Markdown 文档
- JSON 配置（非代码逻辑）
-
用户明确要求：
- 用户直接要求主 Agent 创建某个文档
绝对禁止（主 Agent 不得编辑）
-
源代码文件：
.tsx,.ts,.jsx,.js- 组件文件
- 服务文件
- Mock 文件
-
样式文件：
.css,.less,.scss- Style modules
-
配置代码：
- 路由配置
- 状态管理
- API 配置
📚 相关文档
更新完成时间: 2026-02-14
规则重要性: ⚠️ CRITICAL
强制执行: 是