# Agent Expert Panel：多智能体工作流 Skill

面向多智能体工作流设计与审计的可迁移 Agent Skill 先判断多智能体编排是否值得 再定义责任 能力预检 交接 验收门和异常路径

<table align="center"><tr><td><a href="https://github.com/mianbaofang/agent-expert-panel/releases/latest"><img src="https://img.shields.io/github/v/release/mianbaofang/agent-expert-panel?style=flat-square" alt="最新版本"></a></td><td><a href="https://github.com/mianbaofang/agent-expert-panel/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/mianbaofang/agent-expert-panel/validate.yml?branch=main&amp;style=flat-square&amp;label=tests" alt="测试状态"></a></td><td><a href="LICENSE"><img src="https://img.shields.io/github/license/mianbaofang/agent-expert-panel?style=flat-square" alt="许可证"></a></td><td><a href="https://github.com/mianbaofang/agent-expert-panel/stargazers"><img src="https://img.shields.io/github/stars/mianbaofang/agent-expert-panel?style=flat-square" alt="GitHub 星标"></a></td></tr></table>

<p align="center">
  <a href="https://mianbaofang.github.io/agent-expert-panel/docs/site/project-intro-animation.zh-CN.html">
    <img src="docs/assets/intro-animation-preview-zh-CN.gif" alt="Agent Expert Panel 多智能体专家团工作流演示" width="100%">
  </a>
</p>

<p align="center">
  <a href="README.md">English</a>
  &middot;
  <a href="SKILL.md">Skill</a>
  &middot;
  <a href="docs/site/project-intro-animation.zh-CN.html">产品演示</a>
  &middot;
  <a href="DISCLAIMER.md">免责声明</a>
  &middot;
  <a href="ACKNOWLEDGEMENTS.md">致谢</a>
  &middot;
  <a href="CHANGELOG.md">更新记录</a>
  &middot;
  <a href="SECURITY_AUDIT.md">安全审计</a>
  &middot;
  <a href="reports/output_quality_scorecard.md">质量报告</a>
</p>

## 快速开始

支持从 GitHub 仓库安装 Agent Skill 的客户端 可以直接使用仓库根目录：

```text
https://github.com/mianbaofang/agent-expert-panel
```

最新 Release 还提供只包含 Skill 的轻量安装包 不包含仓库文档媒体：

```text
https://github.com/mianbaofang/agent-expert-panel/releases/latest/download/agent-expert-panel-skill.zip
```

将压缩包里的 `agent-expert-panel/` 目录解压到你的 Agent 所使用的 Skill 目录 如果宿主不支持安装 Skill 也可以让它直接读取 [`SKILL.md`](SKILL.md)

然后从这一句话开始：

```text
请使用 agent-expert-panel 判断这个项目是否需要多智能体工作流
如果需要 设计最小可用的团队 交接和验收门；
如果不需要 给出更简单的方案
```

从 `v1.0.0` 升级时 请改用仓库根目录 不再使用旧的 `/skill` 子目录 旧结构无法通过“Skill 的 `name` 必须与父目录名一致”这项标准校验

## 为什么做这个 Skill

我做这个 Skill 是因为在项目、研究和内容工作流里反复遇到同一个问题：让多个 Agent 一起帮忙并不难 难的是最后没有谁真正对完整结果负责 每个回答单独看都像是对的 但任务是否值得组团、哪些工作能够真正分开、产物怎样交给下一位、冲突由谁判断 往往都没有被设计

把所有要求塞进一个更长的万能提示词也解决不了这个问题 它会让简单任务变重 却仍然把能力、审批、异常处理和最终责任留在暗处 因此 Agent Expert Panel 先判断专家团是否值得 再默认选择能够完成工作的最小方案

**Agent Expert Panel 是一个可迁移的 Agent Skill 面向正在设计或审计 Agent Skill、研究流程、产品流程和内容系统的人 它会在单 Agent、轻量专家团和完整专家团之间做选择 再定义责任、能力预检、交接、验收门和异常路径**

> 使用前请阅读[免责声明](DISCLAIMER.md) 这是一个基于公开方法整理的开放工作流设计 Skill 与 WorkBuddy 或其它被提及的第三方不存在从属、授权或背书关系

## 一眼看懂

| 问题 | 回答 |
|---|---|
| 第一个判断是什么？ | 多智能体协作带来的质量或风险收益 是否足以覆盖协调成本  |
| 默认会输出什么？ | 一个轻量专家团：唯一主理人、必要专家、明确交接和验收门  |
| 如果不需要专家团呢？ | 给出直接执行方案 并说明什么条件下需要重新评估  |
| 如果需要可复用规范呢？ | 加载完整专家团参考 补充成员契约、产物归属、异常处理和决策记录  |
| 它不会做什么？ | 不启动 Agent、不调用模型服务 也不会把尚未执行的工作写成已完成事实  |
| 最快怎样开始？ | 安装仓库根目录 然后让它评估一条真实工作流  |

## 能做什么

| 能力 | 结果 |
|---|---|
| 组团判断 | 按价值、风险和协调成本选择 `direct`、`compact-panel` 或 `full-panel` 而不是按任务数量组团  |
| 责任设计 | 由一个主理人负责最终结果 每位专家只负责一个独立产物  |
| 能力预检 | 派发前检查工具、权限、数据访问、预算、隐私、审批和替代方案  |
| 交接设计 | 为每次流转定义负责人、输入、输出、证据、检查、停止条件和下一负责人  |
| 质量与治理 | 在发布、付费、敏感数据转移和不可逆修改前设置验收门  |
| 异常恢复 | 处理能力缺失、重复失败、输出含糊、范围变化和专家意见冲突  |
| 证据边界 | 区分规划、固定评测结果和真正执行并验证过的工作  |

### 什么时候使用

| 适合使用 | 不适合使用 |
|---|---|
| 设计 AI Agent 编排工作流 | 单文件或单一领域任务 |
| 审计已有多智能体系统或 Agent Skill | 彼此独立、无需交接的普通并行任务 |
| 修复责任不清、路由混乱或验收门缺失 | 只是执行一份已经确认的计划 |
| 定义专家角色、产物流和异常处理 | 为了看起来完整而增加角色 |
| 判断复杂流程是否应该升级为专家团 | 唯一目标只是“更快” |

## 使用方式

| 决策或模式 | 输出 |
|---|---|
| 直接执行 | 为什么一个 Agent 足够、下一步动作 以及什么条件下需要重新评估 |
| 轻量专家团 | 主理人、最小专家表、能力预检、工作流、交接、验收门、风险和替代方案 |
| 完整专家团 | 在轻量设计上补充成员契约、产物地图、异常矩阵、决策记录和宿主适配说明 |
| 运行落地 | 只有用户明确要求 并且宿主运行环境真实支持时才进入 |

核心流程保持简短：

1. 明确目标、完成证据、约束、输入和宿主能力
2. 比较质量或风险收益 与沟通、Token、时间、隐私和工具成本
3. 选择直接执行、轻量专家团或完整专家团
4. 定义一个对最终结果负责的主理人 只保留有独立产出的专家
5. 预检工具、数据访问、预算、权限、审批门和替代方案
6. 定义阶段、交接、产物、检查、停止条件和异常处理
7. 验证下一位用户或 Agent 能否不靠猜测继续工作

其它常用请求：

```text
审计这个已有 Agent Skill 找出不必要的角色、路由缺口和薄弱交接
```

```text
为这套研究与发布流程设计一份可复用的专家团规范
包含能力、隐私、预算、审批和异常边界
```

## 安全与责任边界

- 仓库根目录是唯一标准安装入口；`skill/README.md` 只负责向旧链接说明迁移方式
- Skill 与具体运行时无关 也没有必须安装的可执行依赖
- 真实委派取决于宿主 Agent 的子 Agent、工具和权限模型
- 没有真正执行的研究、审核或验证 不得包装成成员已经完成的事实
- 仓库不包含第三方产品的私有提示词或私有资产
- 用户需要自行负责敏感数据、许可证、服务条款、专业复核和最终决策

完整说明见[免责声明](DISCLAIMER.md)和[安全审计](SECURITY_AUDIT.md)

### 验证证据

- [`evals/trigger_cases.json`](evals/trigger_cases.json) 覆盖正例、反例和近邻路由
- [`evals/output_cases.json`](evals/output_cases.json) 提供场景级输出断言
- [`tests/TEST-CASES.md`](tests/TEST-CASES.md) 提供便于人工复查的验收矩阵
- 自动验证会检查 Agent Skills 格式、规范包结构、客户端元数据、链接和常见敏感信息模式
- 当前 25/25 触发样例结果属于固定样例证据 不代表真实采用率或已经测得模型质量提升

## 致谢

这个 Skill 的起点来自叶小钗在人人都是产品经理发布的专家团产品化公开分析；开放包结构遵循公开的 [Agent Skills 规范](https://agentskills.io/specification) 完整来源、致谢和改造边界见[致谢](ACKNOWLEDGEMENTS.md)与[方法来源](docs/history/methodology-source.md)

## 仓库结构

```text
SKILL.md                   标准安装入口
agents/                    客户端显示元数据
references/                延迟加载的完整专家团规范
evals/                     触发与输出评测用例
reports/                   证据和质量边界
scripts/                   校验与 Release 打包
tests/TEST-CASES.md        行为和边界验收
docs/site/                 产品演示页面
skill/README.md            v1.0 旧结构迁移说明
CHANGELOG.md               版本记录
```

## 状态 / 发布

- 当前版本：[`v1.1.0`](https://github.com/mianbaofang/agent-expert-panel/releases/tag/v1.1.0)
- 安装包：[`agent-expert-panel-skill.zip`](https://github.com/mianbaofang/agent-expert-panel/releases/latest/download/agent-expert-panel-skill.zip)
- 安装包 SHA-256：`96fdf0aeea78cdd5364daefa26f96303e0af81a7ad6865f77b7cc8ace6ee748d`
- CI：本地包校验、官方 `agentskills` 校验和干净解压安装校验
- 触发样例：25/25 通过 证据边界见上文

版本历史见[更新记录](CHANGELOG.md)

## 许可证

本项目使用 [MIT License](LICENSE)