09
编排 · D 型（国家电投）

劳勤月度考勤（核电类）

attendance-laoqin-monthly
⚛️
入口与编排 skills/attendance/
把「顾问名单 → 劳勤 WTS 导出 PDF → 科室 Excel 汇总 → 确认单回填 → 科服交付」的月度流程标准化。负责流程编排与阶段门禁；PDF 归档用 data-prep、读取用 pdf-llm-preprocess、公式异常用 exception-review。
◧

FLOW TYPES

客户画像 / 流程类型
适用画像
客户自有劳勤 WTS（非飞书/钉钉）；按科室/车间组织；主交付员工 PDF + 工作量确认单；靠科室确认单闭环
试点客户
国家电投 / 核电（PMC North Qing wu）
⚡

TRIGGERS

触发场景
▸国家电投 / 核电月度考勤
▸劳勤 WTS 逐人导出 PDF
▸工作量确认单回填、科服交付
↹

INPUT & OUTPUT

输入 / 产出
↘ INPUT · 输入
  • 目录名 + 薪资月
  • 顾问当月名单（含劳勤账号密码）
  • 各科确认单空白模板
  • 可选已核对跳过名单
↗ OUTPUT · 产出
  • 考勤PDF/<科室>/<姓名>.pdf（+ 出差申请单据）
  • 科室 Excel + 回填确认单
  • 科服 PDF 夹 + 确认单 + 加班说明
🪜

PHASE GATES

阶段门禁（按序）7 阶段 · 不可跳门
  1. 0
    收名单与确认单GATE
    各科模板齐全；已核对跳过名单已标记。
  2. 1
    科室筛人 + 账号GATE
    按科室打开顾问名单，复制劳勤工号/密码，与确认单模板逐一比对。
  3. 2
    劳勤导出 PDFGATE
    逐人登录 WorkbenchCalendar，切月份，打印保存 PDF，文件名 = 员工姓名。
  4. 3
    填科室 ExcelGATE
    标黄周末加班、法定假日行、批注转调休；出差导 PDF；公式每月按 30/31 天调整，调休列手工。
  5. 4
    加班费合计GATE
    公休日 + 延长工时 + 法定节假日 − 已执行换休（顾问书面确认后写 config）。
  6. 5
    回填确认单GATE
    Excel 汇总列复制到确认单对应行；标注出勤工作日天数。
  7. 6
    交付科服GATE
    各员工考勤 PDF 文件夹（含出差单据）+ 各科签字确认单 + 加班说明。
⇄

PIPELINE

与其他 skill 衔接
→
编排调用 data-prep 归档 PDF → pdf-llm-preprocess 读 PDF → exception-review 查公式/单据异常。
⤳
不适用追觅类数据员宽表客户 → 改用 monthly-reconcile。
✓

ACCEPTANCE

闭环验收
⊘

ANTI-PATTERNS

反例检查
✗
套用 monthly-reconcile 的按人截图、飞书凭证流程。
✗
未核对顾问名单就开始逐人劳勤导出。
✗
确认单回填后未验算 Excel 加班费合计。
✗
21 个科室模板结构不一致却未记录在 rules_catalog_draft.md。
⌘

RUN

运行命令
RUN · 运行命令
# 编排调用下游 skill
uv run python skills/attendance/attendance-data-prep/scripts/prepare_attendance_data.py \
  data/raw/<目录名> outputs/<目录名>-<YYYYMM> --base-table <顾问名单.xlsx>

uv run python skills/utility/pdf-llm-preprocess/scripts/pdf_llm_preprocess.py \
  outputs/<目录名>-<YYYYMM>/考勤PDF/<科室>/<姓名>.pdf \
  --out-dir outputs/<目录名>-<YYYYMM>/pdf_pages/<姓名>

uv run python skills/attendance/attendance-exception-review/scripts/build_exception_review.py \
  outputs/<目录名>-<YYYYMM> <YYYYMM> ... --config <config.json>