前言¶
企业微信导出的月度考勤表、请假异动和外出审批往往是三份独立的 xlsx。行政或 HR 若要在报表里标出「谁哪天请了假、谁外出」，再按规则统计迟到、早退和休息日，通常要在 Excel 里反复筛选、手工改单元格和配色。下面介绍 SkillHub 社区技能 @user_e99946b8/attendance-process（企业微信考勤报表工具），用约定目录下的脚本把标注与统计分析拆成两步，在当前项目目录内完成输入输出。
这是什么¶
企业微信考勤报表工具是 SkillHub 上分类为 office-efficiency 的社区技能（坐标 @user_e99946b8/attendance-process，发布版本 1.0.0，发布者 user_e99946b8）。它不调用外部 API（标签 requires_api_key=false），面向已从企业微信导出的 Excel：读取考勤报表、考勤异动申请（请假）与外出审批，先写回带字体检注的报表，再生成带颜色填充的统计分析表。技能说明中写明依赖 openpyxl 处理 xlsx。
核心功能¶
根据技能 SKILL.md 与参考文档 references/rules.md，已核实能力包括：
- 报表标注：在工作目录中匹配文件名含「考勤报表」的 xlsx；从
考勤异动申请/读取请假（审批「已通过」且时间覆盖考勤月），从外出/读取外出；将请假以红字新宋体 9 号、外出以黑字新宋体 9 号写入对应单元格，输出{年份年月份}考勤报表_已标注.xlsx。 - 统计分析：自动匹配含「考勤报表」与「已标注」的 xlsx，按员工与日期（上午/下午）生成单表；用颜色区分休息（灰）、迟到（浅红）、早退（浅黄）、请假（浅蓝）；支持迟到（上午上班晚于 8:30）、早退（下午下班早于 17:30）判定，并排除已标注请假/外出的格子。
- 节假日：
attendance_analysis.py内置 2026 年法定节假日与调休补班；其他年份需在脚本内HOLIDAYS_2026字典中自行维护。 - 匹配与规则细节：姓名支持简繁/异体字映射；外出跨天按起始/中间/结束日分别判定（技能说明中的 V2 改进）；输出文件名与输入文件匹配方式在 V3 说明中改为按模式自动识别。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按官方文档执行完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。官方页面给出的安装提示为：根据 SkillHub 安装说明 安装 @user_e99946b8/attendance-process。
命令行示例（将 <skills 目录> 换成你使用的客户端路径）：
skillhub install attendance-process --namespace user_e99946b8 --dir <skills 目录>
常见 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，在对话中提及考勤相关需求即可按技能说明触发 Agent 执行流程；无需配置 API Key。
典型用法¶
1、准备目录与导出文件¶
在项目根目录（技能示例中的「工作空间/考勤任务」一类路径）放置：
- 企业微信导出的月度考勤表：文件名包含「考勤报表」的
.xlsx - 子目录
考勤异动申请/：请假异动导出 xlsx - 子目录
外出/：外出审批导出 xlsx
列结构与审批字段需符合技能参考文档（如请假类型、开始/结束时间、审批状态「已通过」；外出含陪访人员列等）。详见技能包内 references/rules.md。
2、第一步：标注报表¶
先 cd 到上述项目目录，再执行（<skill_dir> 为安装后的技能路径，例如 ~/.cursor/skills/@user_e99946b8/attendance-process）：
cd <项目目录>
python <skill_dir>/scripts/mark_attendance.py
脚本会交互询问年份和月份，完成后在当前目录生成 {年份年月份}考勤报表_已标注.xlsx。
3、第二步：统计分析¶
仍在项目目录下运行：
cd <项目目录>
python <skill_dir>/scripts/attendance_analysis.py
脚本自动识别已标注报表与考勤年月，生成 {年份年月份}考勤统计分析.xlsx。
适用场景与注意¶
适合谁：每月用企业微信考勤、并固定导出「考勤报表 + 异动申请 + 外出」三类 Excel 的团队；希望由 Agent 按同一套规则做标注与着色统计，减少手工改表。
限制与注意：
- 报表版式需接近技能文档描述的块结构（每 Sheet 多名员工、固定列偏移与数据起始行等），否则脚本可能无法正确定位单元格。
- 节假日库当前以 2026 为主，跨年或新政策需改脚本字典。
- 技能为社区来源（
community），使用前可在 SkillHub 页面查看版本与说明；页面统计信息以商店展示为准（如评分、下载量会随时间变化）。
结尾¶
企业微信考勤报表工具把「请假/外出标注」和「迟到、早退、休息日着色统计」收成两条可复现的 Python 步骤，适合放在固定项目目录里按月跑一遍。官方 SkillHub 页面：企业微信考勤报表工具；技能坐标页：api.skillhub.cn/user_e99946b8/attendance-process。
