Skip to main content
Glama

verify_task

verify_task
Idempotent

Runs a non-destructive acceptance check on a completed task or project path: executes automated command checks plus code analysis against a git baseline. Supports temporary extra checks and idempotent retries.

Instructions

对已完成任务或项目路径执行一次验收(不改源码):自动命令检查 + 代码分析(相对 git 基线)。可用 extraChecks 临时加验。需任务/项目二选一。可选 idempotencyKey:同一 key 重试不重跑验收——执行中的同键请求返回进行中提示,已完成的直接返回既有报告与轮次,参数变更则报冲突。

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "verify_task"
  }
}

Input Schema

NameRequiredDescriptionDefault
taskIdNo
checksModeNo
baselineRefNo
extraChecksNo
projectPathNo
idempotencyKeyNo
acceptanceOverrideNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.0.0-beta.3
    • changedInput schema / properties / acceptanceOverride / properties / visual / additionalProperties
      Previous value: -falseNew value: +{}
    • removedInput schema / properties / acceptanceOverride / properties / visual / properties
      Removed value: -{
      -  "allowedOrigins": {
      -    "default": [],
      -    "items": {
      -      "format": "uri",
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "baselineRoot": {
      -    "default": "tests/visual/baselines",
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  "browser": {
      -    "anyOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "mode": {
      -            "const": "managed",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "executablePath": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "mode": {
      -            "const": "chrome",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "executablePath": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "mode": {
      -            "const": "edge",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "executablePath": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "mode": {
      -            "const": "executable",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode",
      -          "executablePath"
      -        ],
      -        "type": "object"
      -      }
      -    ],
      -    "default": {
      -      "mode": "managed"
      -    }
      -  },
      -  "content": {
      -    "additionalProperties": false,
      -    "default": {},
      -    "properties": {
      -      "allowRemote": {
      -        "default": false,
      -        "type": "boolean"
      -      },
      -      "argsTemplate": {
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "cache": {
      -        "default": true,
      -        "type": "boolean"
      -      },
      -      "command": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "cwd": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -      },
      -      "enabled": {
      -        "default": false,
      -        "type": "boolean"
      -      },
      -      "env": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      -      },
      -      "minConfidence": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      -      },
      -      "samples": {
      -        "default": 3,
      -        "maximum": 9,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "timeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 90000
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "contents": {
      -    "default": [],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "allowRemote": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/allowRemote"
      -        },
      -        "argsTemplate": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/argsTemplate"
      -        },
      -        "blocking": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/blocking"
      -        },
      -        "command": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/command"
      -        },
      -        "cwd": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/cwd"
      -        },
      -        "env": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      -        },
      -        "expect": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/expect"
      -        },
      -        "files": {
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "id": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -        },
      -        "samples": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/samples"
      -        }
      -      },
      -      "required": [
      -        "expect",
      -        "id",
      -        "files"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "defaults": {
      -    "additionalProperties": false,
      -    "default": {},
      -    "properties": {
      -      "capture": {
      -        "default": "viewport",
      -        "enum": [
      -          "viewport",
      -          "fullPage",
      -          "element"
      -        ],
      -        "type": "string"
      -      },
      -      "colorScheme": {
      -        "default": "light",
      -        "enum": [
      -          "light",
      -          "dark",
      -          "no-preference"
      -        ],
      -        "type": "string"
      -      },
      -      "locale": {
      -        "default": "en-US",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "maxDiffRatio": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold",
      -        "default": 0.001
      -      },
      -      "pixelThreshold": {
      -        "default": 0.1,
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "selector": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "timezone": {
      -        "default": "UTC",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "enabled": {
      -    "default": false,
      -    "type": "boolean"
      -  },
      -  "images": {
      -    "default": [],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "aspectRatio": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "dpi": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "fileSizeBytes": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "files": {
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "formats": {
      -          "items": {
      -            "enum": [
      -              "png",
      -              "jpeg",
      -              "webp"
      -            ],
      -            "type": "string"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "height": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "id": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -        },
      -        "optional": {
      -          "default": false,
      -          "type": "boolean"
      -        },
      -        "transparency": {
      -          "enum": [
      -            "transparent",
      -            "opaque"
      -          ],
      -          "type": "string"
      -        },
      -        "width": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "exact": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "max": {
      -              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      -            },
      -            "min": {
      -              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "files"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "limits": {
      -    "additionalProperties": false,
      -    "default": {},
      -    "properties": {
      -      "artifactBytes": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 524288000
      -      },
      -      "concurrency": {
      -        "default": 1,
      -        "exclusiveMinimum": 0,
      -        "maximum": 4,
      -        "type": "integer"
      -      },
      -      "decodedPixels": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 32000000
      -      },
      -      "inputBytes": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 20971520
      -      },
      -      "itemTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 60000
      -      },
      -      "navigationTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 30000
      -      },
      -      "roundTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 300000
      -      },
      -      "serviceTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 60000
      -      },
      -      "stabilitySamples": {
      -        "default": 3,
      -        "exclusiveMinimum": 0,
      -        "maximum": 3,
      -        "minimum": 2,
      -        "type": "integer"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "pages": {
      -    "default": [],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "baseline": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -        },
      -        "capture": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/capture"
      -        },
      -        "content": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "allowRemote": {
      -              "type": "boolean"
      -            },
      -            "argsTemplate": {
      -              "items": {
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "minItems": 1,
      -              "type": "array"
      -            },
      -            "blocking": {
      -              "default": false,
      -              "type": "boolean"
      -            },
      -            "command": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "cwd": {
      -              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -            },
      -            "env": {
      -              "additionalProperties": {
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "propertyNames": {
      -                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
      -              },
      -              "type": "object"
      -            },
      -            "expect": {
      -              "maxLength": 4000,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "samples": {
      -              "maximum": 9,
      -              "minimum": 1,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "expect"
      -          ],
      -          "type": "object"
      -        },
      -        "id": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -        },
      -        "maskSelectors": {
      -          "default": [],
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -          },
      -          "type": "array"
      -        },
      -        "maxDiffRatio": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      -        },
      -        "optional": {
      -          "default": false,
      -          "type": "boolean"
      -        },
      -        "pixel": {
      -          "default": true,
      -          "type": "boolean"
      -        },
      -        "pixelThreshold": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      -        },
      -        "readySelector": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -        },
      -        "route": {
      -          "default": "/",
      -          "type": "string"
      -        },
      -        "selector": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -        },
      -        "source": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "type": {
      -                  "const": "existing",
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "format": "uri",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "url"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "port": {
      -                  "exclusiveMinimum": 0,
      -                  "maximum": 65535,
      -                  "type": "integer"
      -                },
      -                "root": {
      -                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -                },
      -                "type": {
      -                  "const": "static",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "root"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "args": {
      -                  "default": [],
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "command": {
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "cwd": {
      -                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot",
      -                  "default": "."
      -                },
      -                "env": {
      -                  "additionalProperties": {
      -                    "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
      -                    "type": "string"
      -                  },
      -                  "default": {},
      -                  "type": "object"
      -                },
      -                "readyUrl": {
      -                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      -                },
      -                "type": {
      -                  "const": "command",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "command",
      -                "readyUrl"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "steps": {
      -          "default": [],
      -          "items": {
      -            "anyOf": [
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "click",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "type",
      -                  "selector"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "input",
      -                    "type": "string"
      -                  },
      -                  "value": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "type",
      -                  "selector",
      -                  "value"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "hover",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "type",
      -                  "selector"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "scroll",
      -                    "type": "string"
      -                  },
      -                  "x": {
      -                    "type": "number"
      -                  },
      -                  "y": {
      -                    "type": "number"
      -                  }
      -                },
      -                "required": [
      -                  "type"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "durationMs": {
      -                    "exclusiveMinimum": 0,
      -                    "maximum": 60000,
      -                    "type": "integer"
      -                  },
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "state": {
      -                    "enum": [
      -                      "visible",
      -                      "hidden"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "type": {
      -                    "const": "wait",
      -                    "type": "string"
      -                  },
      -                  "url": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      -                  }
      -                },
      -                "required": [
      -                  "type"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "type": "array"
      -        },
      -        "storageState": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -        },
      -        "viewports": {
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "source"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "viewports": {
      -    "default": [
      -      {
      -        "deviceScaleFactor": 1,
      -        "height": 720,
      -        "id": "desktop",
      -        "width": 1280
      -      },
      -      {
      -        "deviceScaleFactor": 1,
      -        "height": 844,
      -        "id": "mobile",
      -        "width": 390
      -      }
      -    ],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "deviceScaleFactor": {
      -          "default": 1,
      -          "exclusiveMinimum": 0,
      -          "maximum": 4,
      -          "type": "number"
      -        },
      -        "height": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width"
      -        },
      -        "id": {
      -          "maxLength": 100,
      -          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$",
      -          "type": "string"
      -        },
      -        "width": {
      -          "exclusiveMinimum": 0,
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "width",
      -        "height"
      -      ],
      -      "type": "object"
      -    },
      -    "minItems": 1,
      -    "type": "array"
      -  }
      -}
  2. Changed1 schema field changedv0.6.4
    • addedInput schema / properties / acceptanceOverride
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "checks": {
      +      "items": {
      +        "$ref": "#/properties/extraChecks/items"
      +      },
      +      "type": "array"
      +    },
      +    "requireChanges": {
      +      "type": "boolean"
      +    },
      +    "verifyConcurrency": {
      +      "type": "number"
      +    },
      +    "visual": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "allowedOrigins": {
      +          "default": [],
      +          "items": {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "baselineRoot": {
      +          "default": "tests/visual/baselines",
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "browser": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "mode": {
      +                  "const": "managed",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "executablePath": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "mode": {
      +                  "const": "chrome",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "executablePath": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "mode": {
      +                  "const": "edge",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "executablePath": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "mode": {
      +                  "const": "executable",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode",
      +                "executablePath"
      +              ],
      +              "type": "object"
      +            }
      +          ],
      +          "default": {
      +            "mode": "managed"
      +          }
      +        },
      +        "content": {
      +          "additionalProperties": false,
      +          "default": {},
      +          "properties": {
      +            "allowRemote": {
      +              "default": false,
      +              "type": "boolean"
      +            },
      +            "argsTemplate": {
      +              "items": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "cache": {
      +              "default": true,
      +              "type": "boolean"
      +            },
      +            "command": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "cwd": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +            },
      +            "enabled": {
      +              "default": false,
      +              "type": "boolean"
      +            },
      +            "env": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      +            },
      +            "minConfidence": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      +            },
      +            "samples": {
      +              "default": 3,
      +              "maximum": 9,
      +              "minimum": 1,
      +              "type": "integer"
      +            },
      +            "timeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 90000
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "contents": {
      +          "default": [],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "allowRemote": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/allowRemote"
      +              },
      +              "argsTemplate": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/argsTemplate"
      +              },
      +              "blocking": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/blocking"
      +              },
      +              "command": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/command"
      +              },
      +              "cwd": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/cwd"
      +              },
      +              "env": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      +              },
      +              "expect": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/expect"
      +              },
      +              "files": {
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "id": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +              },
      +              "samples": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/samples"
      +              }
      +            },
      +            "required": [
      +              "expect",
      +              "id",
      +              "files"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "defaults": {
      +          "additionalProperties": false,
      +          "default": {},
      +          "properties": {
      +            "capture": {
      +              "default": "viewport",
      +              "enum": [
      +                "viewport",
      +                "fullPage",
      +                "element"
      +              ],
      +              "type": "string"
      +            },
      +            "colorScheme": {
      +              "default": "light",
      +              "enum": [
      +                "light",
      +                "dark",
      +                "no-preference"
      +              ],
      +              "type": "string"
      +            },
      +            "locale": {
      +              "default": "en-US",
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "maxDiffRatio": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold",
      +              "default": 0.001
      +            },
      +            "pixelThreshold": {
      +              "default": 0.1,
      +              "maximum": 1,
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "selector": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "timezone": {
      +              "default": "UTC",
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "enabled": {
      +          "default": false,
      +          "type": "boolean"
      +        },
      +        "images": {
      +          "default": [],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "aspectRatio": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "dpi": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "fileSizeBytes": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "files": {
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "formats": {
      +                "items": {
      +                  "enum": [
      +                    "png",
      +                    "jpeg",
      +                    "webp"
      +                  ],
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "height": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "id": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +              },
      +              "optional": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "transparency": {
      +                "enum": [
      +                  "transparent",
      +                  "opaque"
      +                ],
      +                "type": "string"
      +              },
      +              "width": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "exact": {
      +                    "exclusiveMinimum": 0,
      +                    "type": "number"
      +                  },
      +                  "max": {
      +                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      +                  },
      +                  "min": {
      +                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "files"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "limits": {
      +          "additionalProperties": false,
      +          "default": {},
      +          "properties": {
      +            "artifactBytes": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 524288000
      +            },
      +            "concurrency": {
      +              "default": 1,
      +              "exclusiveMinimum": 0,
      +              "maximum": 4,
      +              "type": "integer"
      +            },
      +            "decodedPixels": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 32000000
      +            },
      +            "inputBytes": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 20971520
      +            },
      +            "itemTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 60000
      +            },
      +            "navigationTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 30000
      +            },
      +            "roundTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 300000
      +            },
      +            "serviceTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 60000
      +            },
      +            "stabilitySamples": {
      +              "default": 3,
      +              "exclusiveMinimum": 0,
      +              "maximum": 3,
      +              "minimum": 2,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "pages": {
      +          "default": [],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "baseline": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +              },
      +              "capture": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/capture"
      +              },
      +              "content": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "allowRemote": {
      +                    "type": "boolean"
      +                  },
      +                  "argsTemplate": {
      +                    "items": {
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "blocking": {
      +                    "default": false,
      +                    "type": "boolean"
      +                  },
      +                  "command": {
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "cwd": {
      +                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                  },
      +                  "env": {
      +                    "additionalProperties": {
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    "propertyNames": {
      +                      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
      +                    },
      +                    "type": "object"
      +                  },
      +                  "expect": {
      +                    "maxLength": 4000,
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "samples": {
      +                    "maximum": 9,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  }
      +                },
      +                "required": [
      +                  "expect"
      +                ],
      +                "type": "object"
      +              },
      +              "id": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +              },
      +              "maskSelectors": {
      +                "default": [],
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                },
      +                "type": "array"
      +              },
      +              "maxDiffRatio": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      +              },
      +              "optional": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "pixel": {
      +                "default": true,
      +                "type": "boolean"
      +              },
      +              "pixelThreshold": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      +              },
      +              "readySelector": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +              },
      +              "route": {
      +                "default": "/",
      +                "type": "string"
      +              },
      +              "selector": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +              },
      +              "source": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "type": {
      +                        "const": "existing",
      +                        "type": "string"
      +                      },
      +                      "url": {
      +                        "format": "uri",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "url"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "port": {
      +                        "exclusiveMinimum": 0,
      +                        "maximum": 65535,
      +                        "type": "integer"
      +                      },
      +                      "root": {
      +                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                      },
      +                      "type": {
      +                        "const": "static",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "root"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "args": {
      +                        "default": [],
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "command": {
      +                        "minLength": 1,
      +                        "type": "string"
      +                      },
      +                      "cwd": {
      +                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot",
      +                        "default": "."
      +                      },
      +                      "env": {
      +                        "additionalProperties": {
      +                          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
      +                          "type": "string"
      +                        },
      +                        "default": {},
      +                        "type": "object"
      +                      },
      +                      "readyUrl": {
      +                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      +                      },
      +                      "type": {
      +                        "const": "command",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "command",
      +                      "readyUrl"
      +                    ],
      +                    "type": "object"
      +                  }
      +                ]
      +              },
      +              "steps": {
      +                "default": [],
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "click",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "type",
      +                        "selector"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "input",
      +                          "type": "string"
      +                        },
      +                        "value": {
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "type",
      +                        "selector",
      +                        "value"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "hover",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "type",
      +                        "selector"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "scroll",
      +                          "type": "string"
      +                        },
      +                        "x": {
      +                          "type": "number"
      +                        },
      +                        "y": {
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "type"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "durationMs": {
      +                          "exclusiveMinimum": 0,
      +                          "maximum": 60000,
      +                          "type": "integer"
      +                        },
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "state": {
      +                          "enum": [
      +                            "visible",
      +                            "hidden"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "type": {
      +                          "const": "wait",
      +                          "type": "string"
      +                        },
      +                        "url": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      +                        }
      +                      },
      +                      "required": [
      +                        "type"
      +                      ],
      +                      "type": "object"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              "storageState": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +              },
      +              "viewports": {
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "source"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "viewports": {
      +          "default": [
      +            {
      +              "deviceScaleFactor": 1,
      +              "height": 720,
      +              "id": "desktop",
      +              "width": 1280
      +            },
      +            {
      +              "deviceScaleFactor": 1,
      +              "height": 844,
      +              "id": "mobile",
      +              "width": 390
      +            }
      +          ],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "deviceScaleFactor": {
      +                "default": 1,
      +                "exclusiveMinimum": 0,
      +                "maximum": 4,
      +                "type": "number"
      +              },
      +              "height": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width"
      +              },
      +              "id": {
      +                "maxLength": 100,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$",
      +                "type": "string"
      +              },
      +              "width": {
      +                "exclusiveMinimum": 0,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "width",
      +              "height"
      +            ],
      +            "type": "object"
      +          },
      +          "minItems": 1,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changedv0.6.2
    • addedInput schema / properties / idempotencyKey
      Added value: +{
      +  "type": "string"
      +}
  4. Changed2 schema fields changedv0.1.9
    • addedInput schema / properties / baselineRef / minLength
      Added value: +1
    • addedInput schema / properties / checksMode
      Added value: +{
      +  "enum": [
      +    "append",
      +    "replace"
      +  ],
      +  "type": "string"
      +}
  5. First observedv0.1.0

TDQS

B3.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=false, idempotentHint=true and destructiveHint=false, but the description adds substantive behavior: no source mutation, command execution plus git-baseline code analysis, and a detailed idempotency contract (in-progress key returns an in-progress notice, completed key returns the existing report and round, changed parameters raise a conflict). That is exactly the kind of context annotations cannot carry. It leaves out what non-source artifacts are written (reports, records) and what happens on failure, which is why it is not a 5.

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

Conciseness4/5

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

The text is dense and front-loaded: the core operation comes first, then the constraints, then the idempotency contract. Every clause carries information and there is no filler. The idempotency sentence is long but its length is justified by the three distinct behaviors it defines.

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?

For a 7-parameter tool with nested objects, no output schema, and 0% schema description coverage, the description covers only the primary flow. An agent can call the simple taskId form correctly but has no basis for choosing checksMode, setting baselineRef, or populating acceptanceOverride. Return shape is also unaddressed despite there being no output schema to fall back on.

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

Parameters2/5

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

Schema description coverage is 0% and there are 7 parameters, including a nested acceptanceOverride object with four sub-fields. The description only explains taskId/projectPath exclusivity, extraChecks, and idempotencyKey in depth; checksMode (append vs replace), baselineRef, and the entire acceptanceOverride surface (checks, visual, requireChanges, verifyConcurrency) are undocumented in both schema and description. With this coverage gap the description should compensate much more than it does.

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

Purpose4/5

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

The description gives a specific verb and scope: run one acceptance pass over a completed task or project path, combining automatic command checks with code analysis against a git baseline, and explicitly states it does not modify source code. This is far more than a restatement of the name. It stops short of naming any sibling (run_task, wait_task, query_task) to contrast against, so an agent must infer the boundary itself.

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

Usage Guidelines3/5

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

It states a real precondition, 'must pick one of task/project' (需任务/项目二选一), and mentions extraChecks for temporary additions, which is genuine when-to-use guidance. However, it never says when to prefer this over run_task or query_task, nor what to do if verification is already running beyond the idempotencyKey mechanism. Usage is implied by context rather than spelled out.

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