gitea_workflow_check_issues
Analyze open issues for workflow compliance by identifying missing labels, conflicts, and providing actionable improvement suggestions.
Instructions
Check all open issues against workflow rules. Identifies missing labels, conflicts, and provides suggestions for improvement.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | Repository owner. Uses context if not provided | |
| repo | No | Repository name. Uses context if not provided | |
| issue_number | No | Check only a specific issue (optional) | |
| rules | No | Apply only specific rules (optional) |
Implementation Reference
- src/tools/workflow.ts:370-489 (handler)Core handler function that loads workflow config, fetches open issues (or specific issue), uses LabelInferenceEngine and BoardSyncManager to check for missing labels, conflicts, backlog needs, and generates problems and suggestions.export async function workflowCheckIssues( ctx: WorkflowToolsContext, args: { owner?: string; repo?: string; config?: WorkflowConfig; issue_number?: number; rules?: string[]; } ): Promise<{ success: boolean; checked: number; issues_with_problems: Array<{ number: number; title: string; problems: string[]; suggestions: string[]; }>; error?: string; }> { logger.debug({ args: { ...args, config: args.config ? '[provided]' : undefined } }, 'Checking issues'); const { owner, repo } = ctx.contextManager.resolveOwnerRepo(args.owner, args.repo); // 获取配置 let config = args.config; if (!config) { const loadResult = await workflowLoadConfig(ctx, { owner, repo }); if (!loadResult.success || !loadResult.config) { return { success: false, checked: 0, issues_with_problems: [], error: loadResult.error || '无法加载配置', }; } config = loadResult.config; } const issuesWithProblems: Array<{ number: number; title: string; problems: string[]; suggestions: string[]; }> = []; try { // 获取 Issue 列表 let issues: Issue[]; if (args.issue_number) { const issue = await ctx.client.get<Issue>(`/repos/${owner}/${repo}/issues/${args.issue_number}`); issues = [issue]; } else { issues = await ctx.client.get<Issue[]>(`/repos/${owner}/${repo}/issues?state=open&limit=100`); } const inferenceEngine = new LabelInferenceEngine(config); const boardSyncManager = new BoardSyncManager(config); for (const issue of issues) { const problems: string[] = []; const suggestions: string[] = []; // 检查标签完整性 const missingLabels = inferenceEngine.checkMissingLabels(issue); if (missingLabels.length > 0) { problems.push(`缺少必要标签: ${missingLabels.join(', ')}`); // 推断标签 const inference = inferenceEngine.inferAll(issue); for (const item of inference.all) { suggestions.push(`建议添加标签 ${item.label} (置信度: ${(item.confidence * 100).toFixed(0)}%)`); } } // 检查标签冲突 const conflicts = boardSyncManager.checkLabelConflicts(issue); if (conflicts.length > 0) { problems.push(...conflicts); suggestions.push('建议保留最新的标签，移除冲突标签'); } // 检查是否需要添加到 Backlog if (boardSyncManager.shouldAddToBacklog(issue)) { const prefixes = getLabelPrefixes(config); suggestions.push(`建议添加 ${buildLabel(prefixes.status, 'backlog')} 标签`); } if (problems.length > 0 || suggestions.length > 0) { issuesWithProblems.push({ number: issue.number, title: issue.title, problems, suggestions, }); } } logger.info( { owner, repo, checked: issues.length, problems: issuesWithProblems.length }, 'Issues checked' ); return { success: true, checked: issues.length, issues_with_problems: issuesWithProblems, }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); logger.error({ owner, repo, error: errorMessage }, 'Failed to check issues'); return { success: false, checked: 0, issues_with_problems: [], error: errorMessage, }; } }
- src/tools-registry/workflow-registry.ts:152-183 (registration)MCP tool registration including title, description, input schema using Zod, and wrapper handler that calls the core workflowCheckIssues function and formats the response.// 5. gitea_workflow_check_issues - 检查并应用工作流规则 mcpServer.registerTool( 'gitea_workflow_check_issues', { title: '检查 Issue 工作流', description: 'Check all open issues against workflow rules. Identifies missing labels, conflicts, and provides suggestions for improvement.', inputSchema: z.object({ owner: z.string().optional().describe('Repository owner. Uses context if not provided'), repo: z.string().optional().describe('Repository name. Uses context if not provided'), issue_number: z.number().optional().describe('Check only a specific issue (optional)'), rules: z.array(z.string()).optional().describe('Apply only specific rules (optional)'), }), }, async (args) => { try { const result = await WorkflowTools.workflowCheckIssues( { client: ctx.client, contextManager: ctx.contextManager }, args ); return { content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }], isError: !result.success, }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: 'text' as const, text: `Error: ${errorMessage}` }], isError: true, }; } }
- Zod input schema defining optional owner/repo (resolved from context), optional issue_number for specific check, and optional rules array.inputSchema: z.object({ owner: z.string().optional().describe('Repository owner. Uses context if not provided'), repo: z.string().optional().describe('Repository name. Uses context if not provided'), issue_number: z.number().optional().describe('Check only a specific issue (optional)'), rules: z.array(z.string()).optional().describe('Apply only specific rules (optional)'), }),