get_team_productivity
Analyze team productivity patterns and performance across multiple dimensions including task completion, collaboration, and code quality within specific timeframes and project contexts.
Instructions
Analyze team productivity patterns and performance
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team_members | No | Specific team member IDs to analyze (optional) | |
| project_id | No | Project context for analysis (optional) | |
| time_range | No | Time range for analysis | month |
| productivity_dimensions | No | Dimensions of productivity to measure |
Implementation Reference
- src/tools/analytics-insights.ts:170-223 (handler)The main handler function for the get_team_productivity tool. It parses input using the schema, fetches team data, analyzes productivity dimensions, calculates overall score, generates insights, and returns the productivity analysis.export const getTeamProductivity = requireAuth(async (args: any) => { const { team_members, project_id, time_range, productivity_dimensions } = GetTeamProductivitySchema.parse(args) logger.info('Analyzing team productivity', { team_members, project_id, time_range }) // Get team data const teamData = await getTeamData(team_members, project_id, time_range) const productivity: any = { time_range, team_size: teamData.members.length, project_context: project_id, analyzed_at: new Date().toISOString(), dimensions: {} } // Analyze each productivity dimension for (const dimension of productivity_dimensions) { try { switch (dimension) { case 'task_completion': productivity.dimensions.task_completion = analyzeTaskCompletion(teamData) break case 'collaboration': productivity.dimensions.collaboration = analyzeCollaboration(teamData) break case 'code_quality': productivity.dimensions.code_quality = analyzeCodeQuality(teamData) break case 'documentation': productivity.dimensions.documentation = analyzeDocumentation(teamData) break case 'mentoring': productivity.dimensions.mentoring = analyzeMentoring(teamData) break case 'innovation': productivity.dimensions.innovation = analyzeInnovation(teamData) break } } catch (error) { logger.error(`Failed to analyze ${dimension}:`, error) productivity.dimensions[dimension] = { error: 'Analysis failed' } } } // Calculate overall productivity score productivity.overall_score = calculateOverallProductivityScore(productivity.dimensions) // Generate team insights productivity.insights = generateTeamInsights(productivity.dimensions, teamData) productivity.improvement_suggestions = generateImprovementSuggestions(productivity.dimensions) return productivity })
- Zod schema for validating input parameters to the get_team_productivity tool, including team_members, project_id, time_range, and productivity_dimensions.const GetTeamProductivitySchema = z.object({ team_members: z.array(z.string()).optional(), project_id: z.string().optional(), time_range: z.enum(['week', 'month', 'quarter']).default('month'), productivity_dimensions: z.array(z.enum(['task_completion', 'collaboration', 'code_quality', 'documentation', 'mentoring', 'innovation'])).default(['task_completion', 'collaboration']) })
- src/tools/analytics-insights.ts:129-161 (registration)MCPTool registration defining the get_team_productivity tool with name, description, and input schema (JSON schema version).export const getTeamProductivityTool: MCPTool = { name: 'get_team_productivity', description: 'Analyze team productivity patterns and performance', inputSchema: { type: 'object', properties: { team_members: { type: 'array', items: { type: 'string' }, description: 'Specific team member IDs to analyze (optional)' }, project_id: { type: 'string', description: 'Project context for analysis (optional)' }, time_range: { type: 'string', enum: ['week', 'month', 'quarter'], default: 'month', description: 'Time range for analysis' }, productivity_dimensions: { type: 'array', items: { type: 'string', enum: ['task_completion', 'collaboration', 'code_quality', 'documentation', 'mentoring', 'innovation'] }, default: ['task_completion', 'collaboration'], description: 'Dimensions of productivity to measure' } } } }
- src/tools/analytics-insights.ts:786-791 (registration)Export mapping handlers to tool names, registering get_team_productivity to getTeamProductivity function.export const analyticsInsightsHandlers = { get_project_analytics: getProjectAnalytics, get_team_productivity: getTeamProductivity, get_workspace_health: getWorkspaceHealth, generate_custom_report: generateCustomReport }
- src/tools/analytics-insights.ts:779-784 (registration)Export grouping all analytics tools, including getTeamProductivityTool.export const analyticsInsightsTools = { getProjectAnalyticsTool, getTeamProductivityTool, getWorkspaceHealthTool, generateCustomReportTool }