禅道数据分析 (ZenTao Analytics)

🎯 核心功能

本技能用于分析禅道项目管理系统的员工任务数据，提供：

1. 1. 任务统计 - 任务数量、类型分布、状态分布
2. 工时分析 - 预估工时 vs 实际工时、工时趋势
3. 难度评估 - 任务难度系数、复杂度分析
4. 效率计算 - 任务完成率、工时效率比
5. 饱和度分析 - 工作负载、产能利用率

📋 使用流程

1. 配置禅道连接

编辑 references/zentao-config.md 配置禅道 API 或数据库连接：

bash

API 方式（推荐）

ZENTAO_URL=https://your-zentao.com
ZENTAOAPIKEY=yourapikey

或数据库方式

ZENTAODBHOST=localhost ZENTAODBNAME=zentao ZENTAODBUSER=user ZENTAODBPASS=password

2. 运行分析

bash

分析指定时间段

node scripts/analyze-tasks.js --start 2026-02-01 --end 2026-02-28

分析特定员工

node scripts/analyze-tasks.js --user 张三

分析特定项目

node scripts/analyze-tasks.js --project 项目 A

生成团队报告

node scripts/analyze-tasks.js --team-report

3. 查看报告

分析报告输出包括：

• - 📊 个人效率报告 - 每个员工的效率指标
• 📈 团队饱和度热力图 - 工作负载可视化
• 🎯 异常检测 - 过载/低负载员工识别
• 💡 优化建议 - 资源分配建议

📐 分析指标

效率指标

指标	计算公式	说明
任务完成率	完成任务数 / 总任务数	反映交付能力
工时效率比

预估工时 / 实际工时 | >1 表示高效 | | 平均任务耗时 | 总实际工时 / 完成任务数 | 单任务平均成本 | | 延期率 | 延期任务数 / 总任务数 | 时间管理能力 |

饱和度指标

指标	计算公式	健康范围
工作负载率	实际工时 / 标准工时	70%-90%
任务密度

任务数 / 工作日 | 3-8 个/天 | | 多任务指数 | 并行任务数 | 2-5 个 |

🔧 脚本说明

analyze-tasks.js

主分析脚本，支持以下参数：

bash
--start 开始日期 (YYYY-MM-DD)
--end 结束日期 (YYYY-MM-DD)
--user 指定员工
--project 指定项目
--team-report 生成团队报告
--output 输出路径
--format 输出格式

export-metrics.js

导出指标数据到外部系统：

bash

导出到 CSV

node scripts/export-metrics.js --format csv --output ./metrics.csv

导出到 JSON

node scripts/export-metrics.js --format json --output ./metrics.json

📚 参考资料

• - references/zentao-config.md - 禅道连接配置
• references/api-schema.md - 禅道 API 数据结构
• references/metrics-definition.md - 指标定义和计算逻辑

⚠️ 注意事项

1. 1. 数据权限 - 确保有访问禅道数据的权限
2. 隐私保护 - 员工数据仅用于内部管理
3. 定期同步 - 建议每天同步一次数据
4. 异常处理 - 网络故障时自动重试 3 次

📞 故障排查

问题	解决方案
连接失败	检查 zentao-config.md 配置
数据为空

确认日期范围和用户权限 | | 指标异常 | 检查原始数据完整性 |

---

版本: 1.0.0 作者: 硬石科技 AI 助手 更新: 2026-03-01