劳动力计划生成器 (Labor Plan Generator)

概述

根据施工进度计划（Excel .xlsx 或 .csv），自动完成：

1. 工种自动匹配 — 根据进度计划中的"分项工程"名称，在对应关系表中查找所需工种
2. 时间分配 — 按进度计划的时间节点，将工种需求分配到每日或每月
3. CSV 输出 — 生成标准格式的劳动力投入计划表

时间颗粒度规则：

可通过 --granularity day/month 强制指定，跳过自动判断。

触发条件

当用户提到以下关键词时触发此技能：

• 劳动力计划、用工计划、工种计划、人员计划
• 生成劳动力投入、工种配置表
• 根据进度计划生成工种分配
• 劳动力 CSV、用工 CSV
• labor plan、crew plan、worker allocation

前置条件

必需文件

• 进度计划文件（Excel .xlsx 或 .csv）— 用户输入
• 分项工程-工种对应关系表（MD 文件，位于 D:\000 Skill\劳动力计划\）— 技能自动引用

进度计划文件格式要求

进度计划文件至少包含以下列：

推荐的可选列（可提高人数计算精度）：

示例进度计划（最小格式）：

序号,工程类别,分项工程,开始日期,结束日期
1,建筑工程,土方开挖,2026-06-01,2026-06-05
2,建筑工程,钻孔灌注桩,2026-06-06,2026-06-15
3,建筑工程,筏板基础,2026-06-16,2026-06-30

执行流程

Step 1: 读取并验证进度计划

读取用户提供的进度计划文件 → 验证格式 → 检测工程类型 → 计算总工期 → 判断颗粒度

操作：

1. 用户上传/指定进度计划文件路径（.xlsx 或 .csv）
2. 如果没有文件路径，询问用户提供文件路径或上传文件
3. 检查文件是否存在、格式是否支持
4. 解析文件内容，自动检测列名映射
5. 计算总工期（最早开始 ~ 最晚结束）
6. 根据颗粒度规则（或 --granularity 参数）确定输出颗粒度
7. 告知用户：已识别 X 条工作计划，工程类型为 Y，总工期 Z 天，颗粒度为 day/month

工程类型自动检测优先级：

1. 列名中的关键词（建筑/市政/路桥）
2. 文件名中的关键词
3. 数据行中"工程类别"列的值
4. 默认: 建筑工程

Step 2: 工种匹配

分项工程名称 → 模糊匹配 → 对应关系表 → 工种列表

操作：

1. 对每条工作计划的"分项工程"名称，在对应关系表中进行三级匹配：
• 精确匹配：完全相同的名称
• 包含匹配：互相包含关系（如"土方开挖（基坑）"匹配"土方开挖"）
• 模糊匹配：使用 difflib 序列匹配（相似度 ≥ 0.4）
2. 每条工作获得其对应的工种列表（含主要/辅助角色）
3. 告知用户匹配结果：X 条匹配成功，Y 条未匹配

未匹配处理：

• 告知用户未匹配的分项工程名称
• 尝试去掉括号内容后重新匹配
• 建议用户检查分项工程名称是否与对应关系表一致

Step 3: 计算劳动力计划

工种 × 时间段 → 人数分配 → 按颗粒度聚合 → 矩阵汇总

人数计算规则：

人数配置优先级：

1. 进度计划中显式指定的"班组人数"列 → 优先使用
2. 工程量 × 定额工日 → 自动计算
3. 默认班组大小 → 兜底（--main-crew / --aux-crew）

时间颗粒度处理逻辑：

总工期 ≤ 62天  →  按日计算并输出（不做聚合）
总工期 > 62天  →  先按日计算，再按月聚合输出

内部始终按日计算，以保证精度；输出时按颗粒度决定表头格式。

Step 4: 生成 CSV 输出

工种-日期矩阵 → 按颗粒度格式化 → CSV 文件

CSV 格式（按日输出）：

工种,2026-06-01,2026-06-02,2026-06-03,合计
挖掘机司机,2,2,2,6
土方工,5,5,0,10
...
日合计,7,7,2,16

CSV 格式（按月输出）：

工种,2026年06月,2026年07月,2026年08月,合计
混凝土工,140,32,0,172
钢筋工,120,32,0,152
...
月合计,XXX,YYY,ZZZ,TTTT

• 第一行: 表头（工种 + 日期/月份列表 + 合计）
• 中间行: 每个工种一行，按合计工日降序排列
• 最后一行: 每日/每月所有工种人数汇总
• 编码: UTF-8 BOM（Excel 直接打开不乱码）

Step 5: 呈现结果

操作：

1. 将生成的 CSV 文件路径告知用户
2. 展示工种需求汇总表（前 20 个工种）
3. 提醒用户可用 Excel 打开 CSV 文件查看完整数据
4. 如存在警告（未匹配的分项工程），一并告知
5. 交付 CSV 文件作为附件

使用示例

示例 1：基础用法（自动判断颗粒度）

# 用户说："根据这个进度计划生成劳动力计划"
# 自动执行：
python scripts/labor_plan.py "进度计划.xlsx"
# 输出: 进度计划_劳动力计划.csv（按日或按月，自动判断）

示例 2：总工期 > 62 天，自动按月输出

# 进度计划总工期 120 天
python scripts/labor_plan.py "年度进度计划.xlsx"
# 自动检测：总工期 120 天 > 62 天 → 按月输出
# 输出: 年度进度计划_劳动力计划_按月.csv

示例 3：强制按日输出（覆盖自动判断）

python scripts/labor_plan.py "进度计划.xlsx" --granularity day

示例 4：强制按月输出

python scripts/labor_plan.py "进度计划.xlsx" --granularity month

示例 5：指定工程类型和输出路径

python scripts/labor_plan.py "schedule.csv" --project-type 路桥工程 --output "路桥劳动力计划.csv"

示例 6：调整默认班组人数

python scripts/labor_plan.py "schedule.xlsx" --main-crew 6 --aux-crew 3

示例 7：使用自定义映射表

python scripts/labor_plan.py "schedule.xlsx" --mapping "custom_mapping.json"

命令行参数

--granularity 参数详解：

文件结构

labor-plan/
├── SKILL.md                      # 本文件
├── references/
│   └── labor_mapping.json        # 工种映射数据（900条，从MD提取）
└── scripts/
    ├── labor_plan.py             # 核心脚本
    └── extract_mapping.py        # 映射数据提取工具（维护用）

输出检查清单

生成完成后，确认：

• [ ] CSV 文件可以正常打开（Excel / WPS / 文本编辑器）
• [ ] 工种列名来自对应关系表（非凭空编造）
• [ ] 日期/月份范围覆盖进度计划的全周期
• [ ] 每个工种的人数在起止日期内分布合理
• [ ] "日合计"或"月合计"行 = 各工种每日/每月人数之和
• [ ] 已告知用户未匹配的分项工程（如有）
• [ ] 颗粒度判断正确（≤62天按日，>62天按月）或被 --granularity 正确覆盖