---

name: zentao-analytics description: 禅道任务数据分析技能。访问禅道数据库/API，分析员工任务数据（数量、工时、难度），计算工作效率和工作饱和度。使用场景：团队绩效评估、工作量分析、资源分配优化、项目进度监控。

禅道数据分析 (ZenTao Analytics)

🎯 核心功能

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

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

📋 使用流程

1. 配置禅道连接

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

# API 方式（推荐）
ZENTAO_URL=https://your-zentao.com
ZENTAO_API_KEY=your_api_key

# 或数据库方式
ZENTAO_DB_HOST=localhost
ZENTAO_DB_NAME=zentao
ZENTAO_DB_USER=user
ZENTAO_DB_PASS=password

2. 运行分析

# 分析指定时间段
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

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

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

export-metrics.js

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

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

📞 故障排查

问题	解决方案
连接失败	检查 zentao-config.md 配置
数据为空	确认日期范围和用户权限
指标异常	检查原始数据完整性

---

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