关于 agent-role-design
agent-role-design 是一项多 Agent 系统设计技能,用于明确各 Agent 的职责、知识范围、权限和边界。它通过角色规范与冲突处理规则,帮助团队减少重复工作并协调 Agent。
主要功能
- 01定义目的、能力与知识范围
- 02明确权限和职责边界
- 03专家、路由与编排角色模式
- 04角色冲突与升级规则
- 05角色卡和交互关系图
适用场景
- 01设计多 Agent 系统中的角色
- 02厘清 Agent 之间的任务归属
- 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