禅道工作日志分析

要解决的问题

禅道按人导出的工作日志 Excel 往往有几百上千行，靠人工翻表格很难快速回答几个基本问题：每个人到底在忙什么？他填写的项目和他实际做的工作对得上吗？哪些日志是同一份内容改改日期就贴上去的？哪些人的工时分配明显不合理？这个技能就是把这些核对工作交给脚本自动完成。

核心能力

分析结果输出为一个包含 4 个子表的 .xlsx 文件：

• 人员主要工作分析 — 每人的工作汇总、项目归属和日志摘要
• 问题分析与建议 — 团队层面的问题诊断与改进方向
• 工时合理性分析 — 工时占比、聚焦度、行业对标和星级评级
• 重复日志检测 — 在子项级别做跨日重复比对，找出模板化填写

分类逻辑是数据驱动的：优先从「对象」列（任务 / BUG / 待办标题）提取核心词作为分类名；标题太通用时，用 15 类通用关键词从工作内容里识别。嵌入式团队的日志会归入「固件开发」，Web 团队归入「前端开发」，不会硬套其他部门的术语。

关键步骤

1. 准备禅道默认导出格式的 Excel（编号、日期、记录人、工作内容、耗时、对象 为必填列）
2. 运行捆绑的脚本 scripts/analyze_logs.py（推荐，输出稳定一致），可选 --sheet 指定读取的 Sheet
3. 也可以在 WorkBuddy 对话中直接触发，它会定位并执行同一脚本
4. 打开生成的 .xlsx，人工复核结论后使用

使用边界

• 日志数据至少覆盖 2 周工作日，太短的样本分析不出规律
• 工作内容写得太空（如只写「日常事务」）会让分类和重复检测失效
• 同一人的姓名必须保持一致，否则汇总会被拆散
• 项目错配以红色字体标注在备注列，但它只提示异常，不代替人工判断
• 报告中的结论仅供参考，建议复核后再用于绩效或资源调配