个人 SKILL Agent 与全域共享方案¶
读者对象：团队负责人、Agent 开发者、管理员
预计阅读时间：1 小时
版本：v0.1 | 2026-08-13
1. 共享体系概览¶
PE Agent 平台采用 「个人 → 审核 → 公共」 三级资源共享模型：
┌─────────────┐ 审核通过 ┌─────────────┐
│ 个人资源 │ ───────────────→ │ 公共资源 │
│ Personal │ │ Public │
└─────────────┘ └─────────────┘
↑ ↓
创建者维护 全员可用
涉及资源类型：
| 资源 | 个人 | 公开 | 审核 |
|---|---|---|---|
| Agent | ✅ | ✅ 直接设置 Public | 否 |
| 插件（Tool） | ✅ | ✅ | 否 |
| MCP 服务 | ✅ | ✅ | 否 |
| SKILL | ✅ 个人目录 | ✅ 平台 skills/ | 视部署策略 |
| 知识库 | ✅ | ✅ | 是（管理员审核） |
2. 个人资源管理¶
2.1 个人 Agent¶
- 创建后默认为 Personal
- 在 Agent 列表「个人」标签管理
- 仅创建者可编辑、调试、删除
2.2 个人插件¶
路径：工具 → 插件
- 创建 Python 等自定义工具
- 默认个人可见
- 可设置为 Public 供团队使用
2.3 个人 MCP 服务¶
路径：工具 → MCP 服务
创建时需配置：
| 字段 | 说明 |
|---|---|
| 名称 | 如「天气服务」 |
| 描述 | 功能说明 |
| URL | MCP 服务地址 |
| Token | 认证令牌 |
| 权限 | 个人 或 公开 |
公开 MCP 可被所有用户在 Agent 节点中绑定。
2.4 个人 SKILL¶
- 通过
<save_to_skill>保存到skills/skills/{路径} - 通过
<my_skills names="...">在 Agent 中引用 - 仅创建者（个人 Skill）或平台管理员可维护
2.5 个人知识库¶
- 上传文档、构建 GraphRAG 索引
- 个人问答、Agent RAG 绑定
- 详见 增强检索（GraphRAG）
3. 发布到公共库¶
3.1 Agent 公开¶
方式： 创建或编辑 Agent 时，将 privacy_level 设为 Public。
效果：
- 出现在 Agent 列表「公开」标签
- Butler 规划时可匹配给所有用户
- 其他用户可查看、使用，通常不可编辑（非创建者）
建议：
- 名称清晰：
Buck-CCM-参数计算 - 描述说明输入/输出与适用场景
- 发布前充分调试
3.2 知识库公开（需审核）¶
流程：
- 个人知识库 → 文件 → 「分享至公共库」
- 系统提示：需管理员审核
- 确认提交
- 管理员在 消息中心 处理
- 审核通过后，文档进入 公共知识库
消息中心提示示例：
申请把文档分享至公共知识库
3.3 MCP / 插件公开¶
创建或编辑时，权限 选择 「公开」 即可，无需额外审核。
3.4 使用公共资源的权限¶
| 操作 | 公共 Agent | 公共知识库 | 公共 MCP |
|---|---|---|---|
| 在任务中使用 | ✅ | ✅ | ✅ |
| 编辑配置 | ❌（非创建者） | ❌ | ❌（非创建者） |
| 复制/导出 | 视功能而定 | ❌ | ❌ |
4. 管理员职责¶
管理员入口：/ad（视部署配置）
4.1 知识库审核¶
- 进入 消息中心
- 查看分享申请
- 审核文档内容与分类
- 批准或拒绝
4.2 用户与模型管理¶
- 用户账号管理
- LLM 模型配置
- 平台级公告与限制
4.3 公共内容治理¶
- 定期审查公共 Agent 质量
- 清理过时公共知识库文档
- 维护公共 MCP 服务可用性
5. 团队推广方案¶
5.1 角色分工¶
| 角色 | 职责 |
|---|---|
| 普通工程师 | 使用 Butler 完成任务；使用公共 Agent/知识库 |
| Agent 开发者 | 建 Agent、写 SKILL、维护插件/MCP |
| 知识库维护者 | 上传文档、构建索引、申请公开 |
| 团队负责人 | 规划公共 Agent/知识库清单；推动培训 |
| 管理员 | 审核、账号、平台配置 |
5.2 SKILL 标准化流程¶
1. 个人起草 SKILL（my_skills）
2. 团队内试用 1-2 周
3. 评审通过后 save_to_skill 到公共路径
4. 相关 Agent 改为引用 <skills names="...">
5. 文档化变更记录
5.3 公共库内容治理¶
- 建立 命名规范：
领域-功能-版本 - 指定 分类负责人
- 每季度 复审：过时内容下架或更新
5.4 培训节奏建议¶
| 阶段 | 内容 | 对象 |
|---|---|---|
| 第 1 周 | 快速入门 + 日常任务 | 全员 |
| 第 2-3 周 | Agent 建置 + 咒语文档 | 核心开发者 |
| 第 4 周 | GraphRAG + 共享方案 | 维护者 + 负责人 |
| 持续 | 案例分享、公共 Agent 推广 | 全员 |
6. 落地建议¶
6.1 首批公共 Agent 清单（示例）¶
| Agent 名称 | 功能 | 优先级 |
|---|---|---|
| Buck 参数计算 | CCM/DCM 参数 | P0 |
| LLC 初值计算 | 谐振参数估算 | P0 |
| 方案评估 | 拓扑方案评审 | P1 |
| 设计说明生成 | 文档格式化输出 | P1 |
6.2 知识库分类规划（示例）¶
6.3 命名与版本规范¶
- Agent：
[拓扑]-[功能]-v1，如Buck-ParamCalc-v1 - SKILL：小写连字符，description 含版本说明
- 知识库文件：
主题_版本_日期.pdf
6.4 部署说明¶
环境可能有独立 API 前缀与登录路径（如 /pe-agent），共享机制与标准部署一致，具体 URL 以 IT 提供为准。
7. 共享流程图¶
flowchart TD
A[工程师创建个人资源] --> B{资源类型}
B -->|Agent/MCP/插件| C[设置 Public]
B -->|知识库| D[提交分享申请]
C --> E[全员可用]
D --> F[管理员审核]
F -->|通过| G[进入公共知识库]
F -->|拒绝| H[退回个人库]
G --> E