Skip to main content
Glama

产品规格助手

product_spec_assist

Prevents premature coding by auto-classifying user requests into product development, UI modification, debug, or launch, then calling the relevant specification module.

Instructions

统一入口:根据用户原话自动判断场景(产品开发、UI 修改、Debug、上线),并调用对应能力。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
messageYes用户原话,必填
known_contextNo已有上下文
preferred_platformNo用户已知平台unknown
strictnessNo追问强度normal
auto_executeNo是否允许自动调用对应 engine

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
routedIntentYes
selectedToolYes
executedYes
resultYes
nextActionYes
technicalProfileNo
pmIntentDecisionNo
quickQuestionsYes
agentGuidanceYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.3.20
    • changedOutput schema / properties / nextAction / properties / type / enum
      Previous value: -[
      -  "answer_questions",
      -  "compile_spec",
      -  "translate_ui",
      -  "provide_debug_info",
      -  "review_launch_readiness",
      -  "choose_tool_manually"
      -]New value: +[
      +  "answer_questions",
      +  "compile_spec",
      +  "confirm_spec",
      +  "translate_ui",
      +  "provide_debug_info",
      +  "review_launch_readiness",
      +  "choose_tool_manually"
      +]
    • addedOutput schema / properties / pmIntentDecision
      Added value: +{
      +  "$ref": "#/properties/result/anyOf/0/anyOf/1/properties/pmIntentDecision"
      +}
    • addedOutput schema / properties / quickQuestions / items / properties / example
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "anyOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "clarification": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "defaultAssumptions": {
      -                "additionalProperties": {
      -                  "type": "string"
      -                },
      -                "type": "object"
      -              },
      -              "missingFields": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "questions": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "defaultAssumption": {
      -                      "type": "string"
      -                    },
      -                    "field": {
      -                      "type": "string"
      -                    },
      -                    "options": {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "priority": {
      -                      "type": "string"
      -                    },
      -                    "question": {
      -                      "type": "string"
      -                    },
      -                    "whyImportant": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "field",
      -                    "question",
      -                    "whyImportant",
      -                    "options",
      -                    "defaultAssumption",
      -                    "priority"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "missingFields",
      -              "questions",
      -              "defaultAssumptions"
      -            ],
      -            "type": "object"
      -          },
      -          "readiness": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "fields": {
      -                "additionalProperties": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "present": {
      -                      "type": "boolean"
      -                    },
      -                    "value": {
      -                      "type": "string"
      -                    },
      -                    "weight": {
      -                      "type": "number"
      -                    }
      -                  },
      -                  "required": [
      -                    "weight",
      -                    "present"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "object"
      -              },
      -              "score": {
      -                "type": "number"
      -              },
      -              "status": {
      -                "enum": [
      -                  "Not Ready",
      -                  "Draft Ready",
      -                  "Build Ready"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "score",
      -              "status",
      -              "fields"
      -            ],
      -            "type": "object"
      -          },
      -          "recommendation": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "canProceed": {
      -                "type": "boolean"
      -              },
      -              "reason": {
      -                "type": "string"
      -              },
      -              "suggestedNextTool": {
      -                "enum": [
      -                  "spec_compile",
      -                  "spec_interrogate"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "canProceed",
      -              "suggestedNextTool",
      -              "reason"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "readiness",
      -          "clarification",
      -          "recommendation"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "confidence": {
      -            "enum": [
      -              "low",
      -              "medium",
      -              "high"
      -            ],
      -            "type": "string"
      -          },
      -          "translation": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "codeHints": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "frontendTerms": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "identifiedIntent": {
      -                "type": "string"
      -              },
      -              "modificationPrompt": {
      -                "type": "string"
      -              },
      -              "originalDescription": {
      -                "type": "string"
      -              },
      -              "suggestedComponent": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "originalDescription",
      -              "identifiedIntent",
      -              "frontendTerms",
      -              "modificationPrompt",
      -              "suggestedComponent",
      -              "codeHints"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "translation",
      -          "confidence"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "canDiagnoseNow": {
      -            "type": "boolean"
      -          },
      -          "guide": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "checklist": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "commonIssues": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "knownInfo": {
      -                "additionalProperties": {},
      -                "type": "object"
      -              },
      -              "platform": {
      -                "type": "string"
      -              },
      -              "requiredInfo": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "description": {
      -                      "type": "string"
      -                    },
      -                    "field": {
      -                      "type": "string"
      -                    },
      -                    "how_to_get": {
      -                      "type": "string"
      -                    },
      -                    "priority": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "field",
      -                    "description",
      -                    "how_to_get",
      -                    "priority"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              "troubleshootingSteps": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "platform",
      -              "requiredInfo",
      -              "knownInfo",
      -              "checklist",
      -              "commonIssues",
      -              "troubleshootingSteps"
      -            ],
      -            "type": "object"
      -          },
      -          "missingRequiredInfo": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "guide",
      -          "missingRequiredInfo",
      -          "canDiagnoseNow"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "blockers": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "decision": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "aiKeyRisk": {
      -                "type": "boolean"
      -              },
      -              "canBeFrontendOnly": {
      -                "type": "boolean"
      -              },
      -              "mvpSuggestion": {
      -                "type": "string"
      -              },
      -              "needAdmin": {
      -                "type": "boolean"
      -              },
      -              "needAuth": {
      -                "type": "boolean"
      -              },
      -              "needBackend": {
      -                "type": "boolean"
      -              },
      -              "needLogging": {
      -                "type": "boolean"
      -              },
      -              "needSeparation": {
      -                "type": "boolean"
      -              },
      -              "paymentRisk": {
      -                "type": "boolean"
      -              },
      -              "productionSuggestion": {
      -                "type": "string"
      -              },
      -              "reasoning": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "recommendedDatabase": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "canBeFrontendOnly",
      -              "needBackend",
      -              "needSeparation",
      -              "recommendedDatabase",
      -              "needAuth",
      -              "needAdmin",
      -              "needLogging",
      -              "paymentRisk",
      -              "aiKeyRisk",
      -              "mvpSuggestion",
      -              "productionSuggestion",
      -              "reasoning"
      -            ],
      -            "type": "object"
      -          },
      -          "riskLevel": {
      -            "enum": [
      -              "low",
      -              "medium",
      -              "high"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "decision",
      -          "riskLevel",
      -          "blockers"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "clarification": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "defaultAssumptions": {
      +                "additionalProperties": {
      +                  "type": "string"
      +                },
      +                "type": "object"
      +              },
      +              "missingFields": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "questions": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "defaultAssumption": {
      +                      "type": "string"
      +                    },
      +                    "example": {
      +                      "type": "string"
      +                    },
      +                    "field": {
      +                      "type": "string"
      +                    },
      +                    "options": {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "priority": {
      +                      "type": "string"
      +                    },
      +                    "question": {
      +                      "type": "string"
      +                    },
      +                    "whyImportant": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "field",
      +                    "question",
      +                    "whyImportant",
      +                    "options",
      +                    "defaultAssumption",
      +                    "priority"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "missingFields",
      +              "questions",
      +              "defaultAssumptions"
      +            ],
      +            "type": "object"
      +          },
      +          "readiness": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "fields": {
      +                "additionalProperties": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "present": {
      +                      "type": "boolean"
      +                    },
      +                    "value": {
      +                      "type": "string"
      +                    },
      +                    "weight": {
      +                      "type": "number"
      +                    }
      +                  },
      +                  "required": [
      +                    "weight",
      +                    "present"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "object"
      +              },
      +              "score": {
      +                "type": "number"
      +              },
      +              "status": {
      +                "enum": [
      +                  "Not Ready",
      +                  "Draft Ready",
      +                  "Build Ready"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "score",
      +              "status",
      +              "fields"
      +            ],
      +            "type": "object"
      +          },
      +          "recommendation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "canProceed": {
      +                "type": "boolean"
      +              },
      +              "reason": {
      +                "type": "string"
      +              },
      +              "suggestedNextTool": {
      +                "enum": [
      +                  "spec_compile",
      +                  "spec_interrogate"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "canProceed",
      +              "suggestedNextTool",
      +              "reason"
      +            ],
      +            "type": "object"
      +          },
      +          "technicalProfile": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "blockers": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "confidence": {
      +                "enum": [
      +                  "high",
      +                  "medium",
      +                  "low"
      +                ],
      +                "type": "string"
      +              },
      +              "evidence": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "frontendOnly": {
      +                "type": "boolean"
      +              },
      +              "needsAdmin": {
      +                "type": "boolean"
      +              },
      +              "needsAuth": {
      +                "type": "boolean"
      +              },
      +              "needsBackend": {
      +                "type": "boolean"
      +              },
      +              "nextQuestions": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "example": {
      +                      "type": "string"
      +                    },
      +                    "question": {
      +                      "type": "string"
      +                    },
      +                    "why": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "question",
      +                    "example",
      +                    "why"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "shape": {
      +                "enum": [
      +                  "static_page",
      +                  "local_storage_tool",
      +                  "local_json_import_export",
      +                  "static_json_data_page",
      +                  "light_backend_json_sqlite",
      +                  "full_backend_saas",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "suggestedStorage": {
      +                "enum": [
      +                  "none",
      +                  "localStorage",
      +                  "indexedDB",
      +                  "static_json",
      +                  "json_file",
      +                  "sqlite",
      +                  "postgresql"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "shape",
      +              "confidence",
      +              "frontendOnly",
      +              "needsBackend",
      +              "needsAuth",
      +              "needsAdmin",
      +              "suggestedStorage",
      +              "evidence",
      +              "blockers",
      +              "nextQuestions"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "readiness",
      +          "clarification",
      +          "recommendation"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "clarification": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "defaultAssumptions": {
      +                "additionalProperties": {
      +                  "type": "string"
      +                },
      +                "type": "object"
      +              },
      +              "missingFields": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "questions": {
      +                "items": {},
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "missingFields",
      +              "questions",
      +              "defaultAssumptions"
      +            ],
      +            "type": "object"
      +          },
      +          "confirmation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "items": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "items"
      +            ],
      +            "type": "object"
      +          },
      +          "inputConsumption": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "confidence": {
      +                "enum": [
      +                  "high",
      +                  "medium",
      +                  "low"
      +                ],
      +                "type": "string"
      +              },
      +              "consumedAnswers": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "matchedDomain": {
      +                "type": "string"
      +              },
      +              "unusedAnswers": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "consumedAnswers",
      +              "unusedAnswers",
      +              "matchedDomain",
      +              "confidence"
      +            ],
      +            "type": "object"
      +          },
      +          "mode": {
      +            "enum": [
      +              "not_ready",
      +              "draft",
      +              "formal"
      +            ],
      +            "type": "string"
      +          },
      +          "nextAction": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "message": {
      +                "type": "string"
      +              },
      +              "type": {
      +                "enum": [
      +                  "answer_questions",
      +                  "confirm_spec",
      +                  "start_build"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "type",
      +              "message"
      +            ],
      +            "type": "object"
      +          },
      +          "pmIntentDecision": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "accessTopology": {
      +                "enum": [
      +                  "single_device",
      +                  "lan_only",
      +                  "internet_ip",
      +                  "public_domain",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "actions": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "boundaryQuestionIds": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "confidence": {
      +                "enum": [
      +                  "high",
      +                  "medium",
      +                  "low"
      +                ],
      +                "type": "string"
      +              },
      +              "coreObjects": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "defaultAssumptions": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "maintenanceMode": {
      +                "enum": [
      +                  "agent_assisted",
      +                  "manual_files",
      +                  "web_admin",
      +                  "visitor_submission",
      +                  "runtime_collaboration",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "mustNotUse": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "needType": {
      +                "enum": [
      +                  "static_display",
      +                  "personal_local_tool",
      +                  "multi_user_collaboration",
      +                  "content_marketing_site",
      +                  "data_visualization_site",
      +                  "transaction_workflow",
      +                  "content_knowledge",
      +                  "ai_automation",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "recommendedDeployment": {
      +                "enum": [
      +                  "static_only",
      +                  "local_browser_only",
      +                  "static_hosting_with_agent_updates",
      +                  "local_lan_server_sqlite",
      +                  "cheap_vps_sqlite_by_ip",
      +                  "vps_domain_https",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "route": {
      +                "enum": [
      +                  "spec_compile",
      +                  "spec_interrogate",
      +                  "architecture_decide"
      +                ],
      +                "type": "string"
      +              },
      +              "source": {
      +                "enum": [
      +                  "local_rule",
      +                  "online_llm",
      +                  "merged"
      +                ],
      +                "type": "string"
      +              },
      +              "states": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "strongSignals": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "technicalShape": {
      +                "enum": [
      +                  "static_page",
      +                  "local_storage_tool",
      +                  "local_json_import_export",
      +                  "static_json_data_page",
      +                  "light_backend_json_sqlite",
      +                  "full_backend_saas",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "usageScope": {
      +                "enum": [
      +                  "self",
      +                  "fixed_group",
      +                  "public_audience",
      +                  "unknown"
      +                ],
      +                "type": "string"
      +              },
      +              "weakSignals": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "needType",
      +              "usageScope",
      +              "maintenanceMode",
      +              "accessTopology",
      +              "technicalShape",
      +              "recommendedDeployment",
      +              "route",
      +              "confidence",
      +              "strongSignals",
      +              "weakSignals",
      +              "coreObjects",
      +              "states",
      +              "actions",
      +              "mustNotUse",
      +              "boundaryQuestionIds",
      +              "defaultAssumptions",
      +              "source"
      +            ],
      +            "type": "object"
      +          },
      +          "readiness": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "score": {
      +                "type": "number"
      +              },
      +              "status": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "score",
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          "spec": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "apiDesign": {
      +                "type": "string"
      +              },
      +              "architecture": {
      +                "type": "string"
      +              },
      +              "assumptions": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "coreFeatures": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "dataModel": {
      +                "type": "string"
      +              },
      +              "inputConsumption": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "confidence": {
      +                    "enum": [
      +                      "high",
      +                      "medium",
      +                      "low"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "consumedAnswers": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "matchedDomain": {
      +                    "type": "string"
      +                  },
      +                  "unusedAnswers": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  }
      +                },
      +                "required": [
      +                  "consumedAnswers",
      +                  "unusedAnswers",
      +                  "matchedDomain",
      +                  "confidence"
      +                ],
      +                "type": "object"
      +              },
      +              "nonGoals": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "platform": {
      +                "type": "string"
      +              },
      +              "pmIntentDecision": {
      +                "$ref": "#/properties/result/anyOf/0/anyOf/1/properties/pmIntentDecision"
      +              },
      +              "productGoal": {
      +                "type": "string"
      +              },
      +              "riskBoundaries": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "successCriteria": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "targetUser": {
      +                "type": "string"
      +              },
      +              "technicalProfile": {
      +                "$ref": "#/properties/result/anyOf/0/anyOf/0/properties/technicalProfile"
      +              }
      +            },
      +            "required": [
      +              "productGoal",
      +              "targetUser",
      +              "platform",
      +              "coreFeatures",
      +              "dataModel",
      +              "architecture",
      +              "apiDesign",
      +              "riskBoundaries",
      +              "nonGoals",
      +              "successCriteria",
      +              "assumptions"
      +            ],
      +            "type": "object"
      +          },
      +          "technicalProfile": {
      +            "$ref": "#/properties/result/anyOf/0/anyOf/0/properties/technicalProfile"
      +          }
      +        },
      +        "required": [
      +          "mode",
      +          "readiness",
      +          "nextAction"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "confidence": {
      +            "enum": [
      +              "low",
      +              "medium",
      +              "high"
      +            ],
      +            "type": "string"
      +          },
      +          "translation": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "codeHints": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "frontendTerms": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "identifiedIntent": {
      +                "type": "string"
      +              },
      +              "modificationPrompt": {
      +                "type": "string"
      +              },
      +              "originalDescription": {
      +                "type": "string"
      +              },
      +              "suggestedComponent": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "originalDescription",
      +              "identifiedIntent",
      +              "frontendTerms",
      +              "modificationPrompt",
      +              "suggestedComponent",
      +              "codeHints"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "translation",
      +          "confidence"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "canDiagnoseNow": {
      +            "type": "boolean"
      +          },
      +          "guide": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "checklist": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "commonIssues": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "knownInfo": {
      +                "additionalProperties": {},
      +                "type": "object"
      +              },
      +              "platform": {
      +                "type": "string"
      +              },
      +              "requiredInfo": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "description": {
      +                      "type": "string"
      +                    },
      +                    "field": {
      +                      "type": "string"
      +                    },
      +                    "how_to_get": {
      +                      "type": "string"
      +                    },
      +                    "priority": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "field",
      +                    "description",
      +                    "how_to_get",
      +                    "priority"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "troubleshootingSteps": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "platform",
      +              "requiredInfo",
      +              "knownInfo",
      +              "checklist",
      +              "commonIssues",
      +              "troubleshootingSteps"
      +            ],
      +            "type": "object"
      +          },
      +          "missingRequiredInfo": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "guide",
      +          "missingRequiredInfo",
      +          "canDiagnoseNow"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "blockers": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "decision": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "aiKeyRisk": {
      +                "type": "boolean"
      +              },
      +              "canBeFrontendOnly": {
      +                "type": "boolean"
      +              },
      +              "capacityRisk": {
      +                "type": "boolean"
      +              },
      +              "domain": {
      +                "type": "string"
      +              },
      +              "mvpSuggestion": {
      +                "type": "string"
      +              },
      +              "needAdmin": {
      +                "type": "boolean"
      +              },
      +              "needAuth": {
      +                "type": "boolean"
      +              },
      +              "needBackend": {
      +                "type": "boolean"
      +              },
      +              "needLogging": {
      +                "type": "boolean"
      +              },
      +              "needSeparation": {
      +                "type": "boolean"
      +              },
      +              "paymentRisk": {
      +                "type": "boolean"
      +              },
      +              "pmIntentDecision": {
      +                "$ref": "#/properties/result/anyOf/0/anyOf/1/properties/pmIntentDecision"
      +              },
      +              "productionSuggestion": {
      +                "type": "string"
      +              },
      +              "reasoning": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "recommendedDatabase": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "canBeFrontendOnly",
      +              "needBackend",
      +              "needSeparation",
      +              "recommendedDatabase",
      +              "needAuth",
      +              "needAdmin",
      +              "needLogging",
      +              "paymentRisk",
      +              "aiKeyRisk",
      +              "mvpSuggestion",
      +              "productionSuggestion",
      +              "reasoning"
      +            ],
      +            "type": "object"
      +          },
      +          "riskLevel": {
      +            "enum": [
      +              "low",
      +              "medium",
      +              "high"
      +            ],
      +            "type": "string"
      +          },
      +          "technicalProfile": {
      +            "$ref": "#/properties/result/anyOf/0/anyOf/0/properties/technicalProfile"
      +          }
      +        },
      +        "required": [
      +          "decision",
      +          "riskLevel",
      +          "blockers"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / technicalProfile
      Added value: +{
      +  "$ref": "#/properties/result/anyOf/0/anyOf/0/properties/technicalProfile"
      +}
  2. First observedv1.0.0

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It only states high-level behavior (scenario detection and routing) without detailing side effects, prerequisites, or what happens in ambiguous cases. This is insufficient for a dispatcher tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that front-loads the core purpose. Every word is meaningful, and there is no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 5 parameters, nested objects, and an output schema, the description is too minimal. It does not explain the role of parameters like known_context, preferred_platform, strictness, or auto_execute, nor the nature of the output.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, so the parameters are documented. The description adds no additional meaning beyond the schema, which is acceptable here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool as a unified entry point that automatically determines the scenario (product development, UI modification, Debug, launch) and calls the corresponding capability. This distinguishes it from sibling tools, which are specific to individual tasks.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description indicates it is the first contact point for user requests, implying when to use it. However, it does not explicitly state when not to use it or mention alternatives for known scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.