HR Workforce Dashboard 人力看板 — 人力资源工作力看板（HR Workforce Dashboard）

人力资源工作力看板目的 生成一个固定口径的工作力看板包从上传的Excel附件。默认产生5个标准看板，并允许可选的用户请求添加看板。输出一个自包含的dashboard.html作为主要交付物，具有可选的ZIP包装，包含HTML + PNG + EXCEL + PPT。这个技能不是一个通用的BI构建器。除非用户明确要求新的自定义看板，否则将看板定义、字段规则、BG映射、区域范围和离职公式视为固定业务逻辑。

何时使用 当用户：上传人力资源Excel文件并要求人力看板、看板、headcount dashboard、attrition dashboard、工作力报告；要求将活跃/终止/临时详细文件转换为可下载的看板；需要一个包含HTML、PNG、Excel或PowerPoint的工作力输出包；在人力资源数据或HR报告的背景下提到看板。

所需输入 预计一个或多个Excel附件。仅读取第一个工作表，除非用户明确指定其他。附件结构有三种类型，文件类型始终从第一行内容（报告名称）确定，而不是从文件名确定。活跃文件（在职明细）：第一行到第六行是元数据，第七行是标题，第八行及以后是数据。第一行：报告名称，固定值为“海外在职员工报告”。第四行：快照日期，格式为“生效日期 | <日期>”。第二行到第三行、第五行和第六行被忽略。终止文件（离职明细）：第一行到第七行是元数据，第八行是标题，第九行及以后是数据。第一行：报告名称，固定值为“海外终止员工报告”。第四行：开始日期，格式为“终止日期从 | <日期>”。第五行：结束日期，格式为“终止日期至 | <日期>”。第二行到第三行、第六行和第七行被忽略。临时工人文件（外包人员明细）：第一行：报告名称包含“临时工人”（例如“海外临时工人报告”）。第二行：标题行。第三行及以后：数据行。数据始终是最新的快照；不需要快照日期元数据。工人类型从WeCom名称前缀确定：v_ → 合同工人，p_ → 合作伙伴。国家名称为中文；脚本具有内置的中文到英文和区域映射。永远不要从文件名推断文件类型。旧的元数据格式（第一行的键值对）不被支持。

所需数据字段 正式表格应包含以下业务字段（如适用）：活跃和终止文件：员工类型、区域、WD、员工ID、国家/地区、BG、入职日期、终止日期（仅终止）、终止类别（仅终止）。临时工人文件：总部员工ID（或任何包含“员工”和“ID”的列）、WeCom名称（用于分类合同工人与合作伙伴）、国家/地区（中文国家名称）、BG。从元数据行应用快照日期，而不是从文件名。将员工类型视为固定枚举：常规、实习生。将活跃文件视为仅活跃快照。将终止文件视为离职统计的来源。将临时工人文件视为合同工人/合作伙伴分布的最新快照。

执行工作流

• 准备工作文件夹

在当前工作空间内创建一个工作目录，例如：mkdir -p workforce_dashboard_output

• 审查参考文档

在执行任务时使用以下参考文档：references/field_mapping.md、references/metric_definitions.md、references/layout_spec.md

• 运行主生成脚本

在每个上传的Excel附件上运行捆绑脚本：python3 "{skill_path}/scripts/build_dashboard_bundle.py" --files ... --output-dir workforce_dashboard_output 可选参数：--bundle-name workforce_dashboard --title "人力数据看板" 脚本自动通过读取第一行来分类每个文件：活跃 → 标准读取（第一行到第六行元数据，第七行标题）；终止 → 标准读取（第一行到第七行元数据，第八行标题）；临时 → 专用读取器（第一行名称，第二行标题，第三行及以后数据）。

• 审查输出包

验证输出目录包含：dashboard.html（始终生成 — 主要交付物）。如果请求完整包模式，也检查：png/dashboard_1.png至png/dashboard_4.png、excel/workforce_dashboard.xlsx、ppt/workforce_dashboard.pptx、summary.md、workforce_dashboard.zip

• 报告降级场景

如果比较月份或附件类型缺失，请不要停止，除非活跃快照输入完全不可用。继续生成所有可能的输出，并清晰地标记不完整的部分为“数据不完整”。指出哪些月份或数据集类型缺失。提醒用户，重新上传缺失的文件将产生完整版本。

固定看板定义 看板1 — 正式员工趋势图 生成一个两部分的趋势视图，使用ECharts交互式分组条形图：左图：同比（同一月份去年与最新月份）；右图：最近三个月的月度趋势（环比）。功能：悬停时显示详细数据的交互式工具提示。