禅道工作日志分析技能 (ZenTao Work Log Analyzer)

概述

本技能读取禅道导出的人员工作日志Excel文件，自动生成包含4个子表的分析报告：

人员主要工作分析 — 每人工作汇总、项目归属（含错配红色标注）、日志摘要
问题分析与建议 — 团队问题诊断及改进方案
工时合理性分析 — 工时占比、聚焦度、行业对标、★评级
重复日志检测 — 子项级跨日重复检测，识别模板化填写

分类方法

数据驱动动态分类 — 分类名称完全从数据中提取，无硬编码域特定词汇：

优先从「对象」字段（任务/BUG/待办标题）提取核心词作为分类名
若标题为通用描述（如"5月X日事务处理"），用15类通用关键词从内容检测
保证：嵌入式团队→"固件开发"，Web团队→"前端开发"，不会套用其他部门术语

项目归属检测

Sheet 1新增「所属项目」列，列出每人在日志中关联的项目。同时自动检测日志内容与填写项目是否匹配：

若实际工作内容推断的项目与填写项目不符，在备注中以 红色字体 标注
帮助发现项目工时统计失真问题

执行方式

方式一：直接运行脚本（推荐，输出一致）

本技能捆绑了独立的Python分析脚本 scripts/analyze_logs.py。执行时直接运行该脚本即可获得格式和内容完全一致的报告：

python3 scripts/analyze_logs.py <日志文件.xlsx> [输出文件.xlsx]

可选参数：

--sheet <名称>：指定读取的Sheet（默认第一个Sheet）

方式二：通过WorkBuddy对话触发

向 WorkBuddy 发送：

分析这个人员日志文件，生成分析报告 @"/path/to/日志.xlsx"

WorkBuddy 会自动定位并执行 scripts/analyze_logs.py 脚本。

输出

生成一个 .xlsx 文件，包含4个子表。格式和内容与脚本 scripts/analyze_logs.py 的输出完全一致。

输入要求

Excel文件需包含以下列（禅道默认导出格式）：

| 列名 | 必填 | 说明 | |------|------|------| | 编号 | 是 | 日志唯一编号 | | 日期 | 是 | YYYY-MM-DD | | 记录人 | 是 | 人员姓名 | | 工作内容 | 是 | 工作详细描述 | | 耗时 | 是 | 小时，支持小数 | | 对象 | 是 | 关联任务/需求 | | 产品 | 否 | 所属产品线 | | 项目 | 否 | 所属项目 |

注意事项

日志数据至少覆盖2周工作日
工作内容描述应详实，避免空泛（如仅写"日常事务"）
同一人姓名需保持一致
报告中的分析结论建议人工复核后使用

文件结构

zen-tao-work-log-analyzer/
├── SKILL.md                    # 本文件
├── scripts/
│   └── analyze_logs.py         # 核心分析脚本
├── 使用说明.md                  # 用户使用指南
└── 功能说明.md                  # 技术功能说明