# sampledata —— 全技能测试样例库

本目录为 **EAI 数字员工平台** 的测试样例数据，用于覆盖并验证平台全部技能（skill）的输入与预期产出。每个子目录对应一个技能（以技能的 key 命名），供接口联调、功能回归、演示与自动化测试复用。

## 目录约定

```
sampledata/
  README.md            # 本文件：总索引与使用说明
  shared/              # 跨技能共用的背景素材（公司简介、业务上下文等）
  <skill-key>/         # 每个技能一个子目录
    README.md          # 该技能：用途 / 样例文件 / 调用方式 / 期望产出
    input.*            # 输入样例（txt / md / json / 图片 / 音频）
    expected/          # （可选）期望产出参考
```

## 技能清单与覆盖情况

| 技能 key | 技能名 | 样例目录 | 实现状态 |
| --- | --- | --- | --- |
| audio-transcribe | 语音转写 | `audio_transcribe/` | 占位 |
| batch-extract | 批量抽取 | `batch_extract/` | 占位 |
| contract-brief | 合同要点提炼 | `contract_brief/` | 已实现 |
| contract-review | 合同审查 | `contract_review/` | 占位 |
| copy-proofreading | 文案校对 | `copy_proofreading/` | 占位 |
| document-translate | 文档翻译 | `document_translate/` | 占位 |
| interview-summary | 面试纪要 | `interview_summary/` | 已实现 |
| longform-writing | 长文写作 | `longform_writing/` | 已实现 |
| meeting-minutes | 会议纪要 | `meeting_minutes/` | 已实现 |
| mind-map | 思维导图 | `mind_map/` | 已实现 |
| ocr-understanding | OCR 图文理解 | `ocr_understanding/` | 已实现 |
| policy-rewrite | 政策解读改写 | `policy_rewrite/` | 已实现 |
| ppt-generation | PPT 生成 | `ppt_generation/` | 已实现 |
| progress-report | 周报 / 日报 | `progress_report/` | 已实现 |
| report-generation | 报告生成 | `report_generation/` | 已实现 |
| smart-assistant | 通用助手 | `smart_assistant/` | 占位 |
| table-cleanup | 表格清理 | `table_cleanup/` | 已实现 |
| text-to-speech | 文字转语音 | `text_to_speech/` | 已实现 |

> 「占位」指该技能目前仅有 manifest 定义、尚无专属运行时实现，样例仍可用来预置输入。

## 使用方式

1. **人工联调**：直接以 `input.*` 内容作为相应接口的请求体，对照 `expected/` 检查产出。
2. **前端演示**：进入对应专员的画布，粘贴 `input.*` 文本，触发技能执行。
3. **自动化测试**：样例文件均为纯文本 / JSON / 标准格式，可直接被 Go 或脚本读取并断言结果。

## 公共背景

所有样例统一围绕以下业务背景，保证跨技能素材一致：
- 平台：博昇数字员工平台
- 业务线：资本咨询、资质认定辅导、AI 咨询与落地、企业级 AI 工具与平台
- 方法论：顾问式销售（FABE / SPIN / LSCPA）
- 详见 [shared/公司背景.md](shared/公司背景.md)