Files
pj0235-eai_agentplatform/docs/09_Research/RS05_我的通用智能体能力对标与技能清单取舍.md
T
eaiadmin 90031b75f3 docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
2026-09-22 23:23:16 +08:00

219 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# MyGPT 能力对标与技能清单取舍
> 落盘日期:2026-09-19
> 状态:**已定稿口径**(严格口径,用户已拍板);结论只回答「要不要」,不含实现判据
> 落地:**已执行**(2026-09-19,A 案「删条目 + 改专员」),明细见 §9
> 目的:以微趣 MyGPT 手册为唯一基准,裁决现有 23 个技能的去留,并列出为达成「MyGPT 20 能力全覆盖」需补的能力项
> 前提约束(用户明确):
> 1. 全面学习 MyGPT,**只允许增加 text-to-speech 一个净增项**
> 2. **不考虑技能被专员调用**(专员依赖不参与「要不要」的判断)
> 关联文档:
> - `docs/09_Research/01_Benchmarks_And_Mappings/微趣我的通用智能体调研与办公智能体架构对比.md`(手册原文出处,能力清单见 L376-622,16 场景见 L238-302)
> - `docs/09_Research/RS02_外部智能体平台架构对照.md`(外部平台架构对照)
> - `docs/02_Architecture/对象标准化与解耦总则.md`
---
## 目录
1. [判定口径](#1-判定口径)
2. [表一:要保留的 18 个](#2-表一要保留的-18-个)
3. [表二:不要的 5 个](#3-表二不要的-5-个)
4. [表三:要补的 8 个能力](#4-表三要补的-8-个能力)
5. [总账与目标清单](#5-总账与目标清单)
6. [附录 A:判定所用的手册条目原文出处](#6-附录-a判定所用的手册条目原文出处)
7. [附录 B:核对证据(存档,非本次判据)](#7-附录-b核对证据存档非本次判据)
8. [未决项](#8-未决项)
9. [落地记录](#9-落地记录2026-09-19-执行)
---
## 1. 判定口径
**严格口径:手册里查得到独立条目才算「要」。** 条目范围按手册自身的三层展开,缺一不可:
| 层 | 出处 | 说明 |
|---|---|---|
| 20 个能力 | 手册 L376-622 | 产品手册第二部分,五大板块 |
| 16 个典型场景 | 手册 L238-302 | 「看看它都能做什么」,业务覆盖面比 20 能力更广 |
| 业务点 | 手册第一部分 | 零散业务点,如 L195「日报汇总→一键周报」 |
**推论**:一个技能只要服务的业务在手册任一层有条目,即判「要」;三层都查无此条目,判「不要」。**判据中不含实现状态、不含专员依赖、不含技术难度。**
---
## 2. 表一:要保留的 18 个
| # | 技能 | 手册出处 |
|---|---|---|
| 1 | smart-assistant | 能力① 智能助手 |
| 2 | ocr-understanding | 能力⑤ 图片/扫描件智能识别;场景15 |
| 3 | report-generation | 能力⑥ 一键生成报告 |
| 4 | ppt-generation | 能力⑦ 一键生成PPT;场景06 |
| 5 | batch-extract | 能力⑧ 批量字段提取→Excel;场景03 |
| 6 | document-translate | 能力⑫ 文档翻译;场景09 |
| 7 | copy-proofreading | 能力⑬ 文案校对;场景05 |
| 8 | audio-transcribe | 能力⑭ 会议音频分析;场景13 |
| 9 | meeting-minutes | 能力⑭ 会议音频分析(纪要 + 待办);场景04 |
| 10 | mind-map | 能力⑭ 会议音频分析(思维导图) |
| 11 | table-cleanup | 能力③ 知识库表格视图;场景14 |
| 12 | interview-summary | 能力⑱ 招聘简历助手;场景01 |
| 13 | policy-rewrite | 能力⑲ 公文辅助写作;场景05 |
| 14 | longform-writing | 能力⑲ 公文辅助写作;场景11 |
| 15 | contract-review | 场景02 合同批量审查与提取 |
| 16 | contract-brief | 场景02 合同批量审查与提取 |
| 17 | progress-report | 手册业务点「日报汇总→一键周报」(L195) |
| 18 | **text-to-speech** | **净增项 —— MyGPT 三层均无此条目** |
> 第 8–10 项是能力⑭「会议音频分析」的三个组成部分,手册该条目明确写有「转写(带说话人标签)→ 纪要 + 待办清单 + 思维导图」,故由三个技能共同承担,均判「要」。
---
## 3. 表二:不要的 5 个
| 技能 | 手册 20 能力 | 手册 16 场景 | 手册业务点 | 判定 |
|---|---|---|---|---|
| email-drafting | 无 | 无 | 无 | **不要** |
| survey-summary | 无 | 无 | 无 | **不要** |
| proposal-summary | 无 | 无 | 无 | **不要** |
| project-planning | 无 | 无 | 无 | **不要** |
| text-toolkit | 无 | 无 | 无 | **不要** |
> 这三个(email-drafting、survey-summary、proposal-summary)曾按「与能力⑥沾边」判过「要」,严格口径下改判「不要」:手册未将其列为任何独立条目。若日后放宽为「能力⑥报告能涵盖问卷汇总 / 方案摘要」的宽口径,此三者应回到「要」,保留数变 21。
---
## 4. 表三:要补的 8 个能力
| # | MyGPT 能力 | 我们现状 |
|---|---|---|
| 4 | PDF 大文件问答 | 无 |
| 9 | Excel 数据分析与可视化 | 无 |
| 10 | 工作流引擎 | 无 |
| 11 | 兼容 API | 无 |
| 15 | AI 会议室 | 无 |
| 16 | 财经研报分析助理 | 无 |
| 17 | 法律案例研究助理 | 无 |
| 20 | 离境退税客服 | 无 |
---
## 5. 总账与目标清单
```
现有技能 23 个
├─ 保留 18 个(17 个现有 + text-to-speech 净增项)
└─ 不要 5 个
待补能力 8 个
────────────────────────────
目标清单 26 项 = MyGPT 20 能力全覆盖 + text-to-speech
```
---
## 6. 附录 A:判定所用的手册条目原文出处
**20 能力(手册 L376-622)**,五大板块:
| 板块 | 能力 |
|---|---|
| 一、智能对话与知识问答(5) | ① 智能助手 ② 知识库问答 ③ 知识库表格视图 ④ PDF 大文件即时问答 ⑤ 图片/扫描件智能识别 |
| 二、AI 员工自动交付(4) | ⑥ 一键生成报告 ⑦ 一键生成PPT ⑧ 批量字段提取→Excel ⑨ Excel 数据分析与可视化 |
| 三、工作流自动化(2) | ⑩ 工作流引擎 ⑪ 兼容 API |
| 四、办公工具直接使用(4) | ⑫ 文档翻译 ⑬ 文案校对 ⑭ 会议音频分析 ⑮ AI 会议室 |
| 五、行业专业助手(5) | ⑯ 财经研报分析助理 ⑰ 法律案例研究助理 ⑱ 招聘简历助手 ⑲ 公文辅助写作 ⑳ 离境退税客服 |
**16 典型场景(手册 L238-302)**,本次判定实际用到的:
| 场景 | 名称 | 本次涉及 |
|---|---|---|
| 01 | 简历批量筛选 `HR/人事` | interview-summary |
| 02 | 合同批量审查与提取 `法务/采购` | contract-review、contract-brief |
| 03 | 发票批量识别与对账 `财务` | batch-extract |
| 04 | 会议纪要自动生成 `办公室/行政` | meeting-minutes |
| 05 | 公文起草与校对 `机关/国企办公室` | policy-rewrite、copy-proofreading |
| 06 | 一键生成 PPT 汇报 | ppt-generation |
| 09 | 文档翻译保留排版 | document-translate |
| 11 | 长文档/年报快速摘要 | longform-writing |
| 13 | 视频课程/培训材料转文字 | audio-transcribe |
| 14 | Excel 数据分析与可视化 | table-cleanup |
| 15 | 图片/证件识别提取 | ocr-understanding |
**业务点**:手册 L195「📋 日报汇总 → 一键周报」→ progress-report。
---
## 7. 附录 B:核对证据(存档,非本次判据)
> 本节记录 2026-09-19 核对代码时确认的事实。**本次「要不要」结论不依据本节**(用户明确要求不考虑实现),此处仅为落地阶段留存,避免重复核查。
**技能执行体分层(后端)**
| 层 | 技能 | 依据 |
|---|---|---|
| 真调模型(已迁移进 skills/) | report-generation | `internal/skills/packages/report_generation/report_content.go`(569 行)+ report_export.go |
| 真调模型(仍在 legacy `internal/api/`) | contract-review(461行)、copy-proofreading(282行)、document-translate(260行)、audio-transcribe(174行)、batch-extract(166行) | 路由见 `internal/api/router.go:149/152/155/164` |
| 模板拼装(不调模型) | ppt-generation、mind-map、longform-writing、text-toolkit、meeting-minutes、project-planning、table-cleanup、proposal-summary、progress-report、contract-brief、interview-summary、policy-rewrite、survey-summary | `internal/skills/runtime/office/builders_*.go`(1761 行),全族统一走 `POST /api/skills/office/execute` |
| 工具型(非模型) | ocr-understanding(`/office/ocr`)、text-to-speech(`/office/tts`,edge-tts) | `internal/skills/api/tts_handlers.go`(未提交) |
| 无执行体 | smart-assistant | 仅 manifest;通用对话由 `/api/chat/message` 承担 |
**手册卖点 vs 我们的差距(体验层,已核实)**
| 手册卖点 | 我们的实际 |
|---|---|
| 文案校对返回「带高亮修订版 + 一键采纳」 | 只返回 `total_issues` |
| 会议音频分析「自动区分说话人」 | 无说话人识别 |
| PDF 直接拖进聊天框即可问答 | 需先入知识库 |
| 一键出 .pptx / .xlsx | 导出能力真实存在,但入口挂在报告导出(`report_handlers.go:105/153`),不挂在 ppt-generation / batch-extract 自身 |
**删除的依赖图(落地阶段必看)**
| 技能 | 被哪些专员 `AllowedSkills` 绑定 |
|---|---|
| email-drafting | logistics-fulfillment、hr-email-sorter、process-coordination |
| proposal-summary | presentation-briefing、solution-proposal |
| project-planning | process-coordination、solution-proposal |
| survey-summary | 无 |
| text-toolkit | 无 |
`internal/skills/core/allowed_skills.go` 的技能白名单由技能注册表构建,删除技能条目会导致仍引用它的专员校验失败。
**seed 演示数据**:`internal/store/seed.go:817-969` 按 `SkillKey` 播放演示应用与任务(meeting-minutes、contract-brief、proposal-summary、progress-report、ppt-generation、mind-map、ocr-understanding),删除技能需连带处理。
---
## 8. 未决项
1. ~~**表二 5 个技能的落地方式未定**~~ → **已决**:A 案「删条目 + 改专员」已执行,见 §9。
2. **表三 8 个能力的排期未定**:口语料壁垒型(⑯财经研报、⑰法律案例、⑳离境退税客服)依赖外部数据源,与平台机制型(⑨⑩⑪⑮)不同类,需分开排期。
3. **平台培训学习模块未纳入本次对标范围**:courses、exam、essay_grade、points、certificate 等为 MyGPT 所无,是否一并纳入「全面学习 MyGPT」的对标,待定。
---
## 9. 落地记录(2026-09-19 执行)
**A 案:删条目 + 改专员。** 表二 5 个技能已从代码与样例两侧移除,共 4 层 13 处。
| 层 | 改动 |
|---|---|
| 专员绑定(**前置,必先改**) | 5 个专员的 `AllowedSkills` 摘除对应 key:logistics-fulfillment、hr-email-sorter、process-coordination、presentation-briefing、solution-proposal |
| 技能注册表 | `internal/skills/core/builtin.go` 23 → 18 项 |
| 办公运行时注册表 | `internal/skills/runtime/office/builtin.go` 15 → 10 项 |
| 模板拼装实现 | `builders_communication.go`、`builders_structure.go`、`builders_writing.go` 删 5 个 `Build*` 函数,连带 3 个失去唯一调用方的 helper |
| 后端技能包 | `internal/skills/packages/` 删 5 个目录 |
| 演示应用种子 | `internal/store/seed.go` 删 `app-proposal-summary` 条目 |
| 前端 | `skills/core/builtin.js`、`skills/packages/officeExecutions/index.js`、`config/projectTemplates.js` 摘引用;删 5 个 `packages/` 目录;`skills/shared/officeArtifacts.js` 删 3 个死 helper |
| 样例数据 | `assets/sampledata/` 删 5 个目录 + 总索引表 |
| 存量数据 | **无需清理**(见下) |
**为什么顺序不能反**:`allowed_skills.go` 的白名单由技能注册表构建,`main.go:42` → `SeedSpecialists` → `ValidateAllowedSkills` 对不上就 `log.Fatalf`。先删技能、后改专员,进程起不来。
**存量数据核查结论**:实库 `backend-go/data/eai_agentplatform.db` 的 schema 早于 `specialist.allowed_skills` 列与 `xapp_definition` 表,库中本就没有这两个字段,不存在「残留已删 key 的行」。下次启动 AutoMigrate + 播种会直接写入清洗后的值。已用**实库副本**起服务验证:`专员岗位说明书 11/11,技能绑定 11/11` + 正常监听,无 Fatalf;实库文件未被触碰。
**验收**:
- `go build ./...` 通过
- `go test ./...` 仅剩既有失败 `TestValidSkillKeysMatchFrontend`,报 `text-to-speech` 一个 key(TTS 净增项尚未建前端包,与本次删除无关)。该测试**双向**比对,`onlyFrontend` 方向为空 —— 即删除前后新增的不匹配 key 为 **0**。
- 前端 `npm run build` 通过
**未动**:表三 8 个能力的新增、以及平台培训学习模块的对标(原 §8-2、§8-3)。本次只执行「删」。