| name | sf-workbook-updater |
| description | SAP SuccessFactors Workbook 更新助手。处理录音转写、会议记录或 Workbook 草稿，提取需求并更新到标准 Workbook。触发场景：(1) 用户提供录音文件需要转写成会议记录 (2) 用户提供会议记录文本需要提取需求 (3) 用户提供 Workbook 草稿需要对齐标准格式 (4) 用户需要根据会议内容更新 Workbook (5) 用户提到 "更新 workbook"、"会议纪要转workbook"、"需求提取"。更新内容用红色高亮，文件名带时间戳。 |
SAP SuccessFactors Workbook 更新助手
工作流程
输入 → 需求提取 → 用户确认 → 创建副本 → 更新Workbook → 红色高亮
输入类型处理
1. 录音文件
- 使用 ppocrv5 或 Whisper 进行语音转写
- 生成 transcript.md
- 继续按会议记录流程处理
2. 会议记录文本
- 解析会议内容，识别需求、决策、待确认项
- 映射到 Workbook 字段结构
- 生成 requirements.yaml 供用户确认
3. Workbook 草稿
- 读取标准 Workbook 结构
- 对比草稿与标准格式差异
- 生成差异报告供用户确认
标准处理流程
Step 1: 解析输入并提取需求
读取输入内容后，提取以下结构化信息：
requirements:
- id: R-{date}-{seq}
module: Employee Central / Recruiting / 等
area: Personal Info / Job Info / 等
topic: 具体配置点
requirement: 需求描述
status: draft / confirmed / open
priority: high / medium / low
mapped_workbook_section: 对应的 Workbook section
implementation_note: SAP SF 实现建议
Step 2: 用户确认
以清晰格式展示提取的需求：
## 需求确认
| ID | 模块 | 字段 | 需求 | 实现建议 |
|----|------|------|------|----------|
| R-001 | EC | gender | 根据身份证自动判断 | Business Rules |
必须等待用户确认后才能继续更新 Workbook。
Step 3: 创建 Workbook 副本
- 文件名格式：
{原文件名}_updated_{YYYYMMDD_HHMMSS}.xlsx
- 保持原始文件不变
Step 4: 更新 Workbook
使用 scripts/update_workbook.py 脚本：
python scripts/update_workbook.py <workbook_path> --requirements requirements.yaml
更新规则：
- 定位目标字段在 Workbook 中的位置（Sheet、行号）
- 在 Comments 列添加业务规则和实现建议
- 红色背景高亮新增内容
- 黄色背景高亮整行以示关注
Step 5: 添加 SAP SuccessFactors 实现建议
根据需求类型提供专业建议，参考 references/sf-implementation.md。
Workbook 结构参考
标准 Workbook 结构详见 references/workbook-structure.md。
核心字段定位逻辑：
- 系统字段id 在第 3 列（C列）
- 自定义标签 在第 7 列（G列）
- Comments 在最后一列
高亮样式规范
red_fill = PatternFill(start_color='FF6B6B', end_color='FF6B6B', fill_type='solid')
red_font = Font(color='FFFFFF', bold=True)
yellow_fill = PatternFill(start_color='FFFF00', end_color='FFFF00', fill_type='solid')
yellow_font = Font(color='000000', bold=True)
使用示例
示例 1：从会议记录更新
用户：根据这条会议记录更新 workbook：个人信息的性别要根据身份证号自动判断
处理流程：
1. 提取需求：gender 字段自动计算
2. 定位：个人信息PersonalInfo sheet，gender 字段
3. 确认：展示需求映射
4. 更新：创建副本，添加业务规则，红色高亮
5. 建议：使用 Business Rules 实现，触发条件配置
示例 2：录音文件处理
用户：这是会议录音，帮我更新 workbook [audio.m4a]
处理流程：
1. 转写录音 → transcript.md
2. 提取需求列表
3. 用户确认
4. 批量更新 Workbook
输出文件
| 文件 | 说明 |
|---|
{原文件名}_updated_{timestamp}.xlsx | 更新后的 Workbook 副本 |
requirements.yaml | 提取的结构化需求 |
workbook-diff.md | 更新差异报告（可选） |
注意事项
- 永远不要直接修改原始文件，始终创建副本
- 必须等待用户确认后才能更新 Workbook
- 提供 SAP SuccessFactors 专业建议，不仅仅是记录需求
- 版本历史：在 Workbook 的版本历史 sheet 中记录更新
