配置 · 规则

考勤规则包

attendance-rule-pack

📐

配置与交付 skills/attendance/

把客户考勤口径先落成「可复核规则 workbook + attendance_config.json 草稿」，再交给 attendance-remarks、attendance-exception-review 或客户专属脚本使用。先把规则说清楚、把不确定的写进「待确认」，再算备注。

◧

FLOW TYPES

流程类型 A/B/C/D--flow-type

A数据员宽表型

代表客户：追觅。

B考勤报表 + 异常凭证型

代表客户：珠海基石（客户系统导出）、奥托立夫（钉钉）。

C钉钉内置核算 + 书面规则型

代表客户：启云方。

D客户系统 PDF + 确认单型

代表客户：国家电投。

⚡

TRIGGERS

触发场景

▸启云方书面规则 docx 要落成机器可读配置

▸奥托立夫早班/中班/夜班/上海班次规则要书面化

▸国家电投确认单加班费合计公式要确认

▸新客户口径先落成可复核规则，再算备注

↹

INPUT & OUTPUT

输入 / 产出

↘ INPUT · 输入

客户名 client_name
月份 pay_period（YYYYMM）
输出目录 output_dir
客户口径：班次/假别/加班去向/法定日/计薪天
书面规则 docx、顾问确认表

↗ OUTPUT · 产出

attendance_config.json —— 给 attendance-remarks 使用的配置草稿
attendance_rule_pack.xlsx —— 给顾问/HR 复核的规则参数、异常类型、流程规则和待确认项

🪜

STEPS

处理流程

1
选流程类型
按客户确定 --flow-type 为 A / B / C / D，套对应规则骨架。
2
填当月日期口径
日期、标准计薪天、法定假日、休息日、补班日必须来自当月客户口径，不复用历史月。
3
拆解客户规则
班次、欠工时、加班核算、忘打卡、补签、弹性班次等逐条拆入配置。
4
列异常类型与待确认 GATE
不确定项写进 workbook 的「待确认」，不凭经验补值；待确认不为空时 config 只能当草表。
5
产出 config + 规则 workbook
attendance_config.json 给脚本用，attendance_rule_pack.xlsx 给顾问/HR 复核。

▤

OUTPUTS

产物清单

attendance_config.json

给 attendance-remarks 使用的配置草稿；待确认项关闭后才可作最终规则。

attendance_rule_pack.xlsx

给顾问/HR 复核的规则参数、异常类型、流程规则和待确认项。

qiyunfang_workbook_validation.xlsx

C 型启云方月末核算 workbook 校验：关键 sheet、员工标识列、负数核算值、规则关键字；有高优先级问题不应直接发账单或交付拆分版。

◎

USAGE NOTES

使用建议 · 各客户复核重点

B珠海基石

--flow-type B；源数据为客户系统导出原始记录（非钉钉/科之锐），中台发 .msg 凭证、中台与员工核对，交付中台。

B奥托立夫

--flow-type B；周期上月 21–本月 20；5 类子表从 OA 假勤管理导出；班次上海/早/中/夜；缺卡需员工核实；备注含加班/休假/调休时长。

C启云方

--flow-type C；现行规则 v2.0 定稿版；加班 = 电子流 ∩ 打卡且剔除午休+晚休；月末小周六不剔晚休；新增 F 班；结算 = 实际出勤天 × 人天单价。月末核算 workbook 可用 validate_qiyunfang_workbook.py 做结构/字段/负值/规则关键字校验。

D国家电投

--flow-type D；审批单据线下补充（劳勤不可导）；2026-06 起客户侧不再要劳勤 PDF；确认单含考勤+考核，考勤表+确认单都需签字。

⇄

PIPELINE

与其他 skill 衔接

←

客户由 attendance-project-triage 分诊选定流程类型与口径来源。

→

config 交给 attendance-remarks 算备注、attendance-exception-review 判异常。

⤳

或交给客户专属脚本使用（如 D 型回填确认单脚本，依确认单加班费合计公式落地）。

✓

ACCEPTANCE

闭环验收

✓attendance_rule_pack.xlsx 中「待确认」不为空时，不能把 config 当成最终规则。
✓日期、标准计薪天、法定假日、休息日、补班日来自当月客户口径。
✓新增客户专属异常类型后，先进入 workbook 复核；稳定后再补脚本规则和测试。
✓未关闭「待确认」项的 config 只能用于草表，不能作为最终规则。（来源 LESSONS）

⊘

ANTI-PATTERNS

反例检查

✗

直接复用历史月份的法定日、休息日或计薪天。

✗

把「待确认」未关闭的 attendance_config.json 当成最终配置运行备注生成。

✗

启云方这类 C 型客户只写假期/加班关键词，却遗漏欠工时、补签、弹性班次和月中催办规则。

✗

国家电投 D 型客户未确认加班费合计公式就回填确认单。

✗

启云方月末 workbook 缺关键 sheet、员工标识列或规则关键字，却仍当作完整核算包交付。

↻

FAILURE & RETRY

失败重试

✗

客户口径不完整时，先生成带「待确认」的规则包，不凭经验补值。

✗

规则 docx 或顾问确认表冲突时，以最新顾问确认表为准，并在 workbook 中保留冲突说明。

✗

生成的 config 导致 attendance-remarks flags 激增时，回到规则包补充关键词和日期口径后重跑。

⊕

RETROSPECTIVE

复盘沉淀 · LESSONS 回写

✓客户专属规则、异常类型和公式变化写入本 skill 的 LESSONS.md。
✓确认可复用后，再更新默认规则、配置模板或测试。

⌘

RUN

运行命令

RUN · 运行命令

uv run python skills/attendance/attendance-rule-pack/scripts/build_rule_pack.py \
  <客户名> <YYYYMM> outputs/<目录名>/rule_pack \
  --flow-type B

# C 型启云方：月末核算 workbook 结构 / 字段 / 规则关键字校验
uv run python skills/attendance/attendance-rule-pack/scripts/validate_qiyunfang_workbook.py \
  <启云方月末核算workbook.xlsx> \
  outputs/<目录名>/qiyunfang_workbook_validation.xlsx