docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录，统一中文命名与目录分层，并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
eaiadmin
@@ -0,0 +1,218 @@
|
||||
# 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）。本次只执行「删」。
|
||||
Reference in New Issue
Block a user