mcp-probe-kit 1.15.1 → 2.0.0

package/build/schemas/output/helper-tools.js

@@ -0,0 +1,138 @@
+/**
+ * 辅助工具的结构化输出 Schema
+ * 包含: detect_shell, init_setting, gen_skill
+ */
+/**
+ * Shell Detection Schema
+ * 用于 detect_shell 工具的结构化输出
+ */
+export const ShellDetectionSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        shell: {
+            type: 'string',
+            enum: ['bash', 'zsh', 'fish', 'powershell', 'cmd', 'sh', 'unknown'],
+            description: '检测到的 Shell 类型',
+        },
+        version: { type: 'string', description: 'Shell 版本' },
+        os: {
+            type: 'string',
+            enum: ['linux', 'macos', 'windows', 'unknown'],
+            description: '操作系统',
+        },
+        features: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Shell 特性',
+        },
+        configFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    exists: { type: 'boolean' },
+                    purpose: { type: 'string' },
+                },
+            },
+        },
+        recommendations: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'shell', 'os'],
+};
+/**
+ * Setting Init Schema
+ * 用于 init_setting 工具的结构化输出
+ */
+export const SettingInitSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        settingsPath: { type: 'string', description: '设置文件路径' },
+        settings: {
+            type: 'object',
+            description: '推荐的设置',
+            additionalProperties: true,
+        },
+        applied: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    key: { type: 'string' },
+                    value: { type: 'string' },
+                    reason: { type: 'string' },
+                },
+            },
+        },
+        nextSteps: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'settingsPath', 'settings'],
+};
+/**
+ * Skill Doc Schema
+ * 用于 gen_skill 工具的结构化输出
+ */
+export const SkillDocSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        scope: {
+            type: 'string',
+            enum: ['all', 'single'],
+            description: '生成范围',
+        },
+        skills: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    toolName: { type: 'string' },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    category: { type: 'string' },
+                    useCases: {
+                        type: 'array',
+                        items: { type: 'string' },
+                    },
+                    examples: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                scenario: { type: 'string' },
+                                input: { type: 'string' },
+                                output: { type: 'string' },
+                            },
+                        },
+                    },
+                    parameters: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                name: { type: 'string' },
+                                type: { type: 'string' },
+                                required: { type: 'boolean' },
+                                description: { type: 'string' },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        outputPath: { type: 'string', description: '输出路径' },
+        format: {
+            type: 'string',
+            enum: ['markdown', 'json'],
+        },
+    },
+    required: ['summary', 'scope', 'skills'],
+};

package/build/schemas/output/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 结构化输出 Schema 索引
+ * 统一导出所有工具的结构化输出 Schema 和类型定义
+ */
+export * from './core-tools.js';
+export * from './generation-tools.js';
+export * from './workflow-tools.js';
+export * from './project-tools.js';
+export * from './ui-ux-tools.js';
+export * from './helper-tools.js';
+export { CommitMessageSchema, WorkflowReportSchema, BugFixReportSchema, FeatureReportSchema, UIReportSchema, OnboardingReportSchema, RalphLoopReportSchema, CommitMessage, WorkflowStep, Artifact, WorkflowReport, BugFixReport, FeatureReport, UIReport, OnboardingReport, RalphLoopReport, } from '../structured-output.js';
+/**
+ * Schema 映射表
+ * 工具名称 -> Schema 对象
+ */
+export declare const SCHEMA_MAP: {
+    readonly gencommit: "CommitMessageSchema";
+    readonly start_feature: "FeatureReportSchema";
+    readonly start_bugfix: "BugFixReportSchema";
+    readonly start_ui: "UIReportSchema";
+    readonly start_onboard: "OnboardingReportSchema";
+    readonly start_ralph: "RalphLoopReportSchema";
+    readonly code_review: "CodeReviewReportSchema";
+    readonly debug: "DebugReportSchema";
+    readonly fix_bug: "BugAnalysisSchema";
+    readonly gentest: "TestSuiteSchema";
+    readonly refactor: "RefactorPlanSchema";
+    readonly security_scan: "SecurityReportSchema";
+    readonly perf: "PerformanceReportSchema";
+    readonly gendoc: "DocumentationSchema";
+    readonly genapi: "APIDocumentationSchema";
+    readonly gensql: "SQLQuerySchema";
+    readonly genreadme: "ReadmeSchema";
+    readonly genui: "UIComponentSchema";
+    readonly gen_mock: "MockDataSchema";
+    readonly genchangelog: "ChangelogSchema";
+    readonly genpr: "PullRequestSchema";
+    readonly fix: "CodeFixSchema";
+    readonly explain: "ExplanationSchema";
+    readonly convert: "ConversionSchema";
+    readonly css_order: "CSSOrderSchema";
+    readonly start_review: "ReviewWorkflowSchema";
+    readonly start_release: "ReleaseWorkflowSchema";
+    readonly start_refactor: "RefactorWorkflowSchema";
+    readonly start_api: "APIWorkflowSchema";
+    readonly start_doc: "DocWorkflowSchema";
+    readonly init_project: "ProjectInitSchema";
+    readonly init_project_context: "ProjectContextSchema";
+    readonly add_feature: "FeatureSpecSchema";
+    readonly analyze_project: "ProjectAnalysisSchema";
+    readonly estimate: "EstimateSchema";
+    readonly check_deps: "DependencyReportSchema";
+    readonly split: "SplitPlanSchema";
+    readonly resolve_conflict: "ConflictResolutionSchema";
+    readonly ui_design_system: "DesignSystemSchema";
+    readonly ui_search: "UISearchResultSchema";
+    readonly sync_ui_data: "SyncReportSchema";
+    readonly design2code: "Design2CodeSchema";
+    readonly init_component_catalog: "ComponentCatalogSchema";
+    readonly render_ui: "RenderResultSchema";
+    readonly detect_shell: "ShellDetectionSchema";
+    readonly init_setting: "SettingInitSchema";
+    readonly gen_skill: "SkillDocSchema";
+};
+/**
+ * 获取工具的 Schema 名称
+ */
+export declare function getSchemaName(toolName: string): string | undefined;
+/**
+ * 检查工具是否支持结构化输出
+ */
+export declare function supportsStructuredOutput(toolName: string): boolean;
+/**
+ * 获取所有支持结构化输出的工具列表
+ */
+export declare function getSupportedTools(): string[];

package/build/schemas/output/index.js

@@ -0,0 +1,96 @@
+/**
+ * 结构化输出 Schema 索引
+ * 统一导出所有工具的结构化输出 Schema 和类型定义
+ */
+// 核心开发工具 (7 个)
+export * from './core-tools.js';
+// 代码生成工具 (12 个)
+export * from './generation-tools.js';
+// 工作流编排工具 (5 个)
+export * from './workflow-tools.js';
+// 项目管理工具 (8 个)
+export * from './project-tools.js';
+// UI/UX 工具 (6 个)
+export * from './ui-ux-tools.js';
+// 辅助工具 (3 个)
+export * from './helper-tools.js';
+// 从主 Schema 文件导出基础 Schema（P0 工具）
+export { CommitMessageSchema, WorkflowReportSchema, BugFixReportSchema, FeatureReportSchema, UIReportSchema, OnboardingReportSchema, RalphLoopReportSchema, } from '../structured-output.js';
+/**
+ * Schema 映射表
+ * 工具名称 -> Schema 对象
+ */
+export const SCHEMA_MAP = {
+    // P0 工具（已完成）
+    gencommit: 'CommitMessageSchema',
+    start_feature: 'FeatureReportSchema',
+    start_bugfix: 'BugFixReportSchema',
+    start_ui: 'UIReportSchema',
+    start_onboard: 'OnboardingReportSchema',
+    start_ralph: 'RalphLoopReportSchema',
+    // 核心开发工具
+    code_review: 'CodeReviewReportSchema',
+    debug: 'DebugReportSchema',
+    fix_bug: 'BugAnalysisSchema',
+    gentest: 'TestSuiteSchema',
+    refactor: 'RefactorPlanSchema',
+    security_scan: 'SecurityReportSchema',
+    perf: 'PerformanceReportSchema',
+    // 代码生成工具
+    gendoc: 'DocumentationSchema',
+    genapi: 'APIDocumentationSchema',
+    gensql: 'SQLQuerySchema',
+    genreadme: 'ReadmeSchema',
+    genui: 'UIComponentSchema',
+    gen_mock: 'MockDataSchema',
+    genchangelog: 'ChangelogSchema',
+    genpr: 'PullRequestSchema',
+    fix: 'CodeFixSchema',
+    explain: 'ExplanationSchema',
+    convert: 'ConversionSchema',
+    css_order: 'CSSOrderSchema',
+    // 工作流编排工具
+    start_review: 'ReviewWorkflowSchema',
+    start_release: 'ReleaseWorkflowSchema',
+    start_refactor: 'RefactorWorkflowSchema',
+    start_api: 'APIWorkflowSchema',
+    start_doc: 'DocWorkflowSchema',
+    // 项目管理工具
+    init_project: 'ProjectInitSchema',
+    init_project_context: 'ProjectContextSchema',
+    add_feature: 'FeatureSpecSchema',
+    analyze_project: 'ProjectAnalysisSchema',
+    estimate: 'EstimateSchema',
+    check_deps: 'DependencyReportSchema',
+    split: 'SplitPlanSchema',
+    resolve_conflict: 'ConflictResolutionSchema',
+    // UI/UX 工具
+    ui_design_system: 'DesignSystemSchema',
+    ui_search: 'UISearchResultSchema',
+    sync_ui_data: 'SyncReportSchema',
+    design2code: 'Design2CodeSchema',
+    init_component_catalog: 'ComponentCatalogSchema',
+    render_ui: 'RenderResultSchema',
+    // 辅助工具
+    detect_shell: 'ShellDetectionSchema',
+    init_setting: 'SettingInitSchema',
+    gen_skill: 'SkillDocSchema',
+};
+/**
+ * 获取工具的 Schema 名称
+ */
+export function getSchemaName(toolName) {
+    return SCHEMA_MAP[toolName];
+}
+/**
+ * 检查工具是否支持结构化输出
+ */
+export function supportsStructuredOutput(toolName) {
+    return toolName in SCHEMA_MAP;
+}
+/**
+ * 获取所有支持结构化输出的工具列表
+ */
+export function getSupportedTools() {
+    return Object.keys(SCHEMA_MAP);
+}