mcpField
A
agent-role-design

agent-role-design

github.com/owl-listenerAgent 工作流191132 次安装20 周前更新
代码仓库

关于 agent-role-design

agent-role-design 是一项多 Agent 系统设计技能,用于明确各 Agent 的职责、知识范围、权限和边界。它通过角色规范与冲突处理规则,帮助团队减少重复工作并协调 Agent。

主要功能

  1. 01定义目的、能力与知识范围
  2. 02明确权限和职责边界
  3. 03专家、路由与编排角色模式
  4. 04角色冲突与升级规则
  5. 05角色卡和交互关系图

适用场景

  1. 01设计多 Agent 系统中的角色
  2. 02厘清 Agent 之间的任务归属
  3. 03规划 Agent 意见不一致时的升级路径

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/owl-listener/ai-design-skills --skill agent-role-design

安装后在 Claude Code 中输入/agent-role-design确认已加载。

详细介绍

Agent 角色设计

在多 Agent 系统中,每个 Agent 都需要有明确的角色定义——它做什么、了解什么、负责什么,以及权限止于何处。没有明确的角色,Agent 就会重复工作、彼此冲突,或留下空缺。

定义 Agent 角色

对于系统中的每个 Agent,请明确以下内容:

  • 目的:这个 Agent 是做什么的?用一句话说明它存在的理由。
  • 能力:这个 Agent 能做什么?列出具体操作和输出。
  • 知识范围:这个 Agent 了解什么?它可以访问哪些领域、数据和上下文?
  • 权限:这个 Agent 可以自主做出哪些决定?哪些决定需要审批?
  • 边界:哪些内容明确不属于这个 Agent 的职责范围?它应在何处停止并移交?
  • 成功标准:如何判断这个 Agent 是否出色地完成了工作?

角色设计原则

  • 单一职责:每个 Agent 都应有一个明确的目的。如果需要用一段话才能解释它做什么,那它承担的职责就太多了。
  • 明确边界:一个 Agent 的职责范围与另一个 Agent 的职责范围之间应有清晰无歧义的界限。未经明确的冲突解决机制,不应有重叠的权限。
  • 最小耦合:Agent 应尽量减少对其他 Agent 的依赖来完成工作。共享结果,而非过程。
  • 适度自主:自主决策的程度应与风险级别以及该 Agent 在相关领域的可靠性相匹配。

角色模式

  • 专家型:在某个领域具备深厚专业知识,处理特定类型的所有任务。
  • 路由型:不亲自执行任务,而是将任务分配给合适的专家。
  • 编排型:管理整体工作流,协调各专家之间的配合。
  • 验证型:从质量、安全性或合规性等方面审核其他 Agent 的输出。
  • 兜底型:处理其他 Agent 无法处理或不愿处理的情况。

角色冲突

当 Agent 的角色重叠或发生冲突时:

  • 优先级规则:两个 Agent 都可以处理某项任务时,应由谁负责?
  • 升级路径:Agent 意见不一致时,由谁决定?
  • 共享资源:Agent 需要使用相同的数据或工具时,如何管理访问权限?
  • 反馈循环:Agent 如何将已完成的工作告知彼此?

设计文档

  • Agent 角色卡(每个 Agent 一份,包含所有规范)
  • 角色边界图,展示每个 Agent 的权限从何处开始、止于何处
  • 交互矩阵,展示哪些 Agent 彼此通信
  • 权限层级图
  • 角色冲突解决规则

评论

支持 Markdown