sf-workbook-updater

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	更新差异报告（可选）

注意事项

1. 永远不要直接修改原始文件，始终创建副本
2. 必须等待用户确认后才能更新 Workbook
3. 提供 SAP SuccessFactors 专业建议，不仅仅是记录需求
4. 版本历史：在 Workbook 的版本历史 sheet 中记录更新